Como conectar o Telegram

O que é a conexão do Telegram

Um canal de atendimento pelo Telegram, usando um bot próprio seu.

Diferente do WhatsApp, no Telegram o atendimento é feito por um bot — um contato oficial da sua empresa que os clientes encontram pelo nome de usuário (ex.: @suaempresa_bot) ou por um link t.me/suaempresa_bot. Quando alguém envia uma mensagem para esse bot:

a mensagem entra no Inbox do Leadhit, como uma conversa normal;
você responde pela própria conversa (texto e mídias);
o contato é criado automaticamente e pode ir para o Kanban, receber etiquetas, etc.

Bom saber

Criar o bot no Telegram é gratuito e não precisa de aparelho conectado nem leitura de QR Code — é só um token.

Antes de começar

O que você precisa ter em mãos.

O aplicativo do Telegram instalado (celular ou computador) com uma conta ativa.
A conexão de Telegram liberada no seu plano. Se a opção não aparecer ao adicionar uma conexão, fale com o suporte.
Cerca de 3 minutos. 🙂

Você pode ter vários bots (um por setor, por exemplo). Cada bot é uma conexão separada no Leadhit.

1 Abra o BotFather no Telegram

O BotFather é o robô oficial do Telegram que cria e gerencia bots.

No Telegram, toque na busca e digite @BotFather.
Abra o resultado com o selo azul de verificado — é o oficial. Cuidado com imitações.
Toque em Iniciar (ou Start) para começar a conversar com ele.

Busca pelo @BotFather no Telegram com selo de verificado — Procure por **@BotFather** e confira o selo azul de verificado antes de abrir.

2 Crie um novo bot

Um comando e duas escolhas: nome e nome de usuário.

Envie o comando /newbot.
Escolha o nome de exibição — é o que o cliente vê no topo da conversa (ex.: Atendimento Sua Empresa). Pode ter espaços e acentos.
Escolha o nome de usuário (username). Ele precisa ser único e terminar em bot (ex.: suaempresa_bot).

Se o username já estiver em uso, o BotFather avisa e você tenta outro. Vale usar o nome da empresa + bot.

3 Copie o token do bot

O token é a "chave" que liga o bot ao Leadhit.

Assim que o bot é criado, o BotFather envia uma mensagem de parabéns com o link do bot (t.me/seu_bot) e um token de acesso à HTTP API. Copie esse token — é uma sequência parecida com 7644349743:AAH0...IKqIvg.

Mensagem do BotFather com o token de acesso destacado — O BotFather entrega o **token** logo abaixo de "Use this token to access the HTTP API". Toque nele para copiar.

Guarde o token com segurança. Quem tiver o token consegue controlar o seu bot. Não compartilhe com terceiros. Se vazar, gere um novo no BotFather com /token.

4 Adicione a conexão no Leadhit

Cole o token e pronto — o sistema faz o resto.

No Leadhit, abra Conexões.
Clique em Nova conexão (ou Adicionar conexão) e escolha Telegram.
Cole o token que você copiou do BotFather no campo indicado.
Clique em Salvar.

O que acontece ao salvar

O Leadhit valida o token com o Telegram, identifica o nome de usuário do bot e registra o webhook automaticamente. Você não precisa configurar mais nada — a conexão fica como conectada.

Não achou a opção Telegram na lista? Ela depende do seu plano. Fale com o suporte para liberar.

5 Teste a conexão

Uma mensagem de ida e volta confirma que está tudo certo.

Abra o seu bot

Use o link t.me/seu_bot ou procure pelo username no Telegram.

Toque em Iniciar e mande uma mensagem

Ex.: "Olá". No Telegram, o cliente precisa iniciar o bot antes de conversar.

A conversa aparece no Inbox

Responda por ali normalmente. Pronto: o canal está funcionando.

Importante: o bot só recebe mensagens que forem enviadas para ele. Ele não consegue iniciar conversa com quem nunca falou com o bot — o cliente precisa dar o primeiro "oi". Divulgue o link t.me/seu_bot para os clientes.

Ajustes do bot (opcional)

Deixe o bot com a cara da sua empresa. Nada aqui é obrigatório para funcionar.

Ainda no @BotFather, você pode personalizar o bot a qualquer momento. Envie /mybots, escolha o seu bot e use Edit Bot / Bot Settings:

Foto	Comando `/setuserpic` — coloca o logo da empresa como avatar do bot.
Descrição	`/setdescription` — o texto que aparece antes do cliente iniciar a conversa.
Sobre	`/setabouttext` — resumo curto exibido no perfil do bot.
Comandos	`/setcommands` — lista de atalhos que aparece no menu do bot.

Tela de configurações do bot no BotFather — As configurações do bot ficam em **Bot Settings**, dentro do BotFather.

Uma boa foto e uma descrição clara passam mais confiança para quem vai falar com a sua empresa.

Dúvidas frequentes

As perguntas que mais aparecem.

Preciso do celular conectado, como no WhatsApp?

Não. O Telegram funciona por token do bot, então não há aparelho para manter conectado nem QR Code para escanear. Uma vez salvo o token, o canal fica no ar.

Onde encontro o token de novo?

No @BotFather, envie /mybots, escolha o bot e toque em API Token. Para gerar um novo (e invalidar o antigo), use /token.

Posso usar o mesmo bot em dois sistemas ao mesmo tempo?

Não. O Telegram só entrega as mensagens para um webhook por vez. Se você conectar o mesmo token em outro sistema, ele "rouba" o webhook e o Leadhit para de receber. Use um bot para cada sistema.

O cliente não recebe minha mensagem. Por quê?

No Telegram, o bot só pode responder a quem já iniciou uma conversa com ele. Se a pessoa nunca falou com o bot, não é possível enviar a primeira mensagem. Divulgue o link t.me/seu_bot para que os clientes iniciem.

Não aparece a opção Telegram ao adicionar conexão.

A disponibilidade do canal Telegram depende do seu plano. Entre em contato com o suporte para liberar.

Dá para atender em grupos do Telegram?

O foco da conexão é o atendimento por conversa direta (DM) com o bot. Para uso em grupos, ajustes de privacidade do bot no BotFather podem ser necessários — comece pelo atendimento individual, que é o cenário padrão.