Um channelId, cinco plataformas
No Omni Z-API você conecta o canal uma vez e usa os mesmos endpoints para todos: enviar mensagem, webhooks, tudo igual. O que muda é o fluxo de conexão e o que cada plataforma aceita receber.
Meta
Meta Cloud API, Instagram e Messenger conectam pelo OAuth da Meta.
QR Code
WhatsApp Web conecta escaneando o QR Code.
Telegram
Telegram conecta com o token do bot.
Nem todo canal aceita tudo
O corpo da requisição é o mesmo em todos os canais, mas cada plataforma tem os seus limites: o Instagram não tem mensagem de localização, o Telegram não tem botão de ligar, catálogo de produto só existe onde existe catálogo. O limite é da plataforma, não da nossa API. A tabela completa, com as ressalvas escritas por extenso e o que mandar no lugar quando o canal não aceita, está em uma página só dela:O que cada canal aceita
Os 20 tipos de mensagem nos cinco canais, marca por marca, com a condição de cada ⚠️ explicada.
Janela de conversa: só a Meta Cloud API tem
Como identificamos o contato
O camporecipient.identifier muda de formato conforme o canal:
Template pré-aprovado: WhatsApp e Messenger
Dois canais têm template que passa por aprovação da Meta, com escopos diferentes:
Instagram, WhatsApp Web e Telegram não têm. No Instagram isso é consequência do modelo de login que usamos — veja Conectar Instagram.
Flows são exclusivos da Meta Cloud API.
Os endpoints de Templates do Omni Z-API cobrem hoje apenas a Meta Cloud API. O Utility Template do Messenger está em implementação.
Próximos passos
Ciclo de vida do canal
Criar, conectar, assinar, desconectar e remover.
Enviar sua primeira mensagem
O endpoint é o mesmo para todos os canais.