Workflows

Crea, gestiona, dispara y monitorea workflows automatizados y registros de ejecución.

CLI vs API key: Los tokens CLI son solo lectura para crear, actualizar y eliminar workflows — esas escrituras requieren X-API-KEY. Trigger es la excepción: acepta una API key o un token CLI con capacidad de escritura. Todos los endpoints de workflows están restringidos por plan; las organizaciones sin la función de workflows pueden recibir 403 incluso en lecturas.

Resumen de endpoints

GET /v1/workflows/

Devuelve todos los workflows de la organización. Paginado con el envelope estándar { count, next, previous, results }.

Parámetros de consulta

curl -X GET "https://api.dailybot.com/v1/workflows/?search=onboarding&start_date=2026-06-01&end_date=2026-06-30&page_size=50" \
  -H "X-API-KEY: tu_api_key"

Respuesta (200 OK):

{
  "count": 5,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "wf-uuid",
      "name": "Incorporación de Nuevos Empleados",
      "is_active": true,
      "trigger_type": "event",
      "created_at": "2026-01-15T00:00:00Z"
    }
  ]
}

Identificador: Cada workflow usa id como identificador — el valor es un UUID (ver Identificadores).

GET /v1/workflows/{uuid}/

Devuelve un workflow específico con configuración completa.

curl -X GET "https://api.dailybot.com/v1/workflows/wf-uuid/" \
  -H "X-API-KEY: tu_api_key"

Respuesta (200 OK):

{
  "uuid": "wf-uuid",
  "name": "Incorporación de Nuevos Empleados",
  "is_active": true,
  "trigger_type": "event",
  "trigger_config": {
    "event": "organization.user_activated"
  },
  "actions": [
    {
      "type": "send_message",
      "target_type": "user",
      "message": "¡Bienvenido al equipo! Aquí está lo que debes hacer primero..."
    }
  ],
  "created_at": "2026-01-15T00:00:00Z"
}

POST /v1/workflows/

Crea un nuevo workflow. Auth: solo API key — los tokens CLI se rechazan en POST.

Parámetros del cuerpo

curl -X POST "https://api.dailybot.com/v1/workflows/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Notificación de Despliegue",
    "trigger_type": "api_trigger",
    "trigger_config": {},
    "actions": [
      {
        "type": "send_message",
        "target_type": "channel",
        "target_uuid": "channel-uuid",
        "message": "Despliegue completado: {{trigger.body.service}} v{{trigger.body.version}}"
      }
    ]
  }'

Respuesta (201 Created):

{
  "uuid": "wf-new-uuid",
  "name": "Notificación de Despliegue",
  "is_active": true,
  "trigger_type": "api_trigger",
  "created_at": "2026-04-06T10:00:00Z"
}

DELETE /v1/workflows/{uuid}/

Elimina un workflow.

curl -X DELETE "https://api.dailybot.com/v1/workflows/wf-uuid/" \
  -H "X-API-KEY: tu_api_key"

Respuesta (204 No Content)

POST /v1/workflows/{uuid}/trigger/

Dispara manualmente un workflow cuyo tipo de trigger es api_trigger — el trigger diseñado para disparo externo. Los workflows con cualquier otro tipo de trigger (programados, eventos de formulario/check-in, comandos, …) mantienen sus propias rutas de disparo y devuelven 400 workflow_not_triggerable.

Auth: API key o token CLI con capacidad de escritura. Permisos: restricción por plan + membresía de la org; se aplica el permiso de ejecución por workflow.

Cuerpo de la solicitud

El cuerpo es opcional:

{"payload": {"env": "production", "requested_by": "release-bot"}}

curl -X POST "https://api.dailybot.com/v1/workflows/wf-uuid/trigger/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"payload": {"env": "production"}}'

Respuesta — 202 Accepted (la ejecución se encola, no se ejecuta en línea):

{"detail": "Workflow trigger accepted.", "workflow_uuid": "wf-uuid", "queued": true}

Códigos de error

Los mismos workflows api_trigger también pueden dispararse desde un botón interactivo de mensaje vía buttons[].callback_workflow (opcionalmente con un modal_body cuyos campos enviados llegan como {{trigger.fields.<name>}}). Consulta Mensajería del bot para los campos de botones.

Disparado vía la API pública, {{trigger.source}} es "api" y las claves de botón/campo son null o vacías.

Variables de trigger

Los pasos del workflow pueden referenciar el contexto de disparo a través del namespace {{trigger.*}}:

Recetas

Modal → Workflow

Compón modal_body con callback_workflow en un botón interactivo: el clic abre el modal y, al enviar, los valores de los campos se entregan al workflow como {{trigger.fields.<input.name>}} — sin servidor externo.

curl -X POST "https://api.dailybot.com/v1/send-message/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Reportar un incidente:",
    "target_users": ["user-uuid"],
    "buttons": [
      {
        "label": "Reportar",
        "button_type": "interactive",
        "value": "report",
        "callback_workflow": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "modal_body": {
          "title": "Nuevo incidente",
          "blocks": [
            {
              "type": "input",
              "name": "summary",
              "label": "¿Qué pasó?",
              "multiline": true,
              "required": true
            }
          ]
        }
      }
    ]
  }'

El workflow (tipo de trigger api_trigger) puede usar entonces {{trigger.fields.summary}} en cualquier paso — prellenar una respuesta de formulario, componer un mensaje o alimentar un prompt de IA. Un modal con bloques input y sin callback_url ni callback_workflow se rechaza (input_without_callback).

Ramificación por valor — varios botones, un workflow

Apunta varios botones al mismo UUID de workflow con distintos strings value, y ramifica dentro del workflow en {{trigger.button_value}}:

curl -X POST "https://api.dailybot.com/v1/send-message/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "El despliegue está listo — elige una acción:",
    "target_users": ["user-uuid"],
    "buttons": [
      {
        "label": "Desplegar a staging",
        "button_type": "interactive",
        "value": "staging",
        "callback_workflow": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      },
      {
        "label": "Desplegar a producción",
        "button_type": "interactive",
        "value": "production",
        "callback_workflow": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      },
      {
        "label": "Cancelar",
        "button_type": "interactive",
        "value": "cancel",
        "callback_workflow": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
      }
    ]
  }'

Dentro del workflow, un paso condicional en {{trigger.button_value}} enruta staging, production o cancel sin mantener tres definiciones de workflow separadas.

Para el esquema completo de botones (label, modal_body, response y más), consulta Mensajería del bot.

GET /v1/workflows/{uuid}/execution_logs/

Devuelve los registros de ejecución de un workflow específico.

Parámetros de consulta

curl -X GET "https://api.dailybot.com/v1/workflows/wf-uuid/execution_logs/?limit=10" \
  -H "X-API-KEY: tu_api_key"

Respuesta (200 OK):

{
  "count": 25,
  "results": [
    {
      "id": "log-uuid",
      "workflow_uuid": "wf-uuid",
      "status": "success",
      "trigger_data": { "source": "api" },
      "executed_at": "2026-04-06T09:00:00Z",
      "duration_ms": 145
    }
  ]
}

POST /v1/workflows/{uuid}/duplicate/

Duplica un workflow con un nuevo nombre.

curl -X POST "https://api.dailybot.com/v1/workflows/wf-uuid/duplicate/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Notificación de Despliegue (Copia)"}'

Respuesta (201 Created):

{
  "uuid": "wf-copy-uuid",
  "name": "Notificación de Despliegue (Copia)",
  "is_active": false,
  "created_at": "2026-04-06T10:05:00Z"
}