Conectar un sistema externo o un asistente

Qué hacer

1. Para mensajes entrantes, abre Configuración y localiza URL del webhook (para el servidor de WhatsApp).
2. Selecciona Copiar para obtener la dirección exacta de esta instalación.
3. Pide al operador configurar eventos del dispositivo con esa dirección.
4. Organiza un mensaje entrante desde tu número propio cuando confirme preparación.
5. Comprueba la respuesta esperada o un registro nuevo de grupo con Registro activo.
6. Para asistentes, inicia sesión en la autorización que abre el cliente MCP.
7. Revisa aplicación y cuenta antes de autorizar.
8. Para integrar envíos, abre Configuración → Integraciones externas. Crea una clave con nombre para una cuenta conectada y grupos seleccionados explícitamente. Guarda la clave de inmediato; solo se muestra una vez. Copia la URL base de la API.
9. Ejemplo: Configura Abacus.AI para generar contenido nuevo en cada uno de los ocho horarios diarios de publicación en America/Sao_Paulo. Envía cada publicación a tres grupos permitidos con un nuevo Idempotency-Key. Reutiliza la clave solo para repetir una solicitud idéntica.
10. Omite scheduled_at para poner en cola de inmediato, o usa una fecha y hora absolutas con -03:00 o Z (UTC), hasta 30 días en el futuro. El procesador comprueba la cola cada minuto; scheduled_at es la primera hora admisible, sin garantía de entrega en el segundo exacto.
11. Comprueba el estado de la publicación y los resultados por grupo antes de reintentar. Cancela solo los envíos aún no iniciados. Revoca una clave comprometida en Configuración y después crea y guarda otra; las publicaciones antiguas no se reanudan con una clave nueva.

Qué conviene saber

• Los asistentes pueden leer registros disponibles y enviar texto solicitado. Consulta Herramientas del asistente antes de pedir un envío.
• Usa el panel para ediciones no disponibles mediante MCP.
• El acceso a la API está incluido en los planes Pro y Agency mensuales o anuales. Starter requiere cambiar de plan. Las claves solo permiten usar la cuenta y los grupos seleccionados; sustituir la cuenta de WhatsApp bloquea los envíos. Nunca compartas las credenciales del servidor.
• Los textos admiten 4.096 caracteres; las leyendas, 1.024. Sube archivos JPEG, PNG o WebP de hasta 5 MiB en los campos multipart payload e image. No se aceptan URL de imágenes remotas.
• Una nueva publicación devuelve HTTP 202. Un reintento idéntico con el mismo Idempotency-Key devuelve la publicación original con HTTP 200; un contenido diferente con la misma clave devuelve 409. Un tiempo de espera agotado tras iniciar el envío puede dejarlo sin confirmar; no lo reenvíes automáticamente con otra clave.

Problemas habituales