## Visión general

Además de conversar con el contacto, un flujo del **Flow Builder** puede **ejecutar acciones en la
plataforma** por el camino: etiquetar al contacto, registrar una nota, escribir un atributo, crear un
contacto, abrir una nueva conversación o dejar una nota privada. Esto se hace con **nodos de acción**.

El destacado es el nodo **Acción de contacto** (categoría Contactos): un nodo dedicado que expone
exactamente las acciones que operan sobre la ficha del contacto, con los campos correctos ya listos.
Para las demás acciones de la plataforma, el nodo genérico **Acción de ConversaLabs** (acción del
sistema) también puede ejecutarlas.

## Requisitos previos

- El módulo **Flow Builder** habilitado para la cuenta (recurso opcional por plan/flag).
- Permiso de **administrador** para crear y publicar flujos.
- Para la acción **crear conversación**, una **bandeja de entrada** de destino.
- Para condiciones/valores por **atributo personalizado del contacto**, los atributos definidos en la
  cuenta (se cargan automáticamente en los selectores del nodo).

## Paso a paso

Cómo añadir un nodo de **Acción de contacto** a un flujo:

1. Abre el flujo en el **Flow Builder**.
2. En el panel de nodos, localiza la categoría **Contactos** y arrastra el nodo **Acción de contacto**
   al lienzo.
3. Conéctalo al punto del flujo donde debe ocurrir la acción.
4. En el panel lateral, elige la acción (por ejemplo, **Añadir etiqueta al contacto**) y completa los
   campos. En los campos de atributo y valor, las opciones se **cargan automáticamente** — sin escribir
   texto libre.
5. Para **crear conversación**, selecciona la **bandeja de entrada** y, si quieres, el estado inicial y
   el mensaje inicial.
6. **Prueba** el flujo y **publícalo**.

## Configuración y opciones

Nodos/acciones nativos disponibles en los flujos:

| Nodo / acción | Qué hace |
| --- | --- |
| Nodo **Acción de contacto** | Ejecuta las acciones de contacto: añadir/quitar etiqueta, añadir nota y definir atributo personalizado. |
| Acción **Crear contacto** | Crea un contacto (nombre, correo, teléfono; bandeja opcional), con deduplicación nativa. |
| Acción **Crear conversación** | Abre una conversación en una bandeja, con estado y mensaje inicial opcionales. |
| Acción **Añadir nota privada** | Deja una nota privada en la conversación (ahora también disponible en los flujos). |
| Acción **Enviar/crear contrato** | Envía o crea un contrato a partir de una plantilla (requiere el módulo de Contratos). |
| Acción **Enviar un correo al equipo** | Notifica al equipo por correo durante el flujo. |
| Nodo **Acción de ConversaLabs** | Nodo genérico de acción del sistema; puede ejecutar las mismas acciones de contacto/creación. |

- **Selector con autocarga**: al configurar la acción, los atributos personalizados del contacto y sus
  valores aparecen automáticamente — seleccionas, no escribes.
- **Nota privada en los flujos**: añadir una nota privada, antes disponible solo en Automatizaciones y
  Macros, ahora también corre dentro de un flujo.
- **Acciones de contrato y correo al equipo**: enviar o crear un contrato a partir de una plantilla
  (requiere el módulo de Contratos) y enviar un correo al equipo ahora **se publican y ejecutan
  correctamente** dentro del nodo de acción. La acción **Añadir SLA** no está disponible en los flujos —
  úsala en Automatizaciones o Macros.

## Casos de uso

- **Etiquetar a mitad del flujo**: cuando el contacto elige una opción del menú, añadir la etiqueta
  correspondiente al contacto.
- **Escalar a otra bandeja**: crear una nueva conversación en una bandeja de soporte avanzado cuando el
  flujo detecta un caso complejo.
- **Registrar contexto**: escribir un atributo personalizado (por ejemplo, `interes = plan-anual`)
  durante la calificación.
- **Alertar al equipo**: dejar una nota privada con el resumen recopilado en el flujo, sin enviar nada
  al contacto.

## Consejos, límites y buenas prácticas

- **Seguridad contra bucles**: las acciones de contacto respetan protecciones contra bucles — diseña el
  flujo para no disparar actualizaciones en cadena.
- **Crear contacto deduplica**: la misma persona (correo/teléfono/identificador) se reutiliza, sin
  generar duplicados.
- **Crear conversación exige bandeja**: sin una bandeja de entrada seleccionada, la acción no se ejecuta.
- **Solo el administrador configura**: las acciones nativas requieren permiso de administrador para
  montarse en el flujo.
- Prefiere el nodo **Acción de contacto** cuando solo necesites tocar la ficha — ya trae los campos
  correctos.

## Solución de problemas

- **No encuentro el nodo de Acción de contacto**: confirma que el Flow Builder esté habilitado y que
  tengas rol de administrador.
- **La acción no se ejecutó en el flujo**: revisa que el nodo esté conectado al camino correcto y que
  los campos obligatorios estén completos.
- **Crear conversación falló**: confirma que se seleccionó una **bandeja de entrada** en el nodo.
- **El valor de la condición/atributo no aparece**: los valores se cargan de los datos de la cuenta —
  confirma que el atributo exista y tenga valores registrados.
- **Una acción muestra un valor bloqueado, solo un número**: el nodo apunta a un registro de un módulo
  que está desactivado en la cuenta o al que tu perfil no tiene acceso (por ejemplo, una distribución
  o una plantilla de contrato). También puede significar que la lista aún no cargó, que la consulta
  falló o que la lista de tu perfil de acceso no incluye el registro (puede estar fuera de tu alcance
  o haber sido eliminado). La ayuda explica la causa. La referencia queda sin cambios cuando el flujo
  puede guardarse; si la consulta falló, recarga la página para reintentar. Si el acceso está
  restringido, pide ayuda a quien tenga acceso o vuelve a activar el módulo.
- **La acción entera aparece bloqueada, con el aviso de que no está disponible en este nodo**: el
  módulo de la acción está desactivado en la cuenta, o la acción no pertenece a este tipo de nodo. El
  nodo sigue exactamente como se guardó (abrir el panel no cambia la acción) hasta que elijas otra
  acción en el selector. Una acción no disponible impide probar y publicar el flujo. Si el propio
  nodo pertenece a un módulo desactivado, también se rechaza guardar el borrador; conservar los
  valores guardados no anula esa regla.
- **Un campo muestra un número en lugar del nombre**: el registro guardado no está en la parte de la
  lista que cargó la pantalla (las listas largas llegan por páginas), o el registro puede haber sido
  eliminado. Cuando una consulta confirma la eliminación, el campo lo identifica como eliminado. El
  valor guardado se mantiene; elige otro elemento solo si quieres cambiarlo. Guardar cambios no
  relacionados no reemplaza esa referencia silenciosamente.

## Ver también

- [Flow Builder: flujos conversacionales visuales](/hc/ajuda/articles/automation-flows-flow-builder-es)
- [Automatizaciones de contacto: disparadores y acciones en la ficha](/hc/ajuda/articles/automation-flows-automacoes-de-contato-es)
- [Macros: acciones reutilizables en un clic](/hc/ajuda/articles/automation-flows-macros-es)