Saltar a la navegación

Monday.com

Crea y busca elementos de Monday.com durante las llamadas con herramientas de webhook.

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

ValorDónde encontrarlo
Token de APIFoto de perfil → Developers → My access tokens
ID del tableroEl 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.

CampoValor
Namecreate_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.”
MethodPOST
URLhttps://api.monday.com/v2
Request HeadersAuthorization: tu token de API, sin Bearer
Body Parametersquery (cadena, obligatorio), con la descripción de abajo
Assign to agentsReceptionist

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

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.

CampoValor
Namefind_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 Parametersquery (cadena, obligatorio), con la descripción de abajo
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 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.

Solución de problemas

ProblemaQué comprobar
Not AuthenticatedEl 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 elementosLa búsqueda debe coincidir exactamente con el nombre completo del elemento.
Board not foundComprueba el ID del tablero y que el propietario del token pueda verlo.