Skip to main content

Um código, cinco canais

Você não escreve um fluxo por canal. O SDK lê o tipo do canal e despacha o fluxo certo sozinho:
O tipo vem do canal, não da chamada. Você define o tipo em Criar canal e o SDK resolve o resto.

O que acontece por dentro

1

O SDK consulta o canal

Ele chama GET /instances/{channelId}/sdk-info para descobrir o tipo do canal, o app da Meta correspondente e as origens liberadas.
2

Despacha o fluxo do tipo

Cada tipo tem um caminho próprio de autorização — OAuth da Meta, QR Code ou token de bot.
3

Devolve os dados da conexão

O objeto de retorno muda conforme o canal. Veja a tabela abaixo.
4

Você finaliza no backend

Envie o retorno para POST /v1/channels/{channelId}/connect usando a Secret Key.

Fluxo de autorização por canal

O retorno muda por canal

Todos devolvem success e channelId. O resto depende do tipo:
Não trate esses campos manualmente. Mande o objeto inteiro para o seu backend e repasse como veio ao endpoint de conexão — ele sabe o que fazer com cada tipo.
A conexão só funciona a partir de domínios liberados, e o SDK falha em silêncio quando a origem não está na lista. Leia Origens do SDK antes de integrar.

Sem o SDK

O SDK existe porque cada canal tem um fluxo de autorização diferente na plataforma de origem, e todos exigem uma janela do navegador. Se você precisar montar isso na mão, cada página de canal descreve a URL de autorização, os escopos e os parâmetros usados.