Skip to main content

​
Pré-requisitos

Antes de iniciar a integração, certifique-se de que você atende aos seguintes requisitos:
  • Possuir uma conta ativa no Telegram,
  • Ter acesso ao aplicativo Telegram (mobile ou web),
  • Possuir acesso ao Invenio Center,
  • Ter permissão para gerenciar o canal de telegram na plataforma.

​
Integrando o Telegram a plataforma

​
Criando um Bot no Telegram

O primeiro passo é criar o bot que será utilizado como canal de atendimento.

​
Passo a passo

  1. Acesse o Telegram,
  2. Pesquise por @BotFather,
  3. Inicie uma conversa com o bot oficial
  4. Envie o comando: /newbot,
  5. Informe:
    • Nome do bot (nome visível para usuários),
    • Username do bot (deve terminar com _bot).

​
Regras para o username

  • Deve conter entre 5 e 32 caracteres,
  • Aceita letras, números e underscore (_),
  • Obrigatoriamente termina com _bot.

​
Obtendo o Token do Bot

Após a criação do bot, o Telegram disponibilizará um token de autorização. Esse token é utilizado para autenticar o bot e permitir que a plataforma Invenio envie e receba mensagens em seu nome, viabilizando a comunicação com a API do Telegram.
O token funciona como uma credencial de autenticação entre o Telegram e a plataforma.
⚠️ Importante: Mantenha este token seguro. Não compartilhe com terceiros.
A área destacada em vermelho corresponde ao trecho onde está o token gerado pelo bot do Telegram.

​
Configurando o Canal no Invenio Center

Com o token em mãos, siga os passos abaixo para concluir a integração:
  1. Acesse o Invenio Center,
  2. Navegue até: Canais → Telegram,
  3. Insira o token gerado pelo BotFather,
  4. Clique em Salvar.
Após salvar, o canal estará ativo e pronto para uso.

​
Funcionamento do Canal

Após a integração, o fluxo de comunicação ocorre da seguinte forma:
  1. O cliente encontra seu bot no Telegram,
  2. Inicia uma conversa,
  3. A mensagem é recebida pela Invenio,
  4. O atendimento pode ser realizado por meio de atendimento humano ou de forma automatizada, utilizando chatbot.

​
Visão do contato

​
Visão da operação

As conversas no Telegram devem ser iniciadas pelo contato. A partir desse primeiro contato, sua empresa pode enviar mensagens livremente, sem restrições de envio. A integração com o Telegram amplia as possibilidades de atendimento digital, oferecendo um canal rápido, seguro e escalável para comunicação com seus clientes.

Canais Invenio

Gerenciamento e ativação de canais de atendimento no Invenio Center

IDR

Criação e configuração de fluxos automatizados

Invenio Live

Plataforma utilizada pelos operadores para atendimento em tempo real

Usuários e Permissões

Gerenciamento de usuários e definição de acessos no ambiente

​
⁉️ Perguntas Frequentes (FAQ)

Se o cliente não iniciar a conversa, não será possível enviar mensagens para ele. No Telegram, o primeiro contato deve obrigatoriamente partir do usuário.
Não. O Telegram não permite o envio de mensagens para contatos que ainda não interagiram com o bot.
Não. O bot funciona por meio da integração com a plataforma, portanto as mensagens enviadas pelos clientes serão recebidas normalmente no Invenio Center.
Se o token for alterado ou comprometido, a integração pode parar de funcionar ou ficar vulnerável. Nesse caso, será necessário gerar um novo token no BotFather e atualizá-lo no Invenio Center.
Não há restrição de janela de envio após o primeiro contato do cliente. A comunicação pode ocorrer livremente a partir da interação inicial.
O bot pode ser acessado pelo username (ex: @suaempresa_bot) ou por meio de um link direto compartilhado pela empresa.
Sim. O canal pode operar de forma totalmente automatizada por meio de fluxos de chatbot, sem necessidade de atendimento humano.
A conversa permanece registrada e sua empresa ainda pode enviar mensagens, desde que o cliente já tenha iniciado a interação anteriormente.
Sim. Após a ativação do canal, ele pode ser integrado normalmente aos fluxos de atendimento já configurados na plataforma.