> 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

Votre réceptionniste peut ajouter un élément à un tableau Monday.com, comme un nouveau prospect ou une demande de rappel, et rechercher un élément par nom. L'API de Monday.com est GraphQL : chaque requête est un `POST` avec un champ `query`, chaque outil fournit donc à votre réceptionniste un modèle de requête à compléter.

## Avant de commencer

| Valeur            | Où la trouver                                               |
| ----------------- | ----------------------------------------------------------- |
| **Jeton API**     | Photo de profil → **Développeurs** → **Mes jetons d'accès** |
| **ID du tableau** | Le numéro après `/boards/` dans l'URL du tableau            |

Le jeton agit en votre nom, avec vos droits d'accès à tous les tableaux.

## Créer un élément

Accédez à **Intégrations**, sélectionnez **Ajouter une intégration**, puis choisissez **Outil webhook**.

| Champ                    | Valeur                                                                                                                      |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| **Nom**                  | `create_monday_item`                                                                                                        |
| **Description**          | « Ajoutez une demande de rappel au tableau de l'équipe. Utilisez-le chaque fois que vous promettez un suivi à l'appelant. » |
| **Méthode**              | POST                                                                                                                        |
| **URL**                  | `https://api.monday.com/v2`                                                                                                 |
| **En-têtes de requête**  | `Authorization` : votre jeton API, sans `Bearer`                                                                            |
| **Paramètres du corps**  | `query` (chaîne, obligatoire), avec la description ci-dessous                                                               |
| **Attribuer aux agents** | **Réceptionniste**                                                                                                          |

Utilisez cette description pour `query`, en remplaçant `1234567890` par l'ID de votre tableau :

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

Sélectionnez **Activer**.

## Rechercher un élément

Créez un deuxième outil webhook avec la même méthode, la même URL et le même en-tête.

| Champ                   | Valeur                                                                                                                                                             |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nom**                 | `find_monday_item`                                                                                                                                                 |
| **Description**         | « Recherchez l'élément de l'appelant dans le tableau à partir de son nom exact. Utilisez-le lorsqu'un appelant pose une question sur une intervention existante. » |
| **Paramètres du corps** | `query` (chaîne, obligatoire), avec la description ci-dessous                                                                                                      |

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

[Testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) avec une demande de rappel, puis interrogez-le à ce sujet dans une deuxième conversation.

## Limites

L'outil de création définit uniquement le nom de l'élément. Renseigner les colonnes de statut, de date ou de personnes nécessite une valeur JSON dans la requête GraphQL, que votre réceptionniste aura du mal à rédiger de manière fiable. Pour définir des colonnes, utilisez l'action **Create Item** de Monday.com via [Zapier](/docs/fr/reception-ai/integrations/zapier).

## Résolution des problèmes

| Problème              | À vérifier                                                                                                                                    |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
| `Not Authenticated`   | L'en-tête doit contenir uniquement le jeton, sans `Bearer`.                                                                                   |
| `Parse error on ...`  | Le réceptionniste a modifié la structure de la requête. Rendez la description de `query` plus stricte ou raccourcissez les noms des éléments. |
| Éléments introuvables | La recherche doit correspondre exactement au nom complet de l'élément.                                                                        |
| `Board not found`     | Vérifiez l'ID du tableau et que le propriétaire du jeton peut voir le tableau.                                                                |