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

# Acciones del agente

> Cómo configurar Lead Form, Human Handoff, WooCommerce y otras acciones que tu agente puede ejecutar durante una conversación.

# Acciones del agente

Las acciones le dan a tu agente capacidades extra durante una conversación: capturar datos de contacto, transferir a un humano, o consultar información en sistemas externos como tu tienda online. Cada acción se configura de forma independiente y se puede activar o desactivar sin afectar al resto.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/chatnorris/images/PLACEHOLDER-acciones-lista.png" alt="TODO: captura de la lista de acciones de un agente, con Lead Form y Human Handoff activadas" />
</Frame>

## Dónde encontrarlas

Entra al detalle de un agente y hacé clic en la pestaña **Acciones** (`Chatbots → [tu agente] → Acciones`).

## Acciones disponibles

<CardGroup cols={2}>
  <Card title="Lead Form" icon="clipboard-list">
    Muestra un formulario para capturar los datos de contacto del visitante durante la conversación.
  </Card>

  <Card title="Human Handoff" icon="headset">
    Transfiere la conversación a un agente humano cuando el bot lo considera necesario.
  </Card>

  <Card title="WooCommerce" icon="cart-shopping">
    Permite consultar órdenes verificadas, inventario por SKU y datos del cliente desde tu tienda WooCommerce.
  </Card>
</CardGroup>

<Note>
  También vas a ver **Custom Form, Buttons, HTTP Request, Cal.com y Send Email** listadas como "Próximamente" — están planificadas pero todavía no tienen lógica funcional. Cuando estén disponibles, esta guía se actualiza con sus pasos.
</Note>

## Activar una acción

<Steps>
  <Step title="Ve a Acciones y hacé clic en Nueva acción">
    Se abre un selector con todas las acciones disponibles. Las que dicen "Próximamente" están deshabilitadas.
  </Step>

  <Step title="Elegí el tipo de acción">
    Te lleva directo a la pantalla de configuración de esa acción.
  </Step>

  <Step title="Configurá los detalles y activá el toggle Enabled">
    Cada acción tiene sus propios campos (ver abajo). El toggle **Enabled** en la parte superior controla si el agente puede usarla ahora mismo.
  </Step>

  <Step title="Guardá los cambios">
    Los cambios se aplican de inmediato a las conversaciones nuevas.
  </Step>
</Steps>

## Lead Form

Formulario para capturar nombre, email, teléfono u otros datos que definas, sin sacar al visitante de la conversación.

| Campo              | Qué controla                                                                                                                                                                                                                     |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Enabled**        | Activa o desactiva el formulario.                                                                                                                                                                                                |
| **Mandatory**      | Si está activado, el visitante debe completar el formulario para seguir chateando. Si está apagado, puede omitirlo.                                                                                                              |
| **Fields**         | Lista de campos a pedir (nombre, email, teléfono, o cualquier campo custom). Cada campo se puede marcar como **Required** o quitar de la lista. Agregá campos nuevos escribiendo el nombre y haciendo clic en **Agregar campo**. |
| **When to Use**    | Texto libre que le indica al agente en qué momento de la conversación debe mostrar el formulario (ej. "cuando el visitante muestre interés en agendar una demo").                                                                |
| **Customize Text** | Texto del botón de envío (**Submit button**) y un **Success message** opcional que se muestra después de enviar.                                                                                                                 |

<Tip>
  Un visitante que ya completó el formulario (en esta conversación o en una anterior) no vuelve a verlo.
</Tip>

Podés **Desactivar** la acción desde el botón al pie de la pantalla de configuración, sin perder los datos ya cargados en el formulario.

## Human Handoff

Controla cuándo y cómo el bot transfiere la conversación a un agente humano. Reemplaza el comportamiento anterior de detección automática por frase fija — ahora es configurable.

| Campo                     | Qué controla                                                                                                                                                     |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Enabled**               | Activa o desactiva la transferencia automática.                                                                                                                  |
| **When to Use**           | Describe cuándo el agente debe escalar la conversación (ej. temas que deben activar la escalación, o si debe intentar resolver el problema antes de transferir). |
| **Information to Gather** | Lista de datos que el agente debe recolectar del visitante antes de transferir (los toma de la conversación o los pregunta directamente).                        |

<Note>
  **Auto-assign priority** (asignar un nivel de prioridad automático a la conversación transferida) aparece en la pantalla pero requiere un plan superior — todavía no está disponible de forma general.
</Note>

Ver también [Chat en vivo y handoff](/guias/chat-en-vivo-handoff) para cómo se atiende una conversación una vez transferida.

## WooCommerce

Conecta el agente a una tienda WooCommerce para responder sobre pedidos e inventario sin salir del chat.

<Steps>
  <Step title="Cargá las credenciales de la tienda">
    * **Store URL** — la URL de tu tienda (debe tener la REST API de WooCommerce habilitada).
    * **Consumer key** y **Consumer secret** — generadas desde WooCommerce → Configuración → Avanzado → API REST. Una vez guardadas, no se vuelven a mostrar; para reemplazarlas simplemente cargá valores nuevos.
  </Step>

  <Step title="Elegí qué datos puede consultar el agente">
    * **Orders** — estado, total e items de una orden, solo después de verificar la identidad del comprador.
    * **Inventory** — disponibilidad de productos por SKU.
    * **Customer data** — reservado para uso futuro; se recomienda mantenerlo apagado por ahora.
  </Step>

  <Step title="Configurá la verificación de pedidos">
    Con **Order verification** activo, el agente exige el ID de la orden más al menos uno de estos datos antes de mostrar información: email de facturación, teléfono de facturación o código postal de facturación.
  </Step>

  <Step title="Probá la conexión">
    Usá el botón **Probar conexión** para confirmar que las credenciales funcionan antes de activar la acción para tus visitantes.
  </Step>
</Steps>

<Warning>
  WooCommerce se agrega deshabilitado por defecto en todos los agentes existentes. Activala solo después de cargar credenciales válidas y probar la conexión.
</Warning>

## Preguntas frecuentes

<AccordionGroup>
  <Accordion title="¿Puedo tener más de una acción activa al mismo tiempo?">
    Sí. Lead Form, Human Handoff y WooCommerce funcionan de forma independiente y podés activarlas todas juntas en el mismo agente.
  </Accordion>

  <Accordion title="¿Qué pasa con la configuración anterior de 'captura de leads' del widget?">
    Se migró automáticamente a la acción **Lead Form**. Si tu widget ya tenía la captura de leads activada, la vas a encontrar configurada ahí.
  </Accordion>

  <Accordion title="¿El Human Handoff sigue funcionando si no configuro nada?">
    La acción viene activada por defecto para agentes existentes, pero te recomendamos completar **When to Use** para que el criterio de escalación sea más preciso que el comportamiento genérico anterior.
  </Accordion>

  <Accordion title="¿WooCommerce funciona con cualquier tienda?">
    Necesitás una tienda WooCommerce con la REST API habilitada y credenciales (consumer key/secret) generadas desde el panel de WordPress. Usá **Probar conexión** para confirmar que todo está bien configurado.
  </Accordion>
</AccordionGroup>