Przejdź do nawigacji

Monday.com

Twórz i wyszukuj elementy Monday.com podczas rozmów za pomocą narzędzi webhook.

Twoja recepcjonistka może dodać element do tablicy Monday.com, np. nowy lead lub prośbę o oddzwonienie, a także znaleźć element po nazwie. API Monday.com używa GraphQL: każde żądanie to POST z jednym polem query, dlatego każde narzędzie udostępnia recepcjonistce szablon zapytania do wypełnienia.

Zanim zaczniesz

WartośćGdzie ją znaleźć
API tokenZdjęcie profilowe → Developers → My access tokens
Board IDLiczba po /boards/ w URL tablicy

Token działa w twoim imieniu i ma dostęp do wszystkich twoich tablic.

Utwórz element

Przejdź do Integrations, wybierz Add integration, a następnie Webhook Tool.

PoleWartość
Namecreate_monday_item
Description„Dodaj prośbę o oddzwonienie do tablicy zespołu. Użyj zawsze, gdy obiecasz rozmówcy kontakt.”
MethodPOST
URLhttps://api.monday.com/v2
Request HeadersAuthorization: twój token API, bez Bearer
Body Parametersquery (ciąg znaków, wymagany), z opisem poniżej
Assign to agentsReceptionist

Użyj tego opisu dla query, wstawiając ID swojej tablicy zamiast 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.

Wybierz Enable.

Znajdź element

Utwórz drugie narzędzie webhook z tą samą metodą, URL-em i nagłówkiem.

PoleWartość
Namefind_monday_item
Description„Znajdź element rozmówcy na tablicy po jego dokładnej nazwie. Użyj, gdy rozmówca pyta o istniejące zlecenie.”
Body Parametersquery (ciąg znaków, wymagany), z opisem poniżej
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 } } } } }

Przetestuj recepcjonistkę, zgłaszając prośbę o oddzwonienie, a potem zapytaj o nią w drugiej rozmowie.

Ograniczenia

Narzędzie tworzenia ustawia tylko nazwę elementu. Wypełnienie kolumn statusu, daty lub osób wymaga wartości JSON w zapytaniu GraphQL, którą recepcjonistka może mieć trudność niezawodnie utworzyć. Aby ustawić kolumny, użyj akcji Create Item Monday.com przez Zapier.

Rozwiązywanie problemów

ProblemCo sprawdzić
Not AuthenticatedNagłówek musi zawierać sam token, bez Bearer.
Parse error on ...Recepcjonistka zmieniła strukturę zapytania. Doprecyzuj opis query lub skróć nazwy elementów.
Nie znaleziono elementówWyszukiwanie wymaga dokładnego dopasowania pełnej nazwy elementu.
Board not foundSprawdź ID tablicy oraz czy właściciel tokenu ma do niej dostęp.