> 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

Tu recepcionista puede añadir un elemento a un tablero de Monday.com, como un nuevo lead o una solicitud de devolución de llamada, y buscar un elemento por nombre. La API de Monday.com utiliza GraphQL: cada solicitud es un `POST` con un campo `query`, por lo que cada herramienta proporciona a tu recepcionista una plantilla de consulta que completar.

## Antes de empezar

| Valor              | Dónde encontrarlo                                      |
| ------------------ | ------------------------------------------------------ |
| **Token de API**   | Foto de perfil → **Developers** → **My access tokens** |
| **ID del tablero** | El número después de `/boards/` en la URL del tablero  |

El token actúa como tú y tiene tu acceso a todos los tableros.

## Crea un elemento

Ve a **Integrations**, selecciona **Add integration** y elige **Webhook Tool**.

| Campo                | Valor                                                                                                                                    |
| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**             | `create_monday_item`                                                                                                                     |
| **Description**      | "Añade una solicitud de devolución de llamada al tablero del equipo. Úsala siempre que prometas a quien llama que harás un seguimiento." |
| **Method**           | POST                                                                                                                                     |
| **URL**              | `https://api.monday.com/v2`                                                                                                              |
| **Request Headers**  | `Authorization`: tu token de API, sin `Bearer`                                                                                           |
| **Body Parameters**  | `query` (cadena, obligatorio), con la descripción de abajo                                                                               |
| **Assign to agents** | **Receptionist**                                                                                                                         |

Usa esta descripción para `query`, sustituyendo `1234567890` por el ID de tu tablero:

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

Selecciona **Enable**.

## Busca un elemento

Crea una segunda herramienta de webhook con el mismo método, URL y encabezado.

| Campo               | Valor                                                                                                                                      |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Name**            | `find_monday_item`                                                                                                                         |
| **Description**     | "Busca en el tablero el elemento de quien llama por su nombre exacto. Úsala cuando alguien llame para preguntar por un trabajo existente." |
| **Body Parameters** | `query` (cadena, obligatorio), con la descripción de abajo                                                                                 |

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

[Prueba tu recepcionista](/docs/es/reception-ai/receptionist/testing) con una solicitud de devolución de llamada y, después, pregunta por ella en una segunda conversación.

## Limitaciones

La herramienta de creación solo establece el nombre del elemento. Rellenar las columnas de estado, fecha o personas requiere un valor JSON dentro de la consulta GraphQL, algo que a tu recepcionista le resulta difícil escribir de forma fiable. Para establecer columnas, usa la acción **Create Item** de Monday.com mediante [Zapier](/docs/es/reception-ai/integrations/zapier).

## Solución de problemas

| Problema                   | Qué comprobar                                                                                                                                        |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Not Authenticated`        | El encabezado debe contener únicamente el token, sin `Bearer`.                                                                                       |
| `Parse error on ...`       | La recepcionista ha cambiado la estructura de la consulta. Haz que la descripción de `query` sea más estricta o acorta los nombres de los elementos. |
| No se encuentran elementos | La búsqueda debe coincidir exactamente con el nombre completo del elemento.                                                                          |
| `Board not found`          | Comprueba el ID del tablero y que el propietario del token pueda verlo.                                                                              |