Um channelId, cinco plataformas
No 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
WhatsApp Oficial, 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.
Matriz de capacidades
Nem tudo funciona em todo canal — o limite é da plataforma, não da nossa API.O content.type de cada recurso
⚠️ Instagram e sticker: a plataforma aceita apenas o sticker de coração (
like_heart), não sticker arbitrário.¹ Instagram e template pré-aprovado: o message_templates do Graph API existe apenas no node Page. O Omni Z-API conecta o Instagram via Instagram Login (node IGUserForIGOnlyAPI), que não expõe essa edge. Detalhes em Conectar Instagram.🔍 Célula não confirmada na documentação oficial da plataforma.Janela de conversa: só o WhatsApp Oficial 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 do WhatsApp Oficial.
Os endpoints de Templates do Omni Z-API cobrem hoje apenas o WhatsApp Oficial. 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.