> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Monday.com

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

| Valor         | Onde encontrá-lo                                       |
| ------------- | ------------------------------------------------------ |
| **API token** | Foto de perfil → **Developers** → **My access tokens** |
| **Board ID**  | O 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**.

| Campo                | Valor                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `create_monday_item`                                                                                                |
| **Description**      | "Adicione uma solicitação de retorno de chamada ao quadro da equipe. Use-a sempre que prometer retornar a ligação." |
| **Method**           | POST                                                                                                                |
| **URL**              | `https://api.monday.com/v2`                                                                                         |
| **Request Headers**  | `Authorization`: seu token de API, sem `Bearer`                                                                     |
| **Body Parameters**  | `query` (string, obrigatório), com a descrição abaixo                                                               |
| **Assign to agents** | **Receptionist**                                                                                                    |

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

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

| Campo               | Valor                                                                                                                         |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| **Name**            | `find_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 Parameters** | `query` (string, obrigatório), com a descrição abaixo                                                                         |

```text
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](/docs/pt/reception-ai/receptionist/testing) 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](/docs/pt/reception-ai/integrations/zapier).

## Solução de problemas

| Problema                  | O que verificar                                                                                                            |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| `Not Authenticated`       | O 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 encontrados | A busca corresponde exatamente ao nome completo do item.                                                                   |
| `Board not found`         | Verifique o ID do quadro e se o proprietário do token pode visualizar o quadro.                                            |