Anexus envía cada contacto capturado al tablero que le indiques, como un elemento nuevo. Toda la integración gira en torno a una pregunta que monday.com hace y otros CRM no: ¿en qué columna tipada va cada valor?
Tableros, elementos y columnas — el vocabulario de monday
Nada en monday.com se llama "registro" ni "objeto de lead". Tres palabras sostienen toda la integración, y conocerlas hace evidente cada paso de abajo:
- Tablero — la tabla donde viven tus leads. Tiene un ID numérico y vive en un espacio de trabajo. Un tablero es Principal (visible para el espacio de trabajo), Compartible (también invitados) o Privado (solo sus suscriptores lo ven, incluso vía API).
- Elemento — una fila. Su nombre es el único campo que todo elemento tiene garantizado. Los elementos viven dentro de grupos (las bandas de color del tablero).
- Columna — un campo tipado: email, teléfono, texto, texto largo, estado, persona, fecha, números. El tipo queda fijado al crear la columna, y monday.com rechaza un valor que no encaja con el tipo en lugar de convertirlo.
Si usas el producto monday CRM, sus tableros de Leads y Contactos son tableros normales por debajo: mismos IDs numéricos, mismas columnas tipadas, misma API. Apunta Anexus al tablero de Leads y se comporta como cualquier otro tablero.
Antes de comenzar
- Un plan de monday.com que incluya acceso a la API (la mayoría de los planes pagos lo incluyen). La cuota de API de la cuenta escala con el nivel del plan, y monday.com la mide por complejidad de consulta además de por número de llamadas.
- Un tablero listo para recibir elementos. Basta con un tablero "Leads" con una columna de Email, una de Teléfono y una de Texto. Si no tienes uno, créalo primero en monday.com.
- Un usuario de monday.com con permisos de edición en ese tablero desde el cual generar el token. Un token hereda exactamente los permisos de su dueño: un asiento de Espectador o Invitado puede leer un tablero pero no crear elementos en él.
Paso 1 — Da forma al tablero antes de conectar nada
Haz esto primero, no al final. El ID interno de una columna de monday.com se asigna una sola vez, al crearla, y renombrar la columna después no lo cambia. Configurar bien las columnas antes de conectar toma un minuto y te ahorra perseguir elementos a medio llenar después.
Abre (o crea) el tablero que alojará tus leads.
Añade una columna Email real, una columna Teléfono real y una columna de Texto (o Texto largo), elegidas en el selector de tipos de columna de monday. Una columna de texto solo titulada "Email" sigue siendo una columna de texto.
Nómbralas Email, Phone y Text. Anexus busca una columna de Texto llamada "notes" o "text" para poner el mensaje, así que conserva ese nombre en inglés incluso en un tablero en español; nombrar las otras dos igual mantiene todo legible. Mantenlo simple: una columna de Email, una de Teléfono, una de Texto.
Paso 2 — Copia tu token de API personal
En monday.com, haz clic en tu avatar de perfil (abajo a la izquierda) → Developers para abrir el Developer Center.
Abre My access tokens (mis tokens de acceso) y haz clic en Show junto a tu token personal.
Es un JWT: una cadena larga eyJ..., normalmente de más de 200 caracteres, en tres segmentos separados por puntos. Cópiala entera. Un JWT cortado en un salto de línea sigue pareciendo válido y falla la validación al instante.
El token es personal. Anexus pide un token de API personal, y ese token actúa como tú: está atado a una sola persona. Si ese usuario se desactiva, se elimina de la cuenta o baja a un asiento de Espectador, el token deja de poder crear elementos. En una cuenta compartida, genéralo desde un usuario que siga ahí el año que viene.
Paso 3 — Saca el ID del tablero de la URL
Abre el tablero en el que quieres que se creen los elementos.
Mira la URL en tu navegador. Se ve así:
https://yourcompany.monday.com/boards/1234567890
Los dígitos justo después de /boards/ son el ID del tablero. Copia solo los dígitos.
Si la URL trae algo más después — /views/… o /pulses/… — ignóralo. Un ID de vista y un ID de elemento (monday llama "pulses" a los elementos internamente) son números completamente distintos, y pegar uno de ellos es la causa más común del error "tablero no válido".
Paso 4 — Conecta en Anexus
En Anexus, ve a Ajustes → Integraciones CRM → monday.com → Conectar.
Completa:
- Board ID: el ID numérico que copiaste de la URL
- Personal API Token: el JWT
eyJ...completo
Haz clic en Guardar y conectar.
En qué se convierte un contacto de Anexus en tu tablero
Un contacto capturado se convierte en un elemento. El nombre del elemento es lo único que siempre se escribe; cualquier otro valor necesita una columna tipada que lo reciba.
| Lo que Anexus capturó | Dónde aterriza en monday.com | Columna que necesita |
|---|---|---|
| Nombre completo | El nombre del elemento | integrado — usa la dirección de correo si no se dio un nombre |
| Correo | La columna Email del tablero | cualquier columna del tipo email |
| Teléfono | La columna Teléfono del tablero | cualquier columna del tipo teléfono |
| Mensaje | Una columna de Texto llamada "notes" o "text" | tipo texto o texto largo, encontrada por ese nombre |
| Empresa, puesto | No está entre las columnas que se completan automáticamente | añade tus propias columnas y complétalas en monday, o léelas en el Mini CRM de Anexus |
| Un contacto sin correo válido | No se crea ningún elemento | se omite antes de llegar a monday.com |
Si tu tablero usa columnas con otros nombres, el elemento se crea igual solo con su nombre — nada se descarta porque falte una columna, y podrás completar el resto a mano después. Para mejores resultados, nombra tus columnas email, phone y text.
El título de una columna y su ID no son lo mismo
Cada columna de monday.com lleva dos nombres. El título es lo que ves en el tablero y puedes renombrar cuando quieras. El ID de columna se genera una sola vez, al crearla, y nunca cambia: renombrar una columna titulada "Correo de trabajo" a "Email" deja su ID exactamente como estaba. La API se dirige a las columnas por su ID, nunca por su título.
Por eso un tablero que parece perfecto puede seguir creando elementos vacíos, y por eso renombrar una columna no cambia nada. Consulta los IDs reales antes de tocar el tablero: el párrafo siguiente explica cómo. No borres una columna que ya contiene datos para intentar forzar otro ID: borrar una columna de monday.com elimina todos los valores que guarda, en todos los elementos del tablero. Si una columna sigue sin llenarse, no se pierde nada: la ficha completa queda en el contacto dentro del Mini CRM de Anexus. Completa el tablero a mano y contacta con soporte.
Para ver los IDs reales, usa el API playground del Developer Center de monday y consulta las columnas de tu tablero: devuelve el id, el title y el type de cada columna uno al lado del otro, lo que resuelve la duda en unos diez segundos.
Un tablero no es una base de contactos — cuenta con los duplicados
Los CRM clásicos tratan la dirección de correo como clave única y fusionan en silencio un segundo envío con el registro existente. Un tablero de monday.com no tiene esa noción: un elemento es una fila, y la misma persona conocida dos veces son dos filas. Diséñalo pensando en eso en vez de pelearte con ello: ordena o agrupa el tablero por la columna Email, o añade una automatización de monday.com ("cuando se crea un elemento…") para asignar un responsable, notificar a alguien o mover el elemento a un grupo de revisión para que nada quede sin atender.
Si algo sale mal
"monday: tablero no válido"
El ID del tablero es incorrecto, o el tablero está fuera del alcance de tu token. Revisa en este orden:
- Que copiaste solo los dígitos después de
/boards/, no un ID de vista ni un ID de pulse (elemento), sin barras - El tablero es Privado. Un tablero privado es invisible para quien no sea suscriptor, API incluida: añade al dueño del token como suscriptor del tablero, o pásalo a Principal
- Que el tablero no esté archivado ni en la papelera. Un tablero archivado conserva su ID pero deja de aceptar elementos nuevos
- Que puedes abrir ese tablero con la sesión iniciada como la persona cuyo token pegaste, no como tú, si son personas distintas
El elemento aparece, pero todas las columnas están vacías
Este es el síntoma clásico de monday.com y casi nunca es el token: el token evidentemente funcionó, porque el elemento existe. O las columnas del tablero llevan IDs internos que no son los que la integración espera (ver arriba), o el tipo de columna no coincide con el valor: una dirección de correo ofrecida a una columna de estado o de números se rechaza de plano en vez de guardarse como texto. Revisa el tipo y el ID real de cada columna en el API playground antes de cambiar nada, y no borres una columna que ya contiene datos. Si sigue sin llenarse, acepta la entrada manual y guarda la ficha completa en el Mini CRM de Anexus.
La columna Teléfono queda vacía mientras Email se llena bien
La columna de teléfono de monday.com no guarda una cadena simple: guarda un número junto con un país. Un número escrito sin código de país, o rodeado de espacios, guiones y paréntesis, puede aceptarse y luego mostrarse vacío. Si la mayoría de tus leads son canadienses y escriben 514-555-0123, cuenta con ello. El número no se pierde: sigue en el contacto dentro del Mini CRM de Anexus, y pedir el código de país en tu formulario de intercambio es la cura más limpia.
Funcionó durante meses y de pronto dejó de autorizar
Los tokens personales mueren con el acceso de su dueño. Comprueba si ese usuario de monday.com fue desactivado, eliminado de la cuenta, bajado a un asiento de Espectador, dado de baja del tablero, o si alguien hizo clic en Regenerate sobre el token. Genera un token nuevo, pégalo otra vez y usa el botón Probar de la tarjeta conectada para confirmarlo antes de fiarte de él.
Una ejecución grande de "Sincronizar contactos anteriores" se atasca a medias
El presupuesto de API de monday.com se mide por cuenta, no por aplicación, y cuenta la complejidad de las consultas además de las llamadas. Un rellenado compite entonces con todas las demás integraciones, automatizaciones y apps instaladas en la misma cuenta de monday.com. Los contactos rechazados quedan pendientes y el siguiente clic en Sincronizar contactos anteriores los retoma, así que ejecuta el rellenado fuera de tu hora punta y vuelve a hacer clic después.
Los elementos no están donde los busco
Antes de concluir que no llegó nada, revisa dos cosas. Mira en todos los grupos del tablero, no solo en el que vigilas. Y las vistas del tablero recuerdan sus filtros: una vista filtrada por un estado o un responsable oculta las filas recién creadas que no tienen ninguno. Cambia a la vista de Tabla principal y limpia el filtro.
Desconectar y rotar el token
Haz clic en Desconectar en Anexus y dejamos de crear elementos de inmediato. Los elementos que ya están en el tablero se quedan exactamente donde están: nunca volvemos a entrar en monday.com para borrar nada.
Para anular la credencial del lado de monday: Avatar de perfil → Developers → My access tokens → Show → Regenerate. Una advertencia propia de monday.com: un token personal es una sola credencial, no una por aplicación. Regenerarlo lo invalida para todas las herramientas, scripts y automatizaciones donde ese usuario lo haya pegado, no solo Anexus.