Ir para a navegação

Monday.com

Crie e encontre itens do Monday.com durante chamadas com ferramentas de webhook.

Seu recepcionista pode adicionar um item a um quadro do Monday.com, como um novo lead ou uma solicitação de retorno de chamada, e encontrar um item pelo nome. A API do Monday.com usa GraphQL: toda solicitação é uma POST com um campo query; por isso, cada ferramenta fornece ao seu recepcionista um modelo de consulta para preencher.

Antes de começar

ValorOnde encontrá-lo
API tokenFoto de perfil → Developers → My access tokens
Board IDO número após /boards/ na URL do quadro

O token age como você, com seu acesso a todos os quadros.

Crie um item

Acesse Integrations, selecione Add integration e escolha Webhook Tool.

CampoValor
Namecreate_monday_item
Description”Adicione uma solicitação de retorno de chamada ao quadro da equipe. Use-a sempre que prometer retornar a ligação.”
MethodPOST
URLhttps://api.monday.com/v2
Request HeadersAuthorization: seu token de API, sem Bearer
Body Parametersquery (string, obrigatório), com a descrição abaixo
Assign to agentsReceptionist

Use esta descrição para query, substituindo 1234567890 pelo ID do seu quadro:

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.

Selecione Enable.

Encontre um item

Crie uma segunda ferramenta de webhook com o mesmo método, URL e cabeçalho.

CampoValor
Namefind_monday_item
Description”Encontre o item de quem ligou no quadro pelo nome exato. Use-a quando alguém ligar perguntando sobre um trabalho existente.”
Body Parametersquery (string, obrigatório), com a descrição abaixo
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 } } } } }

Teste seu recepcionista com uma solicitação de retorno de chamada e, depois, pergunte sobre ela em uma segunda conversa.

Limitações

A ferramenta de criação define apenas o nome do item. Preencher colunas de status, data ou pessoas requer um valor JSON dentro da consulta GraphQL, o que é difícil para seu recepcionista escrever de forma confiável. Para definir colunas, use a ação Create Item do Monday.com pelo Zapier.

Solução de problemas

ProblemaO que verificar
Not AuthenticatedO cabeçalho deve conter somente o token, sem Bearer.
Parse error on ...O recepcionista alterou a estrutura da consulta. Torne a descrição de query mais restrita ou encurte os nomes dos itens.
Itens não são encontradosA busca corresponde exatamente ao nome completo do item.
Board not foundVerifique o ID do quadro e se o proprietário do token pode visualizar o quadro.