Un channelId, cinco plataformas
En conectas el canal una vez y usas los mismos endpoints para todos: enviar mensaje, webhooks, todo igual. Lo que cambia es el flujo de conexión y lo que acepta cada plataforma.
Meta
WhatsApp Oficial, Instagram y Messenger se conectan mediante el OAuth de Meta.
Código QR
WhatsApp Web se conecta escaneando el código QR.
Telegram
Telegram se conecta con el token del bot.
Matriz de capacidades
No todo funciona en todos los canales: el límite es de la plataforma, no de nuestra API.El content.type de cada recurso
⚠️ Instagram y stickers: la plataforma solo acepta el sticker de corazón (
like_heart), no stickers arbitrarios.¹ Instagram y plantillas preaprobadas: la edge message_templates del Graph API existe solo en el node Page. Omni Z-API conecta Instagram mediante Instagram Login (el node IGUserForIGOnlyAPI), que no expone esa edge. Más detalles en Conectar Instagram.🔍 Celda no confirmada en la documentación oficial de la plataforma.Ventana de conversación: solo la tiene WhatsApp Oficial
Cómo identificamos el contacto
El camporecipient.identifier cambia de formato según el canal:
Plantilla preaprobada: WhatsApp y Messenger
Dos canales tienen plantilla que pasa por la aprobación de Meta, con alcances distintos:
Instagram, WhatsApp Web y Telegram no tienen. En Instagram es consecuencia del modelo de login que usamos: consulta Conectar Instagram.
Los Flows son exclusivos de WhatsApp Oficial.
Los endpoints de Plantillas de Omni Z-API cubren hoy solo WhatsApp Oficial. La Utility Template de Messenger está en implementación.
Próximos pasos
Ciclo de vida del canal
Crear, conectar, suscribir, desconectar y eliminar.
Envía tu primer mensaje
El endpoint es el mismo para todos los canales.