Telegram Message
Telegram Message hace que tu bot de Telegram actúe dentro de un chat: enviar un texto, una foto, un audio, un vídeo, una animación, un documento, un contacto o una encuesta, y también borrar, fijar o desfijar un mensaje.
Lo más habitual es usarlo para contestar: un Telegram Webhook pone en marcha el flujo cuando alguien escribe al bot, un agente prepara la respuesta y Telegram Message la envía al mismo chat.
Cuándo usarlo
- Responder a los clientes que escriben a tu bot de atención al cliente.
- Enviar a un grupo de Telegram el informe en PDF que ha generado el flujo.
- Avisar a tu equipo de un pedido urgente o de una incidencia.
- Lanzar una encuesta rápida en un grupo para decidir una fecha.
Configuración
Este componente necesita la credencial del servicio Telegram bot API. En el campo Credential (obligatorio), elige una con Seleccionar una credencial o crea una nueva con Crear nueva credencial. Ver Credenciales.
| Campo | Qué hace |
|---|---|
| Credential (obligatorio) | La credencial de tu bot de Telegram. |
| Mode | Basic envía al chat del que llegó el mensaje que puso en marcha el flujo, sin que tengas que indicarlo. Advanced muestra el campo Chat ID y algunas opciones más. Por defecto: Basic. |
| Action | Lo que hace el bot: Send Text, Send Photo, Send Audio, Send Animation, Send Video, Send Document, Send Contact, Delete Message, Pin Message, Unpin Message o Send Poll. Por defecto: Send Text. Según la acción, el panel muestra solo los campos que necesita. |
Campos según la acción
| Campo | Cuándo aparece y qué hace |
|---|---|
| Text | En Send Text es el mensaje que se envía; se aplican *negrita* y _cursiva_, y si el texto no sigue el formato de Telegram se envía tal cual. En las acciones de archivos (foto, audio, vídeo, animación, documento) es el texto que acompaña al archivo. |
| Attachment | En las acciones de archivos. Conecta el archivo que quieres enviar, por ejemplo el que genera Pdf Writer, o la dirección web de un archivo. |
| Phone Number | En Send Contact. El teléfono del contacto en formato internacional, por ejemplo +34600000000. |
| First Name | En Send Contact. El nombre del contacto. |
| Question | En Send Poll. La pregunta de la encuesta. |
| Options | En Send Poll. Las respuestas posibles; añade al menos dos. |
| Message ID | En Delete Message, Pin Message y Unpin Message. El número del mensaje que quieres borrar, fijar o desfijar. |
Modo Advanced
Con Mode en Advanced aparecen estos campos:
| Campo | Qué hace |
|---|---|
| Chat ID | El número del chat de Telegram al que se envía. Necesario en este modo. |
| Message ID | En las acciones de envío, el número del mensaje al que quieres responder. Déjalo vacío para enviar un mensaje normal. |
| Last Name | En Send Contact. El apellido del contacto. Opcional. |
| VCard | En Send Contact. Datos adicionales del contacto en formato vCard. Opcional. |
| Multiple Answers | En Send Poll. Permite elegir varias respuestas. Por defecto: desactivado. |
| Is Anonymus | En Send Poll. Oculta quién ha votado cada opción. Por defecto: desactivado. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Session ID | Identifica la conversación. Déjalo vacío: la plataforma usa la conversación en curso y el texto enviado se guarda en su historial. |
Procesamiento por lotes
Con el interruptor Batch Mode activado, el componente se ejecuta una vez por cada elemento de la lista que conectes en Batch Input y devuelve todos los resultados juntos en una lista. Parallel Executions indica cuántos elementos se procesan a la vez (de 1 a 5). Skip if Empty Batch Input salta el componente si la lista llega vacía, y Skip Branch if Empty Output detiene los componentes siguientes si el resultado está vacío. Más información en Conceptos clave.
Uso como herramienta de un agente
Puedes conectar este componente a la entrada Tools de un agente. En la pestaña Tool, Tool Name y Tool Description son el nombre y la explicación con los que el agente reconoce la herramienta y decide cuándo usarla: escribe una descripción clara de lo que hace.
Resultado
Telegram Response entrega el resultado de la acción: si ha ido bien, la acción realizada, el chat, el número del mensaje enviado y la fecha. Ese número te sirve, por ejemplo, para fijar el mensaje después con Pin Message.
Ejemplo
Una academia atiende por Telegram las dudas de sus alumnos:
- Telegram Webhook recibe la pregunta de un alumno.
- Un agente busca la respuesta en el calendario de cursos.
- Telegram Message, con Mode en Basic y Action en Send Text, recibe la respuesta del agente en Text y la envía al chat del alumno.
Buenas prácticas
- En los flujos que responden a quien escribe al bot, deja Mode en Basic: el mensaje vuelve siempre al chat correcto.
- Usa Advanced cuando el destino sea fijo, por ejemplo el grupo de tu equipo, e indica su Chat ID.
Componentes relacionados
- Telegram Webhook: pone en marcha el flujo con los mensajes que recibe tu bot.
- Pdf Writer y Docx Writer: generan archivos para enviar como adjunto.