Passer à la navigation

Monday.com

Créez et recherchez des éléments Monday.com pendant les appels grâce aux outils webhook.

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

ValeurOù la trouver
Jeton APIPhoto de profil → Développeurs → Mes jetons d’accès
ID du tableauLe 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.

ChampValeur
Nomcreate_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éthodePOST
URLhttps://api.monday.com/v2
En-têtes de requêteAuthorization : votre jeton API, sans Bearer
Paramètres du corpsquery (chaîne, obligatoire), avec la description ci-dessous
Attribuer aux agentsRéceptionniste

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

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.

ChampValeur
Nomfind_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 corpsquery (chaîne, obligatoire), avec la description ci-dessous
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 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.

Résolution des problèmes

ProblèmeÀ vérifier
Not AuthenticatedL’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 introuvablesLa recherche doit correspondre exactement au nom complet de l’élément.
Board not foundVérifiez l’ID du tableau et que le propriétaire du jeton peut voir le tableau.