# Disparadores

## Activador de flujo de trabajo <a href="#workflow-trigger" id="workflow-trigger"></a>

Un desencadenante es un evento que iniciará un flujo de trabajo. Cada flujo de trabajo debe comenzar con un disparador y tener solo un disparador. Todos los desencadenantes están definidos por condiciones. Un disparador solo disparará e iniciará un flujo de trabajo cuando se cumplan todas las condiciones.Aquí está la lista de activadores disponibles:<br>

| Disparadores                                                     | Descripción                                                                   |
| ---------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| ​[Conversación abierta](#trigger-conversation-opened)            | Se activa cuando se abre una conversación con el contacto.                    |
| [Conversación cerrada](#trigger-conversation-closed)             | Se activa cuando se cierra una conversación con el contacto.                  |
| [Etiqueta de contacto actualizada](#trigger-contact-tag-updated) | Se activa cuando se agrega o se elimina una etiqueta específica del contacto. |
| [Campo de contacto actualizado](#trigger-contact-field-updated)  | Se activa cuando el campo de contacto especificado se actualiza o cambia.     |
| [Atajo](#disparador-atajo)                                       | Se activa cuando se selecciona el acceso directo desde el módulo de mensajes. |

Una vez especificado el desencadenador, pase a configuración de [pasos](https://docs.okeybot.com/modulos-de-navegacion/flujos-de-trabajo/pasos). Elija cualquiera de los pasos disponibles.

### Ajustes avanzados <a href="#advanced-settings" id="advanced-settings"></a>

Para cada activador, hay un interruptor de configuración avanzada en la parte inferior que especifica el **activador una vez por contacto.** Esto impide que los contactos repitan este flujo de trabajo, por lo que solo pueden realizar el recorrido del flujo de trabajo una sola vez.

![](/files/SMf1iEJvSGz1XaBmLEq6)

Cuando la palanca está activada, el flujo de trabajo no se activará para ningún contacto que se haya inscrito en este flujo de trabajo antes, incluso si la condición estaba desactivada cuando sucedió.

#### **Configuración de disparador** <a href="#configuration-of-trigger" id="configuration-of-trigger"></a>

Cada flujo de trabajo debe comenzar con un activador y solo puede tener un activador único. Cuando se cumplen las condiciones para el disparador, el flujo de trabajo se llevará a cabo secuencialmente en el contacto disparador.

## Disparador(Trigger): conversación abierta <a href="#trigger-conversation-opened" id="trigger-conversation-opened"></a>

Para iniciar el flujo de trabajo cuando se abre una conversación con el contacto y se cumplen todas las condiciones de activación.

### Configuración <a href="#configuration" id="configuration"></a>

La condición de activación para este flujo de trabajo se limita a la fuente, que identifica cómo se abrió la conversación. Hay tres fuentes posibles aquí:

* Usuario: Abierto por el usuario
* Flujo de trabajo: abierto por un paso del flujo de trabajo
* Contacto: Abierto por el contacto

![](/files/q7pCkEJIdEorRECrvECX)

Para cada fuente, se permite un máximo de 10 condiciones con operadores lógicos AND u OR. Se requiere que cada condición tenga su propia fuente, un operador y un valor.

## Disparador(Trigger): conversación cerrada <a href="#trigger-conversation-closed" id="trigger-conversation-closed"></a>

Para iniciar el flujo de trabajo cuando se cierra una conversación con el contacto y se cumplen todas las condiciones de activación.

### Configuración <a href="#configuration-1" id="configuration-1"></a>

Hay dos posibles condiciones desencadenantes para las conversaciones cerradas: fuente, que identifica quién cerró la conversación, y categoría, que identifica la clasificación de la conversación.

Hay cuatro fuentes que activarán este flujo de trabajo si cierran una conversación:

* Usuario: cerrado por usuario
* Flujo de trabajo: cerrado por un paso del flujo de trabajo
* Bot: cerrado por un bot
* Combinación de contactos: cerrada debido a una combinación de contactos

{% hint style="info" %}
La conversación cerrada por la fusión de contactos NO activará un flujo de trabajo.
{% endhint %}

![](/files/RDVT1eQ0sJslOMdc269h)

Este flujo de trabajo también se activará si se cierran las conversaciones relacionadas con categorías especificadas. Estas categorías se determinan en la sección Notas de cierre de la plataforma. En Flujos de trabajo, aparecerán como opciones en el menú desplegable de valores.

Para cada Fuente y Categoría, se permite un máximo de 10 condiciones con operadores lógicos AND u OR. Se requiere que cada condición tenga su propia fuente, un operador y un valor.

## Disparador (Trigger): etiqueta de contacto actualizada <a href="#trigger-contact-tag-updated" id="trigger-contact-tag-updated"></a>

Para iniciar el flujo de trabajo cuando se agregan o eliminan etiquetas específicas de un contacto.

### Configuración <a href="#configuration-2" id="configuration-2"></a>

Para configurar este flujo de trabajo, seleccione una acción que se agregará como desencadenante. Las opciones son cuando se agrega una etiqueta a un contacto o cuando se elimina una etiqueta del contacto.

A continuación, seleccione las etiquetas que serán las condiciones que se cumplirán para el inicio del flujo de trabajo.

![](/files/g7AVNNJ9F1uclkA0koRc)

## Disparador: campo de contacto actualizado <a href="#trigger-contact-field-updated" id="trigger-contact-field-updated"></a>

Para iniciar el flujo de trabajo cuando se actualiza un campo de contacto específico.

### Configuración <a href="#configuration-3" id="configuration-3"></a>

Cualquier contacto o campo personalizado se puede configurar como desencadenante de este flujo de trabajo. Seleccione el campo de contacto que actuará como condición para este disparador. Cualquier actualización de este campo iniciará el flujo de trabajo.

![](/files/rZlRGzfESdmLl2Kru8Tm)

## Disparador: atajo <a href="#disparador-atajo" id="disparador-atajo"></a>

Inicia un flujo de trabajo seleccionado desde el menú contextual del módulo de mensajes.![](https://1810233666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-L8qsmIDw5_reabURkaE%2Fuploads%2FQy82sGeMCfX4qQdhGFKe%2FScreen%20Shot%202022-03-15%20at%209.48.18%20AM.png?alt=media\&token=71110789-eb2b-4797-8c69-602e7c8e9824)\ <br>

#### ¿Cómo funciona?

Atajo se refiere a un flujo de trabajo que se crea con el gatillo "acceso directo". Esta función permite a los usuarios iniciar flujos de trabajo que tienen acceso directo como disparador sin salir del módulo de mensajes.&#x20;

En el módulo de mensajes, haga clic en el icono de acceso directo en la barra de herramientas del editor de mensajes. Esto abrirá el menú de accesos directos, que muestra todos los accesos directos publicados en el espacio de trabajo. Seleccione el acceso directo deseado para iniciar su flujo de trabajo.&#x20;

El ícono de acceso directo se desactivará si no hay accesos directos creados y publicados en el espacio de trabajo.

{% hint style="danger" %}
Si no desea permitir que los agentes inicien accesos directos, desactívelos en la configuración de Restricciones avanzadas en configuración de [usuario del espacio de trabajo](broken://pages/-Lq2bmKz97BQGT773nYA#editing-users).
{% endhint %}

**Configuración**

Puede configurar atajos con iconos, nombres y descripciones individuales. Cuando se abra el menú de accesos directos, se mostrarán para que pueda identificar y seleccionar fácilmente el acceso directo deseado.

**Formulario de atajos**

En el cajón de configuración del disparador de atajos, puede optar por crear un formulario de acceso directo. Cada vez que se active el acceso directo, se abrirá el formulario. El flujo de trabajo solo se iniciará después de que el usuario haya rellenado el formulario.&#x20;

El formulario de acceso directo se puede personalizar con campos de formulario para introducir datos o comentarios. Los valores rellenados pueden guardarse como variables y utilizarse en el flujo de trabajo.&#x20;

Para agregar un campo de formulario:

1. Haz clic en el botón `+ Añadir campo de formulario.`
2. Nombre el campo del formulario. Por ejemplo, ID de Pedido, Motivo del Reembolso.
3. Seleccione el tipo de campo. Los tipos de campos disponibles son:
   * `Texto`
   * `Lista (desplegable)`
   * `Casilla`
   * `Número`
   * `Fecha`
   * `Hora`
   * `Número de teléfono`
   * `Email`
   * `URL`
4. Nombre de la variable para este campo.
5. Utilice las variables de salida en los pasos del flujo de trabajo. Obtenga más información sobre las variables de salida [aquí](broken://pages/-MEosDz_YDwmxBXTHpAb).

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bony.chat/modulos-de-navegacion/flujos-de-trabajo-workflow/disparadores.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
