Saltar al contenido principal

Un channelId, cinco plataformas

En Omni Z-API 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

Meta Cloud API, 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.

No todo canal acepta todo

El cuerpo de la solicitud es el mismo en todos los canales, pero cada plataforma tiene sus límites: Instagram no tiene mensaje de ubicación, Telegram no tiene botón de llamar, el catálogo de productos solo existe donde hay catálogo. El límite es de la plataforma, no de nuestra API. La tabla completa, con cada reserva explicada y qué enviar en su lugar cuando el canal no la acepta, vive en una página propia:

Qué acepta cada canal

Los 20 tipos de mensaje en los cinco canales, marca por marca, con la condición de cada ⚠️.

Ventana de conversación: solo la tiene Meta Cloud API

La regla de la ventana de 24 horas es exclusiva de Meta Cloud API. En los demás canales envías mensajes en cualquier momento, sin ventana y sin plantillas.

Cómo identificamos el contacto

El campo recipient.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 Meta Cloud API.
Los endpoints de Plantillas de Omni Z-API cubren hoy solo Meta Cloud API. 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.