Skip to main content
La API de Tasks te permite crear tareas automáticas que ejecutan acciones en tus agentes basadas en triggers (disparadores).

​
Tipos de triggers

TipoDescripción
scheduleEjecutar en horarios definidos (cron)
integration_eventEvento de integración externa (Gmail, Calendar, etc.)
webhookWebhook externo
conversation_startNueva conversación iniciada
conversation_resolvedConversación marcada como resuelta
lead_capturedNuevo lead capturado
form_submittedFormulario completado

​
Endpoints disponibles

Listar tasks

Obtener todas las tareas de un agente.

Crear task

Crear una nueva tarea automática.

Obtener task

Ver detalles de una tarea específica.

Actualizar task

Modificar configuración de una tarea.

Eliminar task

Eliminar una tarea.

Toggle task

Activar o desactivar una tarea.

​
Ejemplo de uso

// Crear una tarea programada que ejecuta cada día a las 9am
const response = await fetch('https://app.horneross.com/api/tasks', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_xxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    agentId: 'agent_abc123',
    type: 'schedule',
    name: 'Resumen diario',
    prompt: 'Genera un resumen de las conversaciones de ayer',
    config: {
      cronExpression: '0 9 * * *',
      timezone: 'America/Argentina/Buenos_Aires'
    }
  }),
});