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