Skip to main content
POST
/
api
/
tasks
curl -X POST https://app.horneross.com/api/tasks \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "agent_abc123",
    "type": "schedule",
    "name": "Resumen diario",
    "description": "Genera resumen de conversaciones cada mañana",
    "prompt": "Genera un resumen de las conversaciones de ayer y envialo por email",
    "config": {
      "cronExpression": "0 9 * * *",
      "timezone": "America/Argentina/Buenos_Aires"
    }
  }'

{
  "trigger": {
    "id": "trigger_new123",
    "agentId": "agent_abc123",
    "type": "schedule",
    "name": "Resumen diario",
    "description": "Genera resumen de conversaciones cada mañana",
    "config": {
      "prompt": "Genera un resumen de las conversaciones de ayer",
      "cronExpression": "0 9 * * *",
      "timezone": "America/Argentina/Buenos_Aires"
    },
    "isEnabled": true,
    "createdAt": "2024-01-21T16:00:00Z",
    "agent": {
      "id": "agent_abc123",
      "name": "Asistente de Ventas",
      "iconUrl": null
    }
  }
}

​
Endpoint

POST /api/tasks

​
Headers

​
Authorization
string
required
Bearer token con tu API key. Formato: Bearer sk_live_xxx
​
Content-Type
string
required
application/json

​
Request Body

​
agentId
string
required
ID del agente que ejecutará la tarea
​
type
string
required
Tipo de trigger. Valores: schedule, integration_event, webhook, conversation_start, conversation_resolved, lead_captured, form_submitted
​
name
string
required
Nombre de la tarea (máx 100 caracteres)
​
description
string
Descripción opcional (máx 500 caracteres)
​
prompt
string
required
Instrucciones que el agente ejecutará cuando se active el trigger
​
config
object
Configuración específica del tipo de trigger
​
isEnabled
boolean
default:"true"
Si la tarea debe estar activa al crearla
​
eventConfig
object
Configuración para triggers tipo integration_event
curl -X POST https://app.horneross.com/api/tasks \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "agent_abc123",
    "type": "schedule",
    "name": "Resumen diario",
    "description": "Genera resumen de conversaciones cada mañana",
    "prompt": "Genera un resumen de las conversaciones de ayer y envialo por email",
    "config": {
      "cronExpression": "0 9 * * *",
      "timezone": "America/Argentina/Buenos_Aires"
    }
  }'

​
Response

​
trigger
object
required
La tarea creada
{
  "trigger": {
    "id": "trigger_new123",
    "agentId": "agent_abc123",
    "type": "schedule",
    "name": "Resumen diario",
    "description": "Genera resumen de conversaciones cada mañana",
    "config": {
      "prompt": "Genera un resumen de las conversaciones de ayer",
      "cronExpression": "0 9 * * *",
      "timezone": "America/Argentina/Buenos_Aires"
    },
    "isEnabled": true,
    "createdAt": "2024-01-21T16:00:00Z",
    "agent": {
      "id": "agent_abc123",
      "name": "Asistente de Ventas",
      "iconUrl": null
    }
  }
}

​
Expresiones Cron

Formato: minuto hora día-del-mes mes día-de-semana
ExpresiónDescripción
0 9 * * *Todos los días a las 9:00 AM
0 9 * * 1-5Lunes a Viernes a las 9:00 AM
0 */2 * * *Cada 2 horas
0 9 1 * *Primer día del mes a las 9:00 AM
30 14 * * 0Domingos a las 2:30 PM