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

# Evento: Cambio de estado

> Recibe cambios de estado de un workflow y conoce el payload y los filtros disponibles en el dashboard.

Se dispara cuando el estado de un lead cambia dentro de un workflow. Usa este evento para sincronizar los cambios con tu CRM, activar automatizaciones externas o enviar notificaciones.

## Payload

```json theme={null}
{
  "event_type": "workflow_run.status_changed",
  "event_id": "...",
  "webhook_id": "...",
  "delivery_id": "...",
  "timestamp": "2026-04-17T16:30:00.000Z",
  "client_id": "...",
  "test": false,
  "data": {
    "status_change": {
      "from_status": {
        "id": "uuid",
        "key": "new",
        "label": "Nuevo lead",
        "category": "initial"
      },
      "to_status": {
        "id": "uuid",
        "key": "contacted",
        "label": "Contactado",
        "category": "active"
      },
      "reason": "AI agent completed first outreach",
      "trigger_type": "ai",
      "actor_type": "ai",
      "actor_id": null,
      "changed_at": "2026-04-17T16:30:00.000Z"
    },
    "lead": {
      "id": "uuid",
      "first_name": "Tony",
      "last_name": "Stark",
      "email": "tony.stark@gmail.com",
      "phone": "56994357854",
      "company": "Stark Industries",
      "source": "api",
      "external_id": null,
      "metadata": {}
    },
    "workflow": {
      "id": "uuid",
      "name": "Lead a intención de compra"
    },
    "workflow_run": {
      "id": "uuid",
      "started_at": "2026-04-15T10:00:00.000Z",
      "current_channel": "whatsapp",
      "total_status_changes": 3,
      "origin": "api"
    }
  }
}
```

## Campos

### `data.status_change`

| Campo          | Tipo                  | Descripción                                                                         |
| -------------- | --------------------- | ----------------------------------------------------------------------------------- |
| `from_status`  | object \| null        | Estado anterior (`id`, `key`, `label`, `category`)                                  |
| `to_status`    | object \| null        | Nuevo estado (`id`, `key`, `label`, `category`)                                     |
| `reason`       | string \| null        | Motivo registrado para el cambio                                                    |
| `trigger_type` | string                | Qué causó el cambio: `manual`, `ai_agent`, `system`, `workflow_rule`, `auto` o `ai` |
| `actor_type`   | string                | Quién realizó el cambio: `user`, `ai_agent`, `system` o `ai`                        |
| `actor_id`     | string (uuid) \| null | ID del actor, cuando se registró                                                    |
| `changed_at`   | string (ISO 8601)     | Momento exacto del cambio de estado                                                 |

### `data.lead`

| Campo         | Tipo           | Descripción                  |
| ------------- | -------------- | ---------------------------- |
| `id`          | string (uuid)  | ID del lead                  |
| `first_name`  | string \| null | Nombre del lead              |
| `last_name`   | string \| null | Apellido del lead            |
| `email`       | string \| null | Email del lead               |
| `phone`       | string \| null | Teléfono del lead            |
| `company`     | string \| null | Empresa del lead             |
| `source`      | string         | Origen guardado para el lead |
| `external_id` | string \| null | ID de un sistema externo     |
| `metadata`    | object         | Metadata del lead            |

### `data.workflow`

| Campo  | Tipo          | Descripción         |
| ------ | ------------- | ------------------- |
| `id`   | string (uuid) | ID del workflow     |
| `name` | string        | Nombre del workflow |

### `data.workflow_run`

| Campo                  | Tipo                      | Descripción                                   |
| ---------------------- | ------------------------- | --------------------------------------------- |
| `id`                   | string (uuid)             | ID de la ejecución del workflow               |
| `started_at`           | string (ISO 8601) \| null | Cuándo entró el lead en este workflow         |
| `current_channel`      | string \| null            | Canal actual registrado para la ejecución     |
| `total_status_changes` | number                    | Número de cambios de estado de esta ejecución |
| `origin`               | string                    | Cómo comenzó la ejecución                     |

## Filtros

El dashboard permite recibir cambios de todos los agentes o de un agente seleccionado. También puedes elegir un estado de destino o agregar estos filtros:

| Campo de filtro   | Descripción                                     | Ejemplo     |
| ----------------- | ----------------------------------------------- | ----------- |
| `to_status.key`   | Envía solo los cambios hacia este estado        | `qualified` |
| `from_status.key` | Envía solo los cambios desde este estado        | `new`       |
| `workflow_id`     | Envía solo los cambios de este agente           | `uuid`      |
| `trigger_type`    | Envía solo los cambios con este tipo de trigger | `ai`        |