DoubleX AgentesDocs

Referencia de la API › Recursos

Disparadores

Programa agentes, crea webhooks y reacciona a eventos de apps.

Un disparador ejecuta un agente sin que nadie envíe un mensaje. Cada ejecución crea una conversación con origen trigger o webhook. Para crear, cambiar, ejecutar o borrar, necesitas poder editar el agente. El disparador se ejecuta con la cuenta de quien lo creó.

El objeto Trigger#

JSON
{
  "id": "trg_6a2c4e8b1d3f",
  "agentId": "agt_8f3a2b1c9d0e",
  "name": "Briefing de las 8h",
  "type": "schedule",
  "schedule": { "kind": "cron", "expression": "0 8 * * 1-5" },
  "timezone": "America/Sao_Paulo",
  "prompt": "Genera el briefing diario de hoy y envíalo a mi correo.",
  "model": null,
  "enabled": true,
  "lastRunAt": "2026-10-27T11:00:04.000Z",
  "nextRunAt": "2026-10-28T11:00:00.000Z",
  "mine": true,
  "createdAt": "2026-10-20T15:00:00.000Z"
}
typeCampos propios
scheduleschedule, timezone
oncerunAt, timezone
webhookwebhookSecret (solo para quien creó el disparador o puede editar el agente)
appapp: { event, connectorId, params }

GET/api/triggers#

Lista los disparadores de los agentes que puedes ver.

QueryDescripción
agentIdSolo los disparadores de un agente.

Respuesta: { "triggers": [Trigger, ...] }.

POST/api/triggers#

CampoTipoDescripción
agentIdstringObligatorio.
typeschedule, once, webhook, appObligatorio.
namestring, de 1 a 80Obligatorio.
promptstring, hasta 4.000Lo que debe hacer el agente. Obligatorio, excepto con passRawData. Puede mencionar campos del evento: {{email}}, {{cliente.nombre}}.
modelstring o nullModelo solo para este disparador (openrouter/auto es DoubleX Auto). Sin él, se usa el modelo del agente.
timezonestringZona horaria IANA para schedule y once. Predeterminado: America/Sao_Paulo.
passRawDatabooleanwebhook y app: el agente recibe solo el JSON del evento, sin prompt.
scheduleobjetoPara schedule. Consulta más abajo.
runAtfecha ISO 8601Para once. Tiene que estar en el futuro.
appobjetoPara app: { "event", "connectorId", "params" }.

Programado#

schedule acepta una de estas formas:

FormaEjemplo
Cron (5 campos, intervalo mínimo de 5 minutos){ "kind": "cron", "expression": "0 8 * * 1-5" }
Intervalo en minutos (de 5 a 10.080){ "kind": "interval", "minutes": 30 }
Diario{ "kind": "daily", "time": "08:00" }
Semanal (weekday de 0, domingo, a 6){ "kind": "weekly", "weekday": 1, "time": "09:30" }
curl -X POST https://doublex.ai/api/triggers \
  -H "Authorization: Bearer $DOUBLEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "agt_8f3a2b1c9d0e",
    "type": "schedule",
    "name": "Briefing de las 8h",
    "prompt": "Genera el briefing diario de hoy y envíalo a mi correo.",
    "schedule": { "kind": "cron", "expression": "0 8 * * 1-5" },
    "timezone": "America/Sao_Paulo"
  }'

Webhook#

JSON
{ "agentId": "agt_8f3a2b1c9d0e", "type": "webhook", "name": "Nuevo lead", "prompt": "Califica el lead {{nombre}} ({{email}})." }

La respuesta trae el webhookSecret. La dirección es https://doublex.ai/api/webhooks/<id del disparador>. Consulta cómo llamarla en Webhooks.

Evento de app#

JSON
{
  "agentId": "agt_2b7e4c6a1f3d",
  "type": "app",
  "name": "Pedido por correo",
  "prompt": "Llegó un pedido de {{from}}: {{subject}}. Regístralo en la hoja de pedidos.",
  "app": { "event": "gmail.new_email", "connectorId": "con_7a9b1c3d5e2f", "params": { "query": "subject:pedido" } }
}
eventParámetrosCampos para el prompt
gmail.new_emailqueryfrom, to, subject, date, snippet, body, attachments, labels
google-calendar.new_eventcalendar_idtitle, start, end, location, description, organizer, attendees, link
google-calendar.event_startingcalendar_id, minutes_beforelos del calendario y minutes_until
google-drive.new_filefoldername, mime_type, link, created_time, owner
google-sheets.new_rowspreadsheet (obligatorio), sheetrow_number, row, sheet

El conector tiene que ser del mismo servicio que el evento y tienes que poder usarlo. La plataforma consulta la app cada dos minutos; la primera consulta solo marca el punto de partida.

Respuesta 201: { "trigger": Trigger }. Los errores 400 explican el problema: cron no válido o demasiado frecuente, fecha en el pasado, zona horaria no válida, evento o parámetro desconocido, conector incorrecto.

GET/api/triggers/apps#

Los eventos de app disponibles, con parámetros y campos, y tus cuentas de Google que se pueden usar:

JSON
{
  "events": [{ "id": "gmail.new_email", "service": "gmail", "params": [{ "name": "query", "type": "text" }], "fields": ["from", "subject", "..."] }],
  "accounts": [{ "id": "con_7a9b1c3d5e2f", "service": "gmail", "label": "[email protected]", "status": "connected", "mine": true }]
}

POST/api/triggers/generate-cron#

Convierte una frase en cron.

CampoTipo
descriptionstring, de 2 a 300. Por ejemplo, "todos los viernes a las 17:30".
timezonestring, opcional
JSON
{ "cron": "30 17 * * 5", "description": "Todos los viernes a las 17:30" }

Si description ya es un cron válido, se devuelve tal cual. Si no, un modelo de IA hace la conversión y consume créditos. Errores: 422 si la frase no se puede convertir en un horario válido, 402 sin créditos.

PATCH/api/triggers/{id}#

Cambia name, prompt, model (null vuelve al modelo del agente), passRawData, timezone, enabled, schedule, runAt o app. El type no cambia: para cambiarlo, borra el disparador y crea otro.

Terminal
curl -X PATCH https://doublex.ai/api/triggers/trg_6a2c4e8b1d3f \
  -H "Authorization: Bearer $DOUBLEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Respuesta: { "trigger": Trigger }.

POST/api/triggers/{id}/run#

Ejecuta el disparador ahora, en segundo plano.

  • Disparadores schedule, once y webhook: respuesta 202 { "started": true }. Sigue la ejecución en GET /api/tasks?agentId=....
  • Disparadores app: consulta la app en ese momento y responde 200 { "checked": true, "found": 2 }.

Errores: 402 sin plan activo (plan_required), sin créditos (no_credits) o con el agente sin presupuesto del mes (agent_budget); 409 si la ejecución anterior todavía no terminó; 503 si el agente no tiene un modelo disponible.

DELETE/api/triggers/{id}#

Respuesta: { "ok": true }.

POST/api/webhooks/{id}#

La dirección pública de los disparadores webhook. No usa clave de API: el secreto va en el encabezado x-webhook-secret. Responde 202 { "accepted": true }. Consulta Webhooks.