> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Monday.com

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:

```text
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                                                                                 |

```text
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](/docs/it/reception-ai/receptionist/testing) 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](/docs/it/reception-ai/integrations/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.                                                       |