Monday.com | ElevenLabs Documentation

Il tuo receptionist può aggiungere un elemento a una bacheca Monday.com, ad esempio un nuovo lead o una richiesta di richiamata, e trovare un elemento per nome. L’API di Monday.com usa GraphQL: ogni richiesta è un POST con un campo query, quindi ogni strumento fornisce al tuo receptionist un modello di query da compilare.

Prima di iniziare

Valore	Dove trovarlo
API token	Immagine del profilo → Developers → My access tokens
Board ID	Il numero dopo `/boards/` nell’URL della bacheca

Il token agisce per tuo conto, con il tuo accesso a ogni bacheca.

Crea un elemento

Vai a Integrations, seleziona Add integration e scegli Webhook Tool.

Campo	Valore
Name	`create_monday_item`
Description	”Aggiungi una richiesta di richiamata alla bacheca del team. Usalo ogni volta che prometti al chiamante un follow-up.”
Method	POST
URL	`https://api.monday.com/v2`
Request Headers	`Authorization`: il tuo token API, senza `Bearer`
Body Parameters	`query` (stringa, obbligatorio), con la descrizione seguente
Assign to agents	Receptionist

Usa questa descrizione per query, sostituendo 1234567890 con l’ID della tua bacheca:

A GraphQL mutation in exactly this form, changing only ITEM_NAME:
mutation { create_item(board_id: 1234567890, item_name: "ITEM_NAME") { id } }
ITEM_NAME is the caller's name, phone number, and request, without double quotes.

Seleziona Enable.

Trova un elemento

Crea un secondo strumento webhook con lo stesso metodo, URL e header.

Campo	Valore
Name	`find_monday_item`
Description	”Trova sulla bacheca l’elemento del chiamante in base al nome esatto. Usalo quando un chiamante chiede informazioni su un lavoro esistente.”
Body Parameters	`query` (stringa, obbligatorio), con la descrizione seguente

A GraphQL query in exactly this form, changing only ITEM_NAME:
query { items_page_by_column_values(board_id: 1234567890, limit: 5, columns: [{column_id: "name", column_values: ["ITEM_NAME"]}]) { items { name column_values { text column { title } } } } }

Testa il tuo receptionist con una richiesta di richiamata, poi chiedi informazioni al riguardo in una seconda conversazione.

Limitazioni

Lo strumento di creazione imposta solo il nome dell’elemento. Per compilare le colonne di stato, data o persone serve un valore JSON all’interno della query GraphQL, che il tuo receptionist fatica a scrivere in modo affidabile. Per impostare le colonne, usa l’azione Create Item di Monday.com tramite Zapier.

Risoluzione dei problemi

Problema	Cosa verificare
`Not Authenticated`	L’header deve contenere soltanto il token, senza `Bearer`.
`Parse error on ...`	Il receptionist ha modificato la struttura della query. Rendi più rigorosa la descrizione di `query` o abbrevia i nomi degli elementi.
Gli elementi non vengono trovati	La ricerca corrisponde esattamente al nome completo dell’elemento.
`Board not found`	Verifica l’ID della bacheca e che il proprietario del token possa visualizzarla.