Omni Octo

Conecte seu bot do Telegram

Cole o token do seu bot em Canais → Adicionar canal → Telegram. O Omni Octo o verifica, diz ao Telegram para enviar as mensagens do bot para cá com um segredo que só o Telegram conhece, e mostra o bot na página do canal. O que cada mensagem significa e como trocar o token depois.

Atualizado

O vídeo começa onde o mecânico cola o token do bot e aperta Conectar e validar; volte para ver a oficina e os clientes.

Conectar um bot exige o token dele e nada mais. Você precisa primeiro ter o bot criado — o que o Telegram exige cobre o BotFather — e depois é um único formulário.

Conecte-o

  1. Abra /channels e aperte Adicionar canal.

  2. Escolha Telegram. A página que abre é Conectar Telegram, com os três passos do BotFather nela, em Como obter suas credenciais:

    Abra o Telegram e busque @BotFather Envie /newbot e siga as instruções Copie o token do bot que o BotFather der

  3. Em Credenciais, preencha dois campos:

    • Nome do canal — já vem preenchido com “Telegram”. Deixe assim, e o canal recebe o nome do bot quando se conecta: Telegram — @BrightwaterBikesBot. Ou digite o seu.
    • Token do bot (do @BotFather) — cole o token.

  4. Aperte Conectar e validar.

Canal conectado com sucesso Agora você pode implantar um agente neste canal.

Daquele momento em diante, as mensagens que os clientes enviam ao bot chegam ao Omni Octo. O próximo passo é escolher quem responde — coloque um agente no seu bot. Até você fazer isso, elas continuam chegando e esperam sua equipe em /conversations.

O formulário Conectar Telegram: Como obter suas credenciais com os três passos do BotFather, depois Credenciais com Nome do canal em Telegram, o campo Token do bot (do @BotFather) com o token colado em pontos, e o botão Conectar e validar.
Em cima, os três passos do BotFather; embaixo, o único formulário: um nome e o token.

O que Conectar e validar faz

Duas coisas, em ordem:

  1. Verifica o token com o Telegram. Um token que funciona diz ao Omni Octo o @usuário e o nome do bot.
  2. Diz ao Telegram para enviar as mensagens do bot ao Omni Octo, com um segredo que só o Telegram e o Omni Octo conhecem. Toda mensagem que o Telegram entrega o traz, e qualquer coisa que chegue sem ele é recusada, então ninguém pode postar mensagens falsas de clientes na sua caixa de entrada.

Se qualquer um dos passos falhar, a página diz A validação não passou com o motivo. O canal ainda é criado, marcado como Erro, e você pode corrigi-lo pela página dele.

O que o motivo dizO que significa
Health check failed: 401: UnauthorizedO token está errado, ou foi revogado no BotFather. Copie de novo — inteiro, inclusive a parte antes dos dois-pontos.
… is already connected to another Omni Octo channelEste bot está conectado em outro lugar. O Telegram envia as mensagens de um bot a um só lugar, então primeiro exclua o outro canal, ou crie um segundo bot.
The bot token works, but Telegram could not be told to send this bot’s messages hereO token está certo; o Telegram não aceitou o segundo passo. Espere um minuto e aperte Validar na página do canal.

A página do canal

Abra o canal a partir de /channels. Ao lado do nome dele estão Telegram e o status dele — Ativa quando está conectado. Em Informações da plataforma você encontra o botUsername e o botName do bot, como o Telegram os reportou, e em Agentes o agente que responde aqui, quando houver um.

Validar aparece quando o canal não está Ativa. Ele roda os dois passos de novo: use depois de corrigir o que o motivo disser.

A página do canal Telegram — @BrightwaterBikesBot, marcada Ativa: Informações da plataforma mostra botUsername @BrightwaterBikesBot, botName Brightwater Bike Repair e canJoinGroups true; em Agentes, Brightwater front desk com a etiqueta Responde, Ativado.
Um bot conectado: Ativa, o que o Telegram informou sobre ele e o agente que responde.

Trocando o token

Se você revogar o token no BotFather, ou migrar para um bot novo:

  1. Na página do canal, aperte Atualizar credenciais.
  2. Cole o novo token e depois aperte Salvar e validar.

Os dois passos rodam de novo com o novo token, e o Telegram recebe um novo segredo. Um novo token para o mesmo bot mantém as conversas que você já tem. Um token para um bot diferente é um bot diferente para seus clientes: eles terão que encontrar o novo e escrever para ele.

Excluindo o canal

Excluir na página do canal remove o canal e tira todos os agentes dele (os agentes em si são mantidos):

… e todas as suas implantações serão removidos permanentemente. Isso não pode ser desfeito.

O bot em si continua existindo no Telegram, e os clientes podem continuar escrevendo para ele, mas ninguém responde. Para conectá-lo de novo, adicione-o como um novo canal.

Conectando-o pedindo ao Octo

O Octo pode fazer o mesmo a partir de uma conversa. Diga a ele o que você quer, com o token:

Conecte meu bot do Telegram e faça a recepcionista da Brightwater responder nele. O token é …

O Octo conecta o bot, diz ao Telegram para onde enviar as mensagens dele e coloca o agente nele, perguntando antes dos passos que mudam o que os clientes veem.

Para onde ir depois