A integração do Telegram do Dialogflow permite-lhe criar facilmente bots do Telegram com compreensão de linguagem natural baseada na tecnologia Dialogflow.
Limitações
Apenas o idioma do agente predefinido é suportado por esta integração.
Configurar o Telegram
Para configurar a integração do Telegram para o seu agente, precisa do seguinte:
- Uma conta do Telegram.
Criar um bot no Telegram
- Inicie sessão no Telegram e aceda a https://telegram.me/botfather
- Clique no botão Iniciar na interface Web ou escreva /start
- Clique ou escreva /newbot e introduza um nome
- Introduza um nome de utilizador para o bot que termine em "bot" (por exemplo, garthsweatherbot)
- Copie o token de acesso gerado
Configurar o Dialogflow
- No Dialogflow, aceda a Integrações no menu do lado esquerdo
- Clique no mosaico Telegram
- Cole o token de acesso no campo relacionado
- Clique no botão Iniciar
Testes
O BotFather fornece um link para o seu bot assim que concluir a configuração. Aceda a
este link para testar o seu agente.
Regenerar o token do Telegram
Para regenerar o token do Telegram de um agente com a integração do Telegram ativada, faça o seguinte:
- Aceda às definições de integração do Dialogflow e clique em PARAR.
- Volte a gerar o token no Telegram.
- Introduza o novo token do Telegram nas definições de integração e clique em INICIAR.
Integrar o agente com um novo bot do Telegram
Para um agente com a integração do Telegram ativada, para o associar a um novo bot do Telegram, faça o seguinte:
- Aceda às definições de integração do Dialogflow e clique em PARAR.
- Elimine o bot antigo no Telegram, se necessário.
- Introduza o novo token do Telegram nas definições de integração e clique em INICIAR.
Eventos
Os seguintes eventos são acionados por esta integração:
| Evento | Descrição |
|---|---|
TELEGRAM_WELCOME |
Acionado quando um utilizador inicia uma conversa com o seu bot do Telegram ou escreve /start. |
TELEGRAM_HELP |
Acionado quando um utilizador introduz /help enquanto conversa com o seu bot do Telegram. |
TELEGRAM_SETTINGS |
Acionado quando um utilizador introduz /settings enquanto conversa com o seu bot do Telegram. |
Mensagens de resposta avançadas
São suportadas as seguintes mensagens de resposta avançadas.
Respostas com imagens
Formatos e tamanhos suportados:
- Tamanho máximo de 5 MB
Respostas de cartões
O campo do URL da imagem ou o campo do título é obrigatório.
Os botões com um URL e com um postback de texto são suportados. Quando toca, um botão com um URL abre uma página Web, enquanto um botão com texto envia o texto como uma consulta do utilizador.
Respostas rápidas
As respostas rápidas nas integrações do Telegram com um clique correspondem a botões do teclado no Telegram.
Quando um utilizador clica num dos botões, os botões são ignorados. Isto evita o problema em que os utilizadores podiam clicar em botões anexados a mensagens antigas numa conversa.
Respostas de payload personalizadas
Texto formatado e hiperligações na integração do Telegram com um clique
Os seus bots do Telegram podem enviar texto formatado e hiperligações.
O exemplo seguinte envia texto formatado com uma hiperligação através do modo de análise Markdown:
{ "telegram": { "text": "You can read about *entities* [here](/docs/concept-entities).", "parse_mode": "Markdown" } }
Consulte a documentação do Telegram para referência.
Botões do teclado inline
O exemplo seguinte mostra como pode definir botões do teclado inline no elemento de payload personalizado.
{
"telegram": {
"text": "Pick a color",
"reply_markup": {
"inline_keyboard": [
[
{
"text": "Red",
"callback_data": "Red"
}
],
[
{
"text": "Green",
"callback_data": "Green"
}
],
[
{
"text": "Yellow",
"callback_data": "Yellow"
}
],
[
{
"text": "Blue",
"callback_data": "Blue"
}
],
[
{
"text": "Pink",
"callback_data": "Pink"
}
]
]
}
}
}