Hoppa till navigering

Monday.com

Skapa och hitta Monday.com-objekt under samtal med webhookverktyg.

Din receptionist kan lägga till ett objekt på en Monday.com-tavla, till exempel en ny potentiell kund eller en begäran om återuppringning, och hitta ett objekt efter namn. Monday.coms API är GraphQL: varje begäran är en POST med ett query-fält, så varje verktyg ger din receptionist en frågemall att fylla i.

Innan du börjar

VärdeVar du hittar det
API tokenProfilbild → Developers → My access tokens
Board IDSiffran efter /boards/ i tavlans URL

Token fungerar som du, med din åtkomst till alla tavlor.

Skapa ett objekt

Gå till Integrations, välj Add integration och välj Webhook Tool.

FältVärde
Namecreate_monday_item
Description”Add a callback request to the team’s board. Use it whenever you promise the caller a follow-up.”
MethodPOST
URLhttps://api.monday.com/v2
Request HeadersAuthorization: din API-token, utan Bearer
Body Parametersquery (sträng, obligatorisk), med beskrivningen nedan
Assign to agentsReceptionist

Använd den här beskrivningen för query, med ditt tavl-ID i stället för 1234567890:

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.

Välj Enable.

Hitta ett objekt

Skapa ett andra webhookverktyg med samma metod, URL och header.

FältVärde
Namefind_monday_item
Description”Find the caller’s item on the board by its exact name. Use it when a caller asks about an existing job.”
Body Parametersquery (sträng, obligatorisk), med beskrivningen nedan
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 din receptionist med en begäran om återuppringning och fråga sedan om den i en andra konversation.

Begränsningar

Skapaverktyget anger bara objektets namn. För att fylla i status-, datum- eller personkolumner krävs ett JSON-värde i GraphQL-frågan, vilket är svårt för din receptionist att skriva på ett tillförlitligt sätt. Använd Monday.coms Create Item-åtgärd via Zapier för att ange kolumner.

Felsökning

ProblemKontrollera
Not AuthenticatedHeadern måste innehålla tokenen ensam, utan Bearer.
Parse error on ...Receptionisten ändrade frågans struktur. Gör beskrivningen för query striktare eller förkorta objektnamn.
Objekt hittas inteUppslagningen matchar hela objektnamnet exakt.
Board not foundKontrollera tavl-ID:t och att tokenens ägare kan se tavlan.