Esta é uma tradução automática do documento original em inglês. Em caso de conflito entre esta tradução e a versão original em inglês, a versão em inglês prevalecerá. Ler a versão original em inglês

Messaging Gateway: Deixe o Caiioo Responder nos Aplicativos que Seus Contatos Já Usam

O Messaging Gateway é uma forma agnóstica de serviço para o Caiioo enviar e receber mensagens nas plataformas que seus clientes e contatos já usam. As pessoas enviam mensagens para você no WhatsApp, Telegram ou onde quer que já estejam, e o agente as responde de forma autônoma — no canal delas, em tempo real. O mesmo gateway funciona no sentido inverso também: a partir de qualquer thread, o agente pode enviar uma mensagem como uma ferramenta ("envie uma mensagem para o grupo da equipe no Telegram sobre a reunião").

Um gateway, muitos serviços. Você conecta cada serviço uma vez, e o Caiioo normaliza tudo por trás de uma única interface.

Serviços Suportados

Conecte qualquer um destes em Configurações > Mensagens:

  • WhatsApp Business — estável
  • Telegram — estável
  • Messenger (beta)
  • iMessage (beta)
  • Signal (beta)
  • Viber (beta)
  • Beeper (beta)

WhatsApp Business e Telegram estão estáveis. Os demais estão em beta — totalmente utilizáveis, ainda sendo aprimorados.

Configuração

  1. Vá em Configurações > Mensagens (o Messaging Gateway).
  2. Escolha um serviço.
  3. Insira as credenciais padrão de bot ou conta comercial desse provedor — o mesmo token ou conta comercial que você usaria para qualquer integração nessa plataforma.
  4. O Caiioo registra a rota de entrada e começa a ouvir.

Você configura cada serviço uma vez. Depois disso, o agente vê uma única capacidade de mensagens, independentemente de quantos serviços estão conectados.

Modos de Interação por Conversa

Cada conversa tem seu próprio modo, escolhido através de três botões no topo da thread, para que você decida exatamente como o agente aparece para cada contato:

Automático (verde)

O agente responde a todos automaticamente. Qualquer coisa que você digitar nessa mesma thread é tratada como orientação — ela molda a próxima resposta do agente, mas não é enviada ao contato. Use isso quando quiser que o agente gerencie a conversa, mas você queira ocasionalmente direcioná-lo ("seja mais formal", "ofereça o desconto").

Intervir (azul)

O agente ainda responde automaticamente às mensagens recebidas, mas qualquer coisa que você digitar vai direto para o contato como você. Use isso quando quiser intervir e falar com a pessoa você mesmo, enquanto o agente mantém a conversa fluindo nos intervalos.

Chat (âmbar)

O agente pausa e se retira — ele para de responder automaticamente e você gerencia a conversa sozinho, com suas mensagens indo para o contato como você. Use isso quando uma thread precisar de um humano e você quiser que o agente não interfira.

Mídia em Ambas as Direções

Imagens, áudio e vídeo fluem em ambas as direções. Quando um contato envia uma foto, ela chega ao modelo, para que você possa perguntar "o que há nesta foto que o cliente acabou de enviar?" e responder de volta no mesmo canal. Mídias que o agente produz ou anexa fluem de volta para o contato da mesma forma.

Privacidade e Arquitetura

Todo o processamento de mensagens acontece localmente, no seu servidor de desktop. O agente roda na sua máquina; conversas, credenciais e mídias são gerenciadas lá — não na nuvem.

A Cloudflare atua apenas como um retransmissor de webhook passivo por usuário. Cada usuário recebe um Durable Object de locatário único que encaminha o webhook de entrada bruto para o seu servidor local através de uma conexão privada e nada mais. Não há armazenamento de mensagens na nuvem nem processamento no lado da nuvem. As mensagens de saída ignoram a Cloudflare inteiramente — seu servidor local chama a API do serviço diretamente. A Cloudflare está no circuito apenas porque os serviços externos precisam de uma URL pública estável para entregar webhooks de entrada.

Suporte de Plataforma

O Messaging Gateway roda no seu aplicativo de desktop ou servidor — é onde residem o retransmissor de webhook de entrada e o processamento de mensagens:

  • macOS — suportado
  • Windows — suportado
  • Linux — suportado

A extensão de navegador (Chrome, Safari) também pode usar o gateway, desde que esteja conectada ao seu aplicativo de desktop — o servidor de desktop faz o recebimento e processamento real em seu nome.

Ele não está disponível para iOS ou Android. Os aplicativos móveis não executam o retransmissor de webhook ou o processamento local dos quais o gateway depende, portanto, as mensagens recebidas não podem ser recebidas ou respondidas lá.

Uma Nota sobre o Slack

O Slack não faz parte do Messaging Gateway. O Slack vive no Community Hub como seu próprio pacote OAuth — instale-o de lá. Veja Community Hub.

Nível

O Messaging Gateway é um recurso Pro.

Veja Também

This guide is maintained by the Caiioo team using Slate, our built-in editor.