Monday.com | ElevenLabs Documentation

Ihr Empfangsassistent kann ein Element zu einem Monday.com-Board hinzufügen, etwa einen neuen Lead oder eine Rückrufanfrage, und ein Element anhand seines Namens finden. Die API von Monday.com nutzt GraphQL: Jede Anfrage ist ein POST mit einem Feld query. Deshalb stellt jedes Tool Ihrem Empfangsassistenten eine auszufüllende Abfragevorlage bereit.

Vor dem Start

Wert	Fundort
API-Token	Profilbild → Developers → My access tokens
Board-ID	Die Zahl nach `/boards/` in der URL des Boards

Das Token handelt in Ihrem Namen und hat Ihren Zugriff auf alle Boards.

Element erstellen

Gehen Sie zu Integrations, wählen Sie Add integration und dann Webhook Tool.

Feld	Wert
Name	`create_monday_item`
Description	„Füge dem Board des Teams eine Rückrufanfrage hinzu. Verwende es immer, wenn Sie dem Anrufer eine Rückmeldung zusagen.“
Method	POST
URL	`https://api.monday.com/v2`
Request Headers	`Authorization`: Ihr API-Token, ohne `Bearer`
Body Parameters	`query` (String, erforderlich), mit der untenstehenden Beschreibung
Assign to agents	Receptionist

Verwenden Sie diese Beschreibung für query und ersetzen Sie 1234567890 durch Ihre 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.

Wählen Sie Enable.

Element finden

Erstellen Sie ein zweites Webhook-Tool mit derselben Methode, URL und demselben Header.

Feld	Wert
Name	`find_monday_item`
Description	„Finde das Element des Anrufers auf dem Board anhand seines exakten Namens. Verwende es, wenn ein Anrufer nach einem bestehenden Vorgang fragt.“
Body Parameters	`query` (String, erforderlich), mit der untenstehenden Beschreibung

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

Testen Sie Ihren Empfangsassistenten mit einer Rückrufanfrage und fragen Sie dann in einer zweiten Unterhaltung danach.

Einschränkungen

Das Tool zum Erstellen setzt nur den Namen des Elements. Zum Ausfüllen von Status-, Datums- oder Personenspalten ist ein JSON-Wert innerhalb der GraphQL-Abfrage nötig, den Ihr Empfangsassistent nur schwer zuverlässig schreiben kann. Um Spalten zu setzen, verwenden Sie die Aktion Create Item von Monday.com über Zapier.

Fehlerbehebung

Problem	Prüfen Sie
`Not Authenticated`	Der Header muss nur das Token enthalten, ohne `Bearer`.
`Parse error on ...`	Der Empfangsassistent hat die Form der Abfrage geändert. Formulieren Sie die Beschreibung von `query` strenger oder kürzen Sie Elementnamen.
Elemente werden nicht gefunden	Die Suche gleicht den vollständigen Elementnamen exakt ab.
`Board not found`	Prüfen Sie die Board-ID und ob der Eigentümer des Tokens das Board sehen kann.