Monday.com | ElevenLabs Documentation

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:

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

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

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.