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

Ligue qualquer um destes em Definições > Conetividade > Gateway de Mensagens:

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

O WhatsApp Business e o Telegram são estáveis. Os restantes estão em beta — totalmente utilizáveis, ainda a ser aperfeiçoados.

Configuração

  1. Ative o Acesso Remoto para este dispositivo em Definições > Conectividade > Conexões > Relay Privado. É isto que efetivamente liga o dispositivo ao relay que recebe mensagens de entrada; sem isto, nada chega, independentemente de como os serviços abaixo estão configurados. Está desativado por predefinição e por dispositivo (consulte Suporte de Plataforma abaixo).
  2. Aceda a Definições > Conectividade > Gateway de Mensagens.
  3. Escolha um serviço.
  4. Introduza as credenciais padrão de bot ou de negócio desse fornecedor — o mesmo token ou conta comercial que utilizaria para qualquer integração nessa plataforma.
  5. O Caiioo regista a rota de entrada. Se o Acesso Remoto ainda não estiver ativado em nenhum lado, Definições > Conectividade > Gateway de Mensagens avisá-lo-á e permitir-lhe-á ativá-lo diretamente aí.

Configura cada serviço uma vez. Depois disso, o agente vê uma única capacidade de mensagens, independentemente do número de serviços ligados.

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 dispositivo que estiver com o Acesso Remoto ativado — o aplicativo de desktop, a extensão de navegador ou ambos. O agente roda na sua máquina; conversas, credenciais e mídias são tratadas ali — não na nuvem.

O Cloudflare atua apenas como um retransmissor de webhook burro por usuário. Cada usuário obtém um Durable Object de locatário único que encaminha o webhook de entrada bruto para o seu dispositivo por meio 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 o Cloudflare completamente — seu dispositivo chama a API do serviço diretamente. O Cloudflare está na jogada apenas porque serviços externos precisam de uma URL pública estável para entregar webhooks de entrada.

Suporte de Plataforma

O que determina efetivamente se recebe uma mensagem é o Acesso Remoto (Definições > Conectividade > Conexões > Relay Privado) — um interruptor por dispositivo, desativado por predefinição, que não é sincronizado entre os seus dispositivos de propósito (é uma definição de exposição de rede, como abrir uma porta). Ative-o para cada dispositivo que pretenda que responda a mensagens; deixe-o desativado naqueles que não pretende.

  • macOS, Windows, Linux — suportado. Ative o Acesso Remoto na aplicação de ambiente de trabalho para que esta responda.
  • Extensão de browser (Chrome, Safari) — suportada e funciona totalmente por si própria — não é necessária nenhuma aplicação de ambiente de trabalho. Ative o Acesso Remoto nas Definições da própria extensão e esta liga-se diretamente e responde a mensagens de forma autónoma.
  • Se tiver ambos uma aplicação de ambiente de trabalho e a extensão com o Acesso Remoto ativado ao mesmo tempo, a aplicação de ambiente de trabalho tem prioridade; a extensão fica em modo de espera como cópia de segurança caso a aplicação de ambiente de trabalho fique offline.
  • iOS ou Android — indisponível. As aplicações móveis não executam o cliente de relay privado de que o gateway depende, pelo que as mensagens recebidas não podem ser recebidas ou respondidas aí, independentemente do Acesso Remoto.

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.