> 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

Je receptionist kan een item toevoegen aan een Monday.com-bord, zoals een nieuwe lead of een terugbelverzoek, en een item op naam vinden. De API van Monday.com gebruikt GraphQL: elk request is een `POST` met één veld `query`, dus elke tool geeft je receptionist een querytemplate om in te vullen.

## Voordat je begint

| Waarde        | Waar je dit vindt                                   |
| ------------- | --------------------------------------------------- |
| **API-token** | Profielfoto → **Developers** → **My access tokens** |
| **Board-ID**  | Het nummer na `/boards/` in de URL van het bord     |

Het token handelt namens jou, met jouw toegang tot elk bord.

## Maak een item

Ga naar **Integrations**, selecteer **Add integration** en kies **Webhook Tool**.

| Veld                 | Waarde                                                                                                                  |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Naam**             | `create_monday_item`                                                                                                    |
| **Beschrijving**     | "Voeg een terugbelverzoek toe aan het bord van het team. Gebruik dit telkens wanneer je de beller een vervolg belooft." |
| **Methode**          | POST                                                                                                                    |
| **URL**              | `https://api.monday.com/v2`                                                                                             |
| **Request Headers**  | `Authorization`: je API-token, zonder `Bearer`                                                                          |
| **Body Parameters**  | `query` (string, verplicht), met de onderstaande beschrijving                                                           |
| **Assign to agents** | **Receptionist**                                                                                                        |

Gebruik deze beschrijving voor `query` en vervang `1234567890` door je board-ID:

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

Selecteer **Enable**.

## Vind een item

Maak een tweede webhooktool met dezelfde methode, URL en header.

| Veld                | Waarde                                                                                                                                    |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **Naam**            | `find_monday_item`                                                                                                                        |
| **Beschrijving**    | "Vind het item van de beller op het bord op basis van de exacte naam. Gebruik dit wanneer een beller naar een bestaande opdracht vraagt." |
| **Body Parameters** | `query` (string, verplicht), met de onderstaande beschrijving                                                                             |

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

[Test je receptionist](/docs/nl/reception-ai/receptionist/testing) met een terugbelverzoek en vraag er vervolgens naar in een tweede gesprek.

## Beperkingen

De tool voor het maken stelt alleen de itemnaam in. Voor het invullen van kolommen voor status, datum of personen is een JSON-waarde in de GraphQL-query nodig, wat je receptionist moeilijk betrouwbaar kan schrijven. Gebruik voor het instellen van kolommen de actie **Create Item** van Monday.com via [Zapier](/docs/nl/reception-ai/integrations/zapier).

## Problemen oplossen

| Probleem                   | Wat je moet controleren                                                                                               |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `Not Authenticated`        | De header mag alleen het token bevatten, zonder `Bearer`.                                                             |
| `Parse error on ...`       | De receptionist heeft de vorm van de query gewijzigd. Maak de beschrijving van `query` strikter of verkort itemnamen. |
| Items worden niet gevonden | De zoekopdracht komt exact overeen met de volledige itemnaam.                                                         |
| `Board not found`          | Controleer de board-ID en of de eigenaar van het token het bord kan zien.                                             |