> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Desencadenantes de comunicación

> Desencadenantes que se activan en respuesta a correos electrónicos entrantes, el final de una reunión grabada por Odin o un mensaje de bot de Telegram.

Los desencadenantes de comunicación se activan en respuesta a correos electrónicos entrantes, la finalización de una reunión grabada por Odin o un mensaje recibido por un bot de Telegram.

## Correo electrónico

Sondea una bandeja de entrada de Gmail u Office 365 y activa el flujo de trabajo cuando se encuentra un correo electrónico que coincide. Puede filtrar por dirección del remitente, palabras clave en el asunto y estado de lectura. Los adjuntos se pueden incluir opcionalmente y pasar a los nodos posteriores.

**Cuándo usarlo**

* Desea que un flujo de trabajo reaccione automáticamente cuando llega un correo electrónico específico.
* Está construyendo un pipeline de correo-a-acción (por ejemplo, recibir una factura por correo → extraer datos → crear un registro en un CRM).
* Necesita procesar adjuntos de correo electrónicos programáticamente.

**Configuración**

<Tabs>
  <Tab title="Gmail">
    | Configuración                 | Tipo     | Descripción                                                                          |
    | ----------------------------- | -------- | ------------------------------------------------------------------------------------ |
    | `email_provider`              | Cadena   | Establece en `gmail`.                                                                |
    | `poll_interval`               | Entero   | Con qué frecuencia se verifica la bandeja de entrada, en segundos.                   |
    | `filters.unread_only`         | Booleano | Cuando es `true`, solo los correos no leídos activan el flujo de trabajo.            |
    | `filters.from_email`          | Cadena   | Solo se activa con correos de esta dirección de remitente.                           |
    | `filters.subject_contains`    | Cadena   | Solo se activa cuando el asunto contiene esta palabra clave o frase.                 |
    | `options.include_attachments` | Booleano | Cuando es `true`, los datos de adjuntos se incluyen en la salida del desencadenante. |

    <Note>
      Se debe configurar una conexión OAuth de Gmail en el proyecto antes de usar este desencadenante.
    </Note>
  </Tab>

  <Tab title="Office 365">
    | Configuración                 | Tipo     | Descripción                                                                          |
    | ----------------------------- | -------- | ------------------------------------------------------------------------------------ |
    | `email_provider`              | Cadena   | Establece en `office365`.                                                            |
    | `poll_interval`               | Entero   | Con qué frecuencia se verifica la bandeja de entrada, en segundos.                   |
    | `filters.unread_only`         | Booleano | Cuando es `true`, solo los correos no leídos activan el flujo de trabajo.            |
    | `filters.from_email`          | Cadena   | Solo se activa con correos de esta dirección de remitente.                           |
    | `filters.subject_contains`    | Cadena   | Solo se activa cuando el asunto contiene esta palabra clave o frase.                 |
    | `options.include_attachments` | Booleano | Cuando es `true`, los datos de adjuntos se incluyen en la salida del desencadenante. |

    <Note>
      Se debe configurar una conexión OAuth de Office 365 en el proyecto antes de usar este desencadenante.
    </Note>
  </Tab>
</Tabs>

**Variables de salida**

| Variable                    | Descripción                                                                                                                               |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `trigger.email.from`        | La dirección de correo electrónico del remitente.                                                                                         |
| `trigger.email.to`          | La dirección de correo electrónico del destinatario.                                                                                      |
| `trigger.email.subject`     | La línea de asunto del correo electrónico.                                                                                                |
| `trigger.email.body`        | El cuerpo en texto sin formato del correo electrónico.                                                                                    |
| `trigger.email.attachments` | Un array de objetos de adjuntos (nombre de archivo, tipo MIME, contenido). Solo se completa cuando `include_attachments` está habilitado. |
| `trigger.email.date`        | La marca de tiempo de cuándo se recibió el correo electrónico, en formato ISO 8601.                                                       |

<AccordionGroup>
  <Accordion title="Notas">
    * Los filtros son acumulativos. Si tanto `from_email` como `subject_contains` están establecidos, ambas condiciones deben cumplirse para que el desencadenante se active.
    * Establezca `unread_only` en `true` en flujos de trabajo de producción para evitar el reprocesamiento de correos que ya han sido procesados.
    * Use `trigger.email.attachments` con un nodo Bucle para procesar múltiples adjuntos de un solo correo electrónico.
  </Accordion>
</AccordionGroup>

## Fin de reunión de Odin

Se activa automáticamente cuando una reunión grabada por Odin termina y se generan notas o elementos de acción. Úselo para construir flujos de trabajo de automatización posteriores a la reunión — como distribuir resúmenes, crear tareas de seguimiento o registrar información de la reunión en un CRM o herramienta de gestión de proyectos.

**Cuándo usarlo**

* Desea procesar automáticamente las notas de la reunión o los elementos de acción tan pronto como termine la reunión.
* Está construyendo un pipeline posterior a la reunión (por ejemplo, la reunión termina → extraer elementos de acción → crear tareas en una herramienta de gestión de proyectos).
* Necesita registrar resúmenes de reuniones en una base de conocimiento o registro de CRM automáticamente.

**Configuración**

| Configuración             | Tipo     | Descripción                                                                                                               |
| ------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------- |
| `Tool Description`        | Cadena   | Una descripción de la herramienta que se muestra en la página de Herramientas.                                            |
| `Require Confirmation`    | Booleano | Cuando está habilitado, el usuario debe confirmar antes de que se ejecute el flujo de trabajo.                            |
| `Open Workflow Panel`     | Booleano | Cuando está habilitado, muestra el panel de vista previa del flujo de trabajo cuando este flujo se ejecuta desde el chat. |
| `API Key`                 | Cadena   | Su clave API de OdinAI para autenticación.                                                                                |
| `API Secret`              | Cadena   | Su secreto API de OdinAI para autenticación.                                                                              |
| `Project ID`              | Cadena   | Su ID de proyecto de OdinAI.                                                                                              |
| `Enable for all meetings` | Booleano | Cuando está habilitado, el desencadenante se activa sin importar qué reunión (de la que usted forma parte) termine.       |
| `Event Type`              | Cadena   | El evento de reunión que activa el desencadenante. El valor predeterminado es `Meeting Done`.                             |
| `Action Type`             | Cadena   | El tipo de datos a recibir cuando termina la reunión. Las opciones son `Notes` y `Action Items`.                          |

**Variables disponibles**

| Variable                    | Descripción                               |
| --------------------------- | ----------------------------------------- |
| `{{trigger.meeting.title}}` | El título de la reunión que terminó.      |
| `{{trigger.meeting.notes}}` | Las notas generadas por IA de la reunión. |

<AccordionGroup>
  <Accordion title="Notas">
    * Requiere credenciales de API de OdinAI (API Key, API Secret y Project ID) para autenticar.
    * Cuando **Enable for all meetings** está activado, el desencadenante se activa para cualquier reunión de la que usted forme parte. Desáctívelo para restringir la activación a reuniones específicas.
    * El **Action Type** determina si el desencadenante proporciona notas de la reunión o elementos de acción a los nodos posteriores.
    * Los datos de la reunión son accesibles a través de `{{trigger.meeting.title}}`, `{{trigger.meeting.notes}}` y otros campos en el payload de la reunión.
  </Accordion>
</AccordionGroup>

## Telegram: Nuevo mensaje

Se activa cuando el bot de Telegram recibe un nuevo mensaje. El desencadenante usa un webhook al que Telegram envía actualizaciones por POST, iniciando el flujo de trabajo cada vez que se recibe un mensaje.

**Cuándo usarlo**

* Desea construir un bot de Telegram que responda a mensajes de usuarios con un flujo de trabajo automatizado.
* Está enrutando mensajes entrantes de Telegram a un agente de IA o pipeline de procesamiento.
* Necesita capturar y actuar sobre mensajes enviados a su bot de Telegram en tiempo real.

**Configuración**

| Configuración          | Tipo     | Descripción                                                                                                                      |
| ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `Tool Description`     | Cadena   | Una descripción de la herramienta que se muestra en la página de Herramientas.                                                   |
| `Require Confirmation` | Booleano | Cuando está habilitado, el usuario debe confirmar antes de que se ejecute el flujo de trabajo.                                   |
| `Open Workflow Panel`  | Booleano | Cuando está habilitado, muestra el panel de vista previa del flujo de trabajo cuando este flujo se ejecuta desde el chat.        |
| `Allowed HTTP Method`  | Cadena   | El método HTTP aceptado por el webhook. El valor predeterminado es `POST`.                                                       |
| `Authentication`       | Cadena   | Método de autenticación para solicitudes webhook entrantes. El valor predeterminado es `None`.                                   |
| `Response Mode`        | Cadena   | Cómo responde el webhook a las solicitudes entrantes. **Responder inmediatamente** devuelve una respuesta `200 OK` de inmediato. |

**Configurar el webhook**

<Steps>
  <Step title="Publique la herramienta">
    Publique el flujo de trabajo para activar el endpoint del webhook y generar la URL en vivo.
  </Step>

  <Step title="Registre el webhook con Telegram">
    Copie la **URL en vivo** y regístrela con su bot de Telegram usando la herramienta `telegram_set_webhook` o el siguiente comando curl:

    ```bash theme={null}
    curl -X POST "https://api.telegram.org/bot<TOKEN>/setWebhook" \
      -H "Content-Type: application/json" \
      -d '{"url":"<WEBHOOK_URL>","allowed_updates":["message"]}'
    ```
  </Step>

  <Step title="Envíe un mensaje a su bot">
    Envíe un mensaje a su bot de Telegram. Telegram enviará la actualización a la URL del webhook e iniciará el flujo de trabajo.
  </Step>
</Steps>

**Capturar datos de ejemplo (opcional)**

Para guardar un payload real para ejecuciones de prueba sin ejecutar el flujo de trabajo, envíe el siguiente comando a su bot:

```
/generate_test_message Hola mundo
```

Haga clic en **Actualizar** para cargar el payload capturado.

**Variables disponibles**

| Variable                           | Descripción                                                        |
| ---------------------------------- | ------------------------------------------------------------------ |
| `{{trigger.body}}`                 | Cuerpo de la solicitud (analizado como JSON).                      |
| `{{trigger.headers}}`              | Encabezados de la solicitud.                                       |
| `{{trigger.query}}`                | Parámetros de consulta.                                            |
| `{{trigger.method}}`               | Método HTTP.                                                       |
| `{{trigger.body.message.text}}`    | El contenido de texto del mensaje entrante de Telegram.            |
| `{{trigger.body.message.chat.id}}` | El ID del chat de la conversación desde donde se envió el mensaje. |

<AccordionGroup>
  <Accordion title="Notas">
    * La **URL de prueba** (`/test` agregada a la URL en vivo) genera datos de ejemplo sin ejecutar el flujo de trabajo.
    * Los datos del mensaje son accesibles a través de `{{trigger.body.message.text}}`, `{{trigger.body.message.chat.id}}` y otros campos en el payload de actualización de Telegram.
    * Los servicios externos envían solicitudes HTTP a su URL de webhook; cada solicitud activa una nueva ejecución del flujo de trabajo.
    * Publique la herramienta para activar el endpoint del webhook antes de registrarla con Telegram.
  </Accordion>
</AccordionGroup>