O Telegram é um serviço de mensagens instantâneas baseado em nuvem e desenvolvido pela Telegram Messenger LLP.
A integração com o Telegram, através de um Bot, permite que você responda as mensagens enviadas pelos seus clientes através da nossa plataforma.
Disponível a partir da versão 3.5.7
¶ Criando um bot no Telegram
Antes de configurar a integração no Orpen, é preciso criar um Bot no Telegram. Ele é o responsável por receber e encaminhar as mensagens para o Orpen.
Uma conta no Telegram pode criar até 20 bots
¶ Passo 1
Abra o seu aplicativo Telegram, clique em pesquisar contatos e procure pelo contato chamado BotFather (@botfather). Esse bot foi criado pelo time do Telegram e ele nos auxilia na criação e gerencimaneto de bots.
Atente para escolher o contato correto, com o símbolo de verificado
¶ Passo 2
Após clicar sobre o contato do @botfather, clique em Iniciar Conversa.
O @botfather, irá lhe enviar uma lista de comandos. Para criar um novo bot, escolha a opção /newbot
¶ Passo 3
Responda as perguntas feitas pelo @botfather, defina o nome do seu bot e o username.
Após a conclusão do processo, você vai receber a mensagem de sucesso juntamente com o token de autenticação do Bot.
Exemplo:
Done! Congratulations on your new bot. You will find it at t.me/orpen_devops_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you've finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this.
Use this token to access the HTTP API: {{ seu_token }}
Keep your token secure and store it safely, it can be used by anyone to control your bot.For a description of the Bot API, see this page: https://core.telegram.org/bots/api
Copie o token e não compartilhe-o com ninguém.
¶ Conectando o Bot Telegram ao Orpen
Para conectar o seu Bot Telegram ao Orpen, acesse o menu Contact Center > Integrações.
Na opção Telegram, clique em Configurar.
¶ Passo 1
Após acessar a página de integrações do Telegram, clique no botão Nova caixa do telegram
¶ Passo 2
No formulário de criação da Caixa do Telegram, informe um nome para a caixa, escolha o destino dos novos atendimentos (fila, bot ou agente) e cole o token do seu Bot Telegram que foi gerado anteriormente.
Após preencher os campos, clique em Salvar.
Uma mensagem de sucesso será apresentada e a caixa criada será apresentada na listagem de integrações.
¶ Passo 3
Por padrão, as caixas de Telegram são iniciadas desabilitadas.
Para iniciar o recebimeno de mensagens, clique sobre o botão Habilitar.
Enquando a caixa não for habilitada, as mensagens recebidas pelo bot não serão encaminhadas ao Orpen
¶ Limitações
A integração com o canal Telegram possui as seguintes limitações:
¶ Confirmação de recebimento, leitura e visualização
- O Telegram não informa sobre o status das mensagens enviadas, de modo que o Orpen não irá sinalizar se a mensagem foi entregue, recebida ou lida.
¶ Envio e recebimento de arquivos
- O tamanho máximo permitido, para envio de arquivos através da BotApi do Telegram, é de 50MB (documentação)
- O tamanho máximo permitido, para recebimento de arquivos através da BotApi do Telegram, é de 20MB (documentação)
Se o contato enviar um arquivo superior a 20MB, um alerta será apresentado ao Agente.
¶ Iniciar conversa a partir de um número de telefone
- O Telegram não permite iniciar uma conversa a partir de um número de telefone, nem enviar mensagens a um contato que nunca conversou com o Bot Telegram.
¶ Recursos ainda são suportados pelo Orpen
| Orpen | Recurso |
|---|---|
| ✅ | Envio de mensagens de texto |
| ✅ | Envio de imagens (até 50MB) |
| ✅ | Envio de áudios (até 50MB) |
| ✅ | Envio de vídeos (até 50MB) |
| ✅ | Envio de documentos (até 50MB) |
| ✅ | Recebimento de mensagens de texto |
| ✅ | Recebimento de imagens (até 20MB) |
| ✅ | Recebimento de áudios (até 20MB) |
| ✅ | Recebimento de vídeos (até 20MB) |
| ✅ | Recebimento de documentos (até 20MB) |
| ✅ | Recebimento de sticker (até 20MB) |
| ❌ | Recebimento de contatos |
| ❌ | Recebimento de localização |
| ❌ | Recebimento de pesquisa |
| ❌ | Responder mensagens recebidas |
| ❌ | Envio de localização |
| ❌ | Envio de contatos |
| ❌ | Chat em grupos |