Integração com o bot do Telegram

A integração com o bot do Telegram no Deskwoot permite gerenciar todas as conversas do Telegram na mesma caixa de entrada compartilhada dos seus outros canais, e a configuração leva cerca de 5 minutos pelo BotFather do Telegram. Isso significa que sua equipe de suporte pode atender mensagens do Telegram junto com os outros canais, sem ficar trocando de aplicativo. Abaixo, você encontra instruções passo a passo, dicas e respostas para dúvidas comuns.

Criando um bot no Telegram

Antes de conectar ao Deskwoot, você precisa criar um bot no Telegram usando o BotFather:

1. Abra o Telegram e procure por @BotFather.
2. Inicie uma conversa com o BotFather e envie o comando /newbot.
3. Siga as instruções para escolher um nome de exibição e um nome de usuário para o seu bot. O nome de usuário precisa terminar em bot (por exemplo, AcmeSupportBot).
4. Ao concluir, o BotFather responde com um token de API. Copie esse token. Você vai precisar dele no próximo passo.

Importante: mantenha o seu token de API em sigilo. Qualquer pessoa que tenha o token pode controlar o seu bot.

Conectando ao Deskwoot

1. No Deskwoot, acesse Configurações > Caixas de entrada > Adicionar caixa de entrada.
2. Selecione Telegram como o tipo de canal.
3. Cole o token de API do bot que você recebeu do BotFather.
4. Clique em Criar caixa de entrada do Telegram.

Seu bot do Telegram agora está vinculado ao Deskwoot. Todos os agentes que você atribuir a essa caixa de entrada poderão ver e responder às mensagens recebidas pelo Telegram.

Como funciona

Quando um usuário do Telegram envia uma mensagem para o seu bot, ela aparece como uma nova conversa no Deskwoot. Seus agentes respondem direto da caixa de entrada do Deskwoot, e a resposta é entregue de volta ao usuário pelo Telegram em tempo real. As conversas ficam organizadas por contato, então sua equipe sempre tem o contexto completo.

Solução de problemas

• Mensagens não aparecem no Deskwoot: Confira novamente se você colou o token de API correto. Se você gerou um novo token no BotFather depois de conectar, vai precisar atualizá-lo também no Deskwoot.
• Bot não responde: Verifique se pelo menos um agente está atribuído à caixa de entrada do Telegram. Caixas de entrada sem agentes atribuídos podem não rotear as conversas corretamente.
• Erro "Token already in use": Um token de bot do Telegram só pode estar conectado a um webhook por vez. Se o bot estiver vinculado a outro serviço, desconecte-o de lá antes de adicioná-lo ao Deskwoot.

Boas práticas

• Dê ao seu bot um nome claro e alinhado à marca, para que os clientes o reconheçam de imediato.
• Defina uma descrição e uma foto de perfil para o bot no BotFather usando os comandos /setdescription e /setuserpic, deixando a experiência mais profissional.
• Use os recursos de etiquetas e atribuição do Deskwoot para organizar as conversas do Telegram junto com os seus outros canais de suporte.

Perguntas frequentes

Posso conectar mais de um bot do Telegram?

Sim. Você pode adicionar várias caixas de entrada do Telegram no Deskwoot, cada uma vinculada a um token de bot diferente. Isso é útil se você gerencia marcas ou linhas de produtos separadas.

As conversas existentes do Telegram aparecerão no Deskwoot?

Não. Somente as novas mensagens enviadas ao bot depois de a integração ser configurada aparecerão na sua caixa de entrada do Deskwoot. O histórico de conversas anterior no Telegram não é importado.

Quais tipos de mensagem são suportados?

Mensagens de texto têm suporte completo. Anexos como imagens e arquivos enviados pelos usuários do Telegram também aparecem na conversa, permitindo que seus agentes os visualizem e respondam de acordo.