Conectar o Telegram ao Opa! Suite
Caminho: Opa! Store → Telegram → Instalar
Visão geral
O app do Telegram permite que você atenda, dentro do Opa! Suite, os clientes que conversam com o bot da sua empresa no Telegram. Assim, essas conversas entram na mesma fila de atendimento dos outros canais e podem passar pelo agente virtual e pelo fluxo de comunicação.
A integração funciona por meio de um bot: você cria o bot no próprio Telegram, com o nome da sua empresa, e conecta esse bot ao Opa! Suite. O Telegram não usa modelos de mensagem (template) como o WhatsApp e não tem cobrança por mensagem: o custo é o da licença do app.
Pré-requisitos
- Licença do app Telegram contratada. Sem licença, a página do app mostra o botão Obter, que abre uma conversa com o time comercial. Cada bot conectado usa uma licença.
- Permissão para visualizar o Opa! Store no seu grupo de permissões.
- Agente virtual já criado no Opa! Suite. Ele será o responsável pelo canal.
- Conta no Telegram para criar o bot no @BotFather, o bot oficial do Telegram para criar e gerenciar bots.
Passo a passo
- Acesse Opa! Store e abra o app Telegram.
- Clique em Instalar. A janela Adicionar app Telegram abre com duas etapas.
- Na etapa Dados Iniciais, preencha os campos:
- Nome: nome para identificar o canal dentro do Opa! Suite.
- Agente virtual: o agente virtual que vai receber as conversas deste canal.
- Clique em Continuar.
- Na etapa Conexão, clique em Iniciar criação. O Telegram Web abre em uma nova aba, na conversa com o @BotFather.
- No chat do BotFather, envie o comando
/newbot. - Quando o BotFather pedir, informe o nome do bot. É o nome que os clientes vão ver, por isso use o nome da sua empresa.
- Informe o nome de usuário do bot. Ele precisa terminar com a palavra bot (ex.:
minhaempresa_bot) e não pode ter espaços nem acentos. - Copie o token que o BotFather envia em resposta (uma sequência de números e letras).
- Volte ao Opa! Suite e cole o token no campo Token.
- Clique em Adicionar Telegram.
Quem tem o token consegue controlar o bot. Não compartilhe o token e não o publique em lugares abertos.
Resultado esperado
O app aparece como instalado e o botão Acessar passa a abrir a lista de canais do Telegram, com as colunas Nome, Status, Agente Virtual e Fluxo de Comunicação.
Para testar, abra o Telegram, procure o bot pelo nome de usuário e envie uma mensagem. Se o agente virtual responder, a integração está funcionando.
Para conectar outro bot, acesse Opa! Store → Telegram → Acessar e clique em Adicionar novo. O processo é o mesmo. A quantidade de bots conectados depende das licenças contratadas. Se não houver licença livre, o botão Obter aparece no lugar.
Configurações disponíveis
Para ajustar o canal, acesse Opa! Store → Telegram → Acessar e clique no registro. A tela tem duas seções. Em cada uma, clique em Editar informações, faça as alterações e salve.
Dados de cadastro
| Campo | O que faz |
|---|---|
| Nome | Nome de identificação do canal. |
| Status | Ativo ou Inativo. Para ativar, é preciso ter uma licença do Telegram livre. |
| Agente virtual | Agente virtual responsável pelo canal. |
| Token | Token do bot, oculto. Para trocar de bot ou atualizar um token revogado, digite o novo token. Em branco, mantém o atual. |
Preferências
| Campo | O que faz |
|---|---|
| Prioridade dos atendimentos na fila | Ordem do canal na fila: Altíssima, Alta, Média, Baixa ou Baixíssima. Canais com prioridade maior aparecem primeiro. |
| Exibir nome do atendente no cabeçalho das mensagens | Mostra ao cliente o nome do atendente no topo das mensagens. |
| Verificar se contato é humano | Confirma que quem escreve é uma pessoa antes de abrir o atendimento. |
Com Verificar se contato é humano ativo, o agente virtual pergunta "Você é humano?" antes de abrir o primeiro atendimento do contato, com as opções Sim e Não em ordem aleatória. O atendimento só é aberto se a pessoa responder Sim. Depois disso, a pergunta não se repete para esse contato. Se a resposta for Não, nenhum atendimento é aberto e a pergunta volta na próxima mensagem.
O aviso automático de posição na fila não é configurado no canal. Ele fica no departamento, em Avisar posição na fila.
Como as mensagens se comportam
- O Opa! Suite recebe do Telegram textos, fotos, vídeos, áudios e mensagens de voz, documentos, figurinhas, localização e contatos compartilhados.
- Os arquivos enviados pelo atendente chegam ao cliente como documento no Telegram.
Desinstalar o app
- Acesse Opa! Store → Telegram → Acessar e abra o registro.
- Clique em Desinstalar App.
- Digite o nome do canal exatamente como está cadastrado. O botão Desinstalar só é liberado quando o nome confere.
- Clique em Desinstalar.
Ao desinstalar, a conexão com o bot é desfeita. Atendimentos em andamento são interrompidos, e atendimentos já encerrados perdem o vínculo com o canal, o que pode afetar as métricas.
Problemas comuns
| Sintoma | O que verificar |
|---|---|
| O BotFather recusa o nome de usuário | O nome precisa terminar com bot, não pode ter espaços nem acentos e não pode estar em uso por outro bot. |
| O bot não responde depois da instalação | Confira se o canal está Ativo e se o token é do bot certo. Se o token foi revogado no BotFather, gere outro e atualize o campo Token. |
| Aparece o botão Obter mesmo com o app contratado | Use Sincronizar licença em Configurações → Sobre. Se continuar, fale com o time comercial. |
| Não é possível ativar o canal | Todas as licenças do Telegram estão em uso por outros canais ativos. Inative outro canal ou contrate mais licenças. |
Boas práticas
- Use o nome da empresa no nome do bot. É por ele que os clientes vão encontrar o seu canal.
- Divulgue o link do bot (
https://t.me/seguido do nome de usuário) no site, nas redes sociais e na assinatura de e-mail. - Não conecte o mesmo bot a outra ferramenta. A última ferramenta conectada passa a receber as mensagens do bot.
- Cadastre as respostas mais usadas em Mensagens rápidas para agilizar o atendimento.