Telegram
Telegram es un mensajero que tiene una versión web, una versión de escritorio y una versión para dispositivos móviles. Tiene funcionalidad de chatbot integrada.
Conexión
Crear un bot en Telegram
En primer lugar, necesitas hacer una configuración en el lado de Telegram.
Abre Telegram e inicia sesión.
Busca el bot "BotFather".
Crear un Bot en Telegram:
Envía el comando /newbot al BotFather Bot.
En respuesta al mensaje del Bot, introduzca el nombre deseado para su Bot.
c. Introduce tu ID de Bot deseado. Debe ser único entre todos los Bots existentes en Telegram y terminar con "bot". Por ejemplo, Mi_nuevo_telegram_bot_nombre_usuario_bot.
d. Si el ID de bot enviado cumple los requisitos, recibirá un mensaje de creación de bot correcta. El mensaje contendrá un enlace a tu Bot en Telegram y un token de acceso al Bot.
e. Copie el token de acceso en un lugar conveniente.
f. Puedes configurar el avatar, la descripción y otros parámetros del bot a través del BotFather Bot.
Esto completa la configuración del Bot en Telegram.
Configuración del canal del proyecto en la plataforma
Necesitas crear y configurar un Canal de Proyecto con el conector de Telegram.
Vaya a la pestaña Canales del proyecto.
Pulse el botón Crear canal.
Se abrirá el panel de selección de canal final.
Selecciona Telegram.
Se abrirá el panel de creación del Canal Proyecto.
Opcionalmente, introduzca un título para este Canal de Proyectos en el campo Nombre con el marcador de posición New channel.
7. Pega el token copiado previamente en el campo del token del bot de Telegram.
8. Opcionalmente, active la recepción de mensajes de servicio conmutando el interruptor basculante.
Para guardar el Canal Proyecto sin activarlo, pulse el botón CREAR.
Para guardar y activar el Canal Proyecto, haga clic en el botón CREAR Y ACTIVAR.
a. El Canal Proyecto se guardará y activará si:
i. Se publica el proyecto;
ii. El token en el campo token del bot de Telegram es único (no hay canales activos del mismo tipo con el mismo token);
iii. La dirección del canal es accesible;
iv. El webhook del canal se ha registrado correctamente.
b. El Canal Proyecto se guardará pero no se activará si no se cumplen una o varias condiciones.
Para cancelar la creación del Canal del Proyecto, pulse el botón CANCELAR.
Editar y eliminar el canal del proyecto
Para editar un Canal de Proyectos, haga clic en su ficha en la lista de Canales de Proyectos.
Para editar cualquier campo, haga clic en él e introduzca un nuevo valor.
Para aplicar los cambios a un Canal Proyecto activado, pulse el botón APLICAR.
a. Los cambios se aplicarán si:
i. Se publica el proyecto;
ii. El token en el campo token del bot de Telegram es único (no hay canales activos del mismo tipo con el mismo token);
iii. La dirección del canal es accesible;
iv. El webhook del canal se ha registrado correctamente.
b. Los cambios no se aplicarán si no se cumplen una o varias condiciones.
Para desactivar el Canal Proyecto, pulse el botón DESACTIVAR.
Para aplicar los cambios a un Canal Proyecto no activado, pulse el botón GUARDAR.
Para aplicar los cambios y activar el Canal Proyecto, pulse el botón GUARDAR Y ACTIVAR.
a. Los cambios se aplicarán y el Canal Proyecto se activará si:
i. Se publica el proyecto;
ii. El token en el campo token del bot de Telegram es único (no hay canales activos del mismo tipo con el mismo token);
iii. La dirección del canal es accesible;
iv. Se puede registrar el webhook del canal.
b. Los cambios se aplicarán pero el Canal Proyecto no se activará si no se cumplen una o varias condiciones.
Para cancelar los cambios, pulse el botón CANCELAR.
Para eliminar el Canal Proyecto, pulse el botón ELIMINAR.
Comunicación
Comunicación en los chats de grupo de Telegram
El Bot puede añadirse a un chat de grupo de Telegram y procesar mensajes y eventos de este chat.
Para que el Bot pueda procesar todos los mensajes enviados al grupo, debes darle acceso a todos los mensajes desactivando la opción Privacidad del grupo:
Ir a BotFather;
Escribe el comando /mybots;
Selecciona el Bot deseado;
Ve a Configuración del bot → Privacidad del grupo;
Seleccione Apagar.
Cuando la configuración de Privacidad de Grupo está activada, para enviar un mensaje que será procesado por el Agente y registrado en client_message, debe responder al mensaje del Bot (reply) o escribir su propio mensaje después del símbolo /.
Después de cada mensaje procesado, las Variables de Canal se ajustarán a los datos del miembro del grupo que envió el mensaje.
Además, el Agente procesa eventos sobre nuevos usuarios que se añaden al chat de grupo. En este caso, una cadena como "telegram_chat_new_member: telegram_user_id|telegram_username|telegram_first_name|telegram_last_name" se escribirá en la variable client_message.
Cuando se actualiza un grupo a supergrupo, se genera un nuevo ID de grupo y el Agente no puede enviar un mensaje.
Mensajes de servicio en telegrama
El usuario del grupo de Telegram se ha unido al grupo
Cadena: telegram_chat_new_member: {user.id}|{user.first_name}|{user.last_name}
Cuando un usuario se une a un grupo de Telegram, se envía un mensaje a la variable de contexto client_message de acuerdo con la plantilla
Cuando un nuevo usuario se une a un grupo, el Bot puede darle la bienvenida a la conversación mostrando su nombre. Por ejemplo, puede añadir una Rama de Script donde el Agente responderá a este mensaje y mostrará el texto "¡Hola, {user.first_name}|{user.last_name}! Bienvenido al grupo!"
Un usuario del grupo de Telegram ha abandonado el grupo
Cadena: telegram_member_left_chat: {user.id}|{user.first_name}|{user.last_name}
Cuando un usuario abandona un grupo de Telegram, se envía un mensaje a la variable de contexto client_message de acuerdo con la plantilla
Cuando un usuario abandona un grupo, el Bot puede mostrar un mensaje al respecto. Por ejemplo, puede añadir una Rama de Script donde el Agente responderá a este mensaje y mostrará el texto "Desafortunadamente, {user.first_name}|{user.last_name} ha abandonado el grupo".
Sobre qué son los mensajes de servicio y cómo activar su transmisión desde el Canal Fin: Despliegue del proyecto a los canales
Asignación de variables de canal a partir del telegrama
id
Al responder a un mensaje bot en un chat de grupo, el identificador del usuario que responde se escribe en la variable
Si el Mensaje del Usuario Bot no es una respuesta al mensaje del Bot en Telegram, la variable permanece vacía
Comunicación en telegrama
Transferencia de archivos como enlaces desde el Agente
Sí
El archivo se transferirá por enlace si no cumple los requisitos de Telegram para archivos de este tipo.
Transferencia de archivos como archivos del Agente
Sí
Telegram puede aceptar y enviar "archivos" adjuntos a Usuarios Bot sólo en formatos gif, pdf y zip. El soporte para otros formatos es posible, pero Telegram no lo garantiza.
Recepción de un archivo del Usuario Bot en un script
Sí
Se escribe una cadena en client_message: file:File type|File ID|File link, por ejemplo, file:photo|HgYjJJGYuxkBAAMNYK1eZR1fbZv-KQ09Omcsz9A8AjwAAsSzMRtug3FJ079jiwXcvo-egdKiLgADAQADAgADeAADE7gCAAEfBA|https://api.telegram.org/ file/bot1815753186:AAH_LtRWy_FSDAGFgstlTaQdkHHIFHV3xGI/photos/file_0.jpg . En este caso, el archivo estará disponible a través del enlace en un plazo de 24 horas. Para recibir el archivo en el futuro, tendrás que actualizar el enlace al archivo mediante la API de Telegram.
Recibir geolocalización de un usuario Bot en un script
Sí
El mensaje_cliente contiene una cadena como ubicación:Latitud|Longitud, por ejemplo, ubicación:83.000000|54.000000
Entrega de mensajes de más de 1000 caracteres del Agente al Usuario Bot
Sí
Se permiten mensajes de hasta 4096 caracteres
Last updated