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#
{
"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"
}type | Campos propios |
|---|---|
schedule | schedule, timezone |
once | runAt, timezone |
webhook | webhookSecret (solo para quien creó el disparador o puede editar el agente) |
app | app: { event, connectorId, params } |
GET/api/triggers#
Lista los disparadores de los agentes que puedes ver.
| Query | Descripción |
|---|---|
agentId | Solo los disparadores de un agente. |
Respuesta: { "triggers": [Trigger, ...] }.
POST/api/triggers#
| Campo | Tipo | Descripción |
|---|---|---|
agentId | string | Obligatorio. |
type | schedule, once, webhook, app | Obligatorio. |
name | string, de 1 a 80 | Obligatorio. |
prompt | string, hasta 4.000 | Lo que debe hacer el agente. Obligatorio, excepto con passRawData. Puede mencionar campos del evento: {{email}}, {{cliente.nombre}}. |
model | string o null | Modelo solo para este disparador (openrouter/auto es DoubleX Auto). Sin él, se usa el modelo del agente. |
timezone | string | Zona horaria IANA para schedule y once. Predeterminado: America/Sao_Paulo. |
passRawData | boolean | webhook y app: el agente recibe solo el JSON del evento, sin prompt. |
schedule | objeto | Para schedule. Consulta más abajo. |
runAt | fecha ISO 8601 | Para once. Tiene que estar en el futuro. |
app | objeto | Para app: { "event", "connectorId", "params" }. |
Programado#
schedule acepta una de estas formas:
| Forma | Ejemplo |
|---|---|
| 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#
{ "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#
{
"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" } }
}event | Parámetros | Campos para el prompt |
|---|---|---|
gmail.new_email | query | from, to, subject, date, snippet, body, attachments, labels |
google-calendar.new_event | calendar_id | title, start, end, location, description, organizer, attendees, link |
google-calendar.event_starting | calendar_id, minutes_before | los del calendario y minutes_until |
google-drive.new_file | folder | name, mime_type, link, created_time, owner |
google-sheets.new_row | spreadsheet (obligatorio), sheet | row_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:
{
"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.
| Campo | Tipo |
|---|---|
description | string, de 2 a 300. Por ejemplo, "todos los viernes a las 17:30". |
timezone | string, opcional |
{ "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.
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,onceywebhook: respuesta202{ "started": true }. Sigue la ejecución enGET /api/tasks?agentId=.... - Disparadores
app: consulta la app en ese momento y responde200{ "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.