Cargando…

Esto está tardando más de lo esperado.

El módulo API

Conecta tus propios sistemas, como tu software de ventas o de facturación, a tu equipo con un token de API — cómo prender el módulo, crear un token, dárselo a tu sistema, enviar tus plantillas aprobadas desde él y revocarlo.

El módulo API permite que los otros sistemas que usa tu negocio — tu software de ventas o de facturación, tu ERP, un programa propio — hablen con tu equipo de Sync Pro. Con un token, un sistema puede consultar a qué equipo y a qué número de WhatsApp está conectado, leer tus plantillas aprobadas con su texto y sus variables, enviar una de ellas a un teléfono y después consultar si llegó y si se leyó.

Cada token pertenece a un equipo, actúa con los permisos de la persona que lo creó y se puede revocar por separado. No es lo mismo que un token MCP, que es para un asistente de IA: un token MCP no abre la API, y un token de API no conecta un asistente de IA. Consulta Conecta tu cliente de IA con MCP.

Antes de empezar

  • Prende el módulo. El módulo API es gratis en todos los planes, y tu equipo lo prende por su cuenta. Alguien cuyo rol tenga Administrar planes abre Complementos desde el menú, busca API y pulsa Activar. Consulta Prender y apagar módulos.
  • Ten el permiso para administrar tokens. Tu rol necesita, dentro de Permisos, Administrar tokens MCP o Editar ajustes — los mismos que para los tokens MCP. El dueño del equipo tiene los dos desde el inicio.

Crea un token

  1. Ve a Configuración → Integraciones. Cuando el módulo API está prendido y tu rol tiene Administrar tokens MCP o Editar ajustes, ahí aparece una sección API.
  2. Escribe un Nombre del token que te diga qué sistema lo va a usar — por ejemplo, Control Total — y pulsa Crear token.
  3. Pulsa Copiar token y guarda el token en un lugar seguro en ese momento. No podrás volver a verlo. Pulsa Hecho cuando lo tengas.

Si pierdes un token, no se puede recuperar: crea uno nuevo y revoca el anterior. Usa un token por sistema, para poder detener uno sin detener los demás.

Dáselo a tu sistema

Quien configure el otro sistema necesita dos cosas de la sección API:

Qué Dónde
La dirección La URL de la API que aparece arriba en la sección.
El token El token que copiaste. El sistema lo manda en el encabezado Authorization, como Bearer seguido del token.

La API le contesta a tu sistema en inglés, sin importar el idioma en que uses Sync Pro, porque quien lee esas respuestas es quien programa la conexión.

Qué puede hacer tu sistema

Trabaja dentro del equipo al que pertenece el token, y solo hasta donde la persona que creó el token tiene permitido llegar.

  • Ver a qué equipo está conectado, con tu número de WhatsApp y su nombre verificado cuando hay un número vinculado.
  • Leer tus plantillas aprobadas, una por una o todas juntas, con su encabezado, texto, pie, botones y variables, y qué variables se llenan con los datos del contacto. Una plantilla de código de verificación, de la categoría Autenticación, también muestra si lleva el aviso de seguridad, cuántos minutos dura su código y el texto de su botón de copiar código; cuando tu sistema envía una, el código va en el mensaje y en ese botón. Las plantillas no se pueden crear desde la API. Solo se muestran las plantillas aprobadas, y solo cuando tu número de WhatsApp está vinculado. Si la persona que creó el token no puede ver plantillas, el sistema tampoco.
  • Listar tus campañas de prospectos y tus tableros Kanban, con las columnas de cada tablero en orden y cuál es la columna final, para que tu sistema sepa dónde puede poner a un contacto. Las campañas solo se listan mientras el módulo Prospectos avanzados está prendido.
  • Enviar una plantilla aprobada a un teléfono, y después consultar si llegó: enviada, entregada, leída, o fallida con el motivo que dio WhatsApp. Consulta Envía plantillas desde tu sistema.

Cada token puede hacer hasta 600 solicitudes por minuto. Pasado eso, se le pide al sistema que espere unos segundos y vuelva a intentarlo.

Envía plantillas desde tu sistema

Tu sistema puede enviar una de tus plantillas aprobadas a un teléfono — una cotización, un recordatorio, un aviso de pago — sin que nadie abra el chat. Manda el teléfono, el nombre del contacto, la plantilla y los valores de sus variables, y Sync Pro la envía desde tu número de WhatsApp.

  • El teléfono siempre lleva su lada de país, como 52 para México: 529611235894 o +52 961 123 5894 funcionan los dos. Un teléfono sin ella se rechaza y no se envía nada.
  • Si el contacto ya existe, el mensaje llega a la conversación de ese contacto, y su nombre y sus responsables se quedan como estaban. Si no existe, Sync Pro crea el contacto con el nombre que mandó tu sistema.
  • El mensaje sale a nombre de la persona que creó el token. En el chat aparece con el nombre de esa persona y una etiqueta Vía API · nombre del token junto a su hora, y otra vez junto al nombre de quien lo envió cuando abres la información del mensaje, para que siempre sepas qué sistema lo envió. El Historial de Actividad del contacto lleva la misma etiqueta.
  • Cuenta para tu límite mensual de contactos, como cualquier mensaje que envía tu equipo. Cuando tu equipo ya llegó a su límite, no se envía nada a un contacto que no se haya atendido este mes. Consulta el límite mensual de contactos en Chats y conversaciones.
  • Una plantilla puede generar un cargo de Meta cuando reabre la ventana de 24 horas de una conversación, igual que cuando la envías desde el chat.

No se envía nada cuando tu número de WhatsApp no está vinculado, cuando la plantilla no es una de tus plantillas aprobadas, cuando una variable que no se llena con los datos del contacto no tiene valor, o cuando la plantilla necesita un archivo nuevo en su encabezado en cada envío — por la API no se envían archivos, así que usa una plantilla sin archivo de encabezado o una cuyo archivo de encabezado sea fijo. A tu sistema se le dice cuál de estas pasó.

Tu sistema también puede decir a dónde va el contacto: una campaña de prospectos y una columna de uno de tus tableros Kanban, cada una con el ID que obtuvo de las listas de arriba. Las dos son opcionales.

  • Campaña. Un contacto nuevo se crea en esa campaña. Un contacto que ya existe la recibe solo si no tiene campaña; uno que ya tiene campaña se queda con la suya.
  • Columna. Cuando el contacto todavía no está en el tablero de esa columna, se le crea una tarjeta en esa columna, aparece en el Historial de Actividad del contacto, y se avisa a los miembros que siguen ese tablero, como cuando llega cualquier contacto nuevo. Cuando el contacto ya está en ese tablero, su tarjeta no se mueve ni se duplica.
  • Las dos se quedan aunque WhatsApp después rechace el mensaje, porque se asignan cuando el contacto se crea o se encuentra.

No se envía nada ni se crea el contacto cuando la campaña o la columna no son de tu equipo, cuando se manda una campaña con el módulo Prospectos avanzados apagado, o cuando la columna es la columna final de su tablero. A tu sistema se le dice cuál de estas pasó.

Tu sistema también puede darle a cada envío su propia referencia, como el número de su cotización. Una plantilla nunca se envía dos veces con la misma referencia: si tu sistema repite un envío, se le informa del mensaje que ya se envió en lugar de enviarlo otra vez. Solo cuando el último envío con esa referencia falló, repetirlo lo envía de nuevo, para que tu sistema pueda reintentar después de corregir el problema.

La persona que creó el token necesita Recuperar prospectos en su rol para que el sistema envíe plantillas o las consulte. El sistema solo puede consultar los mensajes enviados por la API, nunca los que se escribieron en el chat. Para listar o usar campañas, la persona necesita ver Campaña de prospectos; para listar tableros, ver Flujo; y para poner a un contacto en una columna, crear en Paso de tipo de flujo. Consulta Roles y permisos.

Mira lo que pidieron tus sistemas

Cada llamada que hace un token aparece en Solicitudes API, en el menú del equipo, con api como su Fuente y el nombre del token como su Identificador, junto con la respuesta que recibió — incluidas las que se rechazaron. Consulta El registro de solicitudes API.

En la sección API, la lista de tokens muestra de cada uno su Nombre, quién lo creó en Creado por — Exmiembro cuando la cuenta de esa persona se eliminó —, cuándo se creó en Creado y cuándo se usó por última vez en Último uso, o Nunca. Quien puede administrar tokens los ve todos y puede revocar cualquiera.

Revocar un token

En Configuración → Integraciones → API, pulsa Revocar junto al token y confirma. Deja de funcionar en ese momento; los demás tokens siguen funcionando.

Un token también deja de funcionar cuando:

  • se apaga el módulo API — todos los tokens del equipo se detienen sin borrarse, y vuelven a funcionar cuando se prende de nuevo;
  • la persona que lo creó sale del equipo;
  • la persona que lo creó ya no tiene Administrar tokens MCP ni Editar ajustes, o su cuenta está bloqueada — el token sigue en la lista, y vuelve a funcionar si recupera alguno de esos permisos.