Conectar o RCS Business Messaging (Sinch/Vonage)

O RCS Business Messaging é o sucessor do SMS no Android: permite botões, carrosséis e confirmações de leitura dentro do próprio app Mensagens. Como o Google não integra diretamente com cada empresa, você precisa de um agregador (a Omnifox usa Sinch por padrão, mas também funciona com Vonage ou Infobip) que verifique seu agente RBM.

Requisitos

• Um agente RBM (Rich Business Messaging) verificado pelo Google através do seu agregador
• Project ID e Agent ID desse agente
• Um Access Token OAuth emitido pelo agregador

Passos para conectar

1. Registre e verifique seu agente RBM com o Google pelo painel do seu agregador (por exemplo, Sinch → Projects).
2. Copie o Project ID e o Agent ID desse painel.
3. Gere um Access Token para seu service plan (no Sinch: dashboard → Access Keys).
4. Na Omnifox, vá em Canais → Conectar novo canal, escolha RCS Business Messaging e preencha Project ID, Agent ID, Access Token e, opcionalmente, o Service Plan ID.
5. Salve e cole a Webhook URL exibida pela Omnifox no dashboard do seu agregador.

Configuração

• Project ID / Agent ID: identificam seu agente RBM verificado.
• Access Token: bearer OAuth para autenticar os envios.
• Service Plan ID: informativo, não é exigido pela API de envio em toda chamada.
• Webhook URL: o Sinch assina cada requisição com HMAC-SHA256 no header x-sinch-signature.

Exemplo

Um cliente Android recebe uma mensagem RCS com um cartão de produto e dois botões ("Ver pedido" / "Falar com um atendente"); ao tocar em um botão, o evento chega ao Inbox da Omnifox como resposta daquela conversa.

Dicas

• O RCS só funciona em dispositivos Android com o Mensagens do Google ativado; no iPhone a mensagem costuma cair para SMS, dependendo do agregador.
• O processo de verificação do agente junto ao Google pode levar vários dias; comece com antecedência.

Solução de problemas

• Os envios falham com erro de autenticação: o Access Token pode ter expirado; regenere-o no agregador.
• Nenhum evento chega: confirme que a Webhook URL no painel do agregador é exatamente a gerada pela Omnifox.