GramDesk GramDesk
pt
Conectar

Guia de configuração

Como configurar um bot do Telegram para suporte ao cliente

O GramDesk transforma um bot comum do Telegram em uma caixa de entrada compartilhada de suporte. Clientes escrevem para seu bot, e sua equipe responde de um grupo privado no Telegram, onde cada cliente recebe um tópico separado. Não precisa de código: crie o bot no BotFather, conecte o token ao GramDesk, adicione o bot ao grupo e teste a primeira conversa.

Sem programação
Setup em minutos
Um cliente - um tópico
Equipe responde no Telegram

Precisa só de um botão no site? Abra o gerador de botão do Telegram.

1

@BotFather

/newbot → token

2

@GramDeskBot

Add bot → Connect group

3

Private Telegram group

Topics → team replies

O que você precisa para configurar

Você não precisa criar um CRM separado nem escrever integração. A configuração básica acontece dentro do Telegram: crie um bot, conecte ao GramDesk e adicione a um grupo privado de suporte.

Se você ainda está escolhendo o fluxo certo, veja exemplos para site, lojas online, freelancers, pequenas equipes.

Conta no Telegram

Para criar o bot e administrar o grupo

Bot do BotFather

Clientes escreverão nele para suporte

Token do bot

Necessário para conectar o bot ao GramDesk

Grupo privado

Sua equipe responderá clientes ali

Tópicos ativados

Cada cliente terá uma conversa separada

Configuração passo a passo do GramDesk

Este é o fluxo básico de lançamento. Depois dele, um cliente poderá escrever para seu bot do Telegram e a mensagem aparecerá no grupo de suporte como um tópico separado.

1

Passo 1. Crie um bot do Telegram com o BotFather

Abra o Telegram e procure @BotFather. Envie /newbot, escolha o nome e username do bot. O BotFather enviará um token. Guarde-o porque você precisará dele para conectar o bot ao GramDesk.

/newbot

Não publique o token. Com ele, um serviço obtém acesso ao seu bot.

2

Passo 2. Conecte o bot ao GramDesk

Abra @GramDeskBot, toque em Start e escolha Add bot. Cole o token recebido do BotFather. O GramDesk poderá receber mensagens do seu bot e vinculá-las a um grupo de suporte.

@GramDeskBotAbrir @GramDeskBot
3

Passo 3. Crie um grupo privado de suporte

Crie um grupo privado separado no Telegram para suporte ao cliente. Adicione colegas da equipe e seu bot. Evite usar o chat normal de trabalho para que conversas de clientes e mensagens internas não se misturem.

4

Passo 4. Ative tópicos no grupo

Abra as configurações do grupo e ative Topics. Esta é a camada principal do GramDesk: cada cliente recebe um tópico separado, então a equipe vê o histórico e não mistura conversas.

Group settings -> Topics -> Enable
5

Passo 5. Dê permissões de administrador ao bot

Adicione o bot como administrador do grupo e ative permissões necessárias para tópicos e mensagens. No mínimo, ele precisa gerenciar tópicos e enviar mensagens. Se o Telegram mostrar Manage topics, Delete messages e Pin messages, ative para operação estável.

Essas permissões servem para organizar conversas de suporte, não para controlar o chat da equipe.

6

Passo 6. Conecte o grupo no GramDesk

Volte para @GramDeskBot e escolha Connect group. Selecione o grupo de suporte que você criou. O GramDesk vinculará o bot do Telegram ao grupo, e novas mensagens de clientes aparecerão como tópicos separados.

Connect group
7

Passo 7. Teste a primeira conversa

Abra seu bot voltado ao cliente como um usuário comum e envie uma mensagem de teste. Um novo tópico deve aparecer no grupo. Responda dentro desse tópico: o usuário deve receber a resposta no chat com o bot.

Como o trabalho fica depois da configuração

1

Cliente escreve para o bot

Ele envia uma pergunta para seu bot de suporte.

2

GramDesk cria um tópico

Uma conversa separada aparece no grupo privado.

3

Equipe responde no Telegram

Qualquer colega pode responder dentro do tópico.

4

Cliente recebe a resposta

A resposta volta para o mesmo chat com o bot.

O cliente não vê as contas pessoais dos gestores. Para ele, a comunicação parece um chat normal com seu bot do Telegram, enquanto a equipe trabalha de um grupo privado.

Erros comuns na configuração

O bot está no grupo, mas mensagens não chegam

Confira se o bot foi conectado ao GramDesk com o token e se o grupo foi escolhido com Connect group. Verifique também se você está testando o bot do cliente, não o @GramDeskBot.

Tópicos não são criados

Confira se Topics estão ativados no grupo e se o bot tem permissão para gerenciar tópicos. Sem tópicos, o GramDesk não consegue separar clientes corretamente.

A equipe responde no grupo, mas o cliente não recebe

Responda dentro do tópico do cliente, não no chat geral do grupo. Confira também se o bot continua conectado e não foi removido.

Perdi o token do BotFather

Abra @BotFather, escolha o bot e gere um novo token. Depois atualize o token no GramDesk.

Pronto para conectar seu primeiro bot?

Crie um bot do Telegram, conecte ao GramDesk e teste a primeira conversa de cliente no grupo de suporte. A equipe responde pelo Telegram, e clientes escrevem para seu bot.

O que clientes podem enviar pelo bot

O fluxo básico serve para mais do que perguntas de texto. Clientes podem enviar arquivos, fotos, áudios e outros tipos de mensagens do Telegram quando o suporte precisa de contexto.

TextoFotosArquivosÁudiosVideo messagesStickers

FAQ

Preciso programar?

Não. Para a configuração básica, Telegram, BotFather e o bot de gestão do GramDesk são suficientes. Código só é necessário para integrações personalizadas.

Clientes verão meu Telegram pessoal?

Não. Clientes escrevem para seu bot do Telegram. A equipe responde de um grupo privado, então contas pessoais não precisam ser publicadas.

Posso adicionar vários colegas?

Sim. Adicione funcionários ao grupo privado de suporte. Eles poderão ver tópicos de clientes e responder sem cobrança por agente.

E se eu tiver vários projetos?

Você pode usar bots e grupos separados para projetos diferentes, ou montar o fluxo para a equipe entender de onde veio cada cliente. Nomes claros de bots e grupos ajudam muito.

Posso colocar o link do bot no site?

Sim. Depois da configuração, adicione um link ou botão do Telegram no site. Para uma opção simples, use o gerador de botão do Telegram.

Quanto custa o GramDesk?

Um bot ativo custa cerca de $0.10 por dia, aproximadamente $3 por mês. Colegas estão incluídos sem pagamento separado.