La integración de Telegram de Dialogflow te permite crear fácilmente bots de Telegram con comprensión del lenguaje natural basada en la tecnología de Dialogflow.
Limitaciones
Esta integración solo admite el idioma predeterminado del agente.
Configurar Telegram
Para configurar la integración de Telegram en tu agente, necesitas lo siguiente:
- Una cuenta de Telegram.
Crear un bot en Telegram
- Inicia sesión en Telegram y ve a https://telegram.me/botfather.
- Haz clic en el botón Iniciar de la interfaz web o escribe /start.
- Haz clic en /newbot o escribe ese comando y ponle un nombre.
- Escribe un nombre de usuario para el bot que termine en "bot" (por ejemplo, garthsweatherbot).
- Copia el token de acceso generado.
Configurar Dialogflow
- En Dialogflow, vaya a Integraciones en el menú de la izquierda.
- Haz clic en la baldosa Telegram.
- Pega el token de acceso en el campo correspondiente.
- Haz clic en el botón Empezar.
Pruebas
BotFather te proporcionará un enlace a tu bot cuando hayas completado la configuración. Ve a
este enlace para probar tu agente.
Regenerando el token de Telegram
Para volver a generar el token de Telegram de un agente con la integración de Telegram habilitada, sigue estos pasos:
- Ve a los ajustes de integración de Dialogflow y haz clic en DETENER.
- Vuelve a generar el token en Telegram.
- Introduce el nuevo token de Telegram en los ajustes de la integración y haz clic en INICIAR.
Integrar un agente con un nuevo bot de Telegram
Si quieres vincular un agente con la integración de Telegram habilitada a un nuevo bot de Telegram, sigue estos pasos:
- Ve a los ajustes de integración de Dialogflow y haz clic en DETENER.
- Elimina el bot antiguo en Telegram si es necesario.
- Introduce el nuevo token de Telegram en los ajustes de la integración y haz clic en INICIAR.
Eventos
Esta integración activa los siguientes eventos:
| Evento | Descripción |
|---|---|
TELEGRAM_WELCOME |
Se activa cuando un usuario inicia una conversación con tu bot de Telegram o escribe /start. |
TELEGRAM_HELP |
Se activa cuando un usuario introduce /help mientras conversa con tu bot de Telegram. |
TELEGRAM_SETTINGS |
Se activa cuando un usuario introduce /settings mientras conversa con tu bot de Telegram. |
Mensajes de respuesta enriquecidos
Se admiten los siguientes mensajes de respuesta enriquecida.
Respuestas con imágenes
Formatos y tamaños admitidos:
- Tamaño máximo de 5 MB
Respuestas de tarjeta
Es obligatorio rellenar el campo de URL de la imagen o el campo de título.
Se admiten los botones con una URL y con una retrollamada de texto. Al tocar un botón con una URL, se abrirá una página web, mientras que, si el botón tiene texto, se enviará el texto como consulta de usuario.
Respuestas rápidas
Las respuestas rápidas de las integraciones de Telegram con un solo clic se corresponden con los botones del teclado de Telegram.
Cuando un usuario hace clic en uno de los botones, estos se cierran. De esta forma, se evita que los usuarios puedan hacer clic en botones adjuntos a mensajes antiguos de una conversación.
Respuestas de carga útil personalizadas
Texto formateado e hiperenlaces en la integración de Telegram con un solo clic
Tus bots de Telegram pueden enviar texto formateado e hiperenlaces.
En el siguiente ejemplo se envía texto con formato y un hiperenlace mediante el modo de análisis de Markdown:
{ "telegram": { "text": "You can read about *entities* [here](/docs/concept-entities).", "parse_mode": "Markdown" } }
Consulta la documentación de Telegram.
Botones de teclado insertados
En el siguiente ejemplo se muestra cómo puedes definir botones de teclado insertado en el elemento de carga útil personalizada.
{
"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"
}
]
]
}
}
}