Horneross - Automatización de Operaciones

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"
    }
  }'

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',
    },
  }),
});

const { trigger } = await response.json();
console.log('Task creada:', trigger.id);

import requests

response = requests.post(
    'https://app.horneross.com/api/tasks',
    headers={
        'Authorization': 'Bearer sk_live_xxx',
        'Content-Type': 'application/json',
    },
    json={
        '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'
        }
    }
)

trigger = response.json()['trigger']
print(f'Task creada: {trigger["id"]}')

{
  "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
    }
  }
}

{
  "error": "A task with this name already exists for this agent. Please choose a different name."
}

{
  "error": "Agent not found"
}

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

Show Opciones de config

config.cronExpression

string

Expresión cron para triggers tipo schedule (ej: 0 9 * * *)

config.timezone

string

Zona horaria (ej: America/Argentina/Buenos_Aires)

isEnabled

boolean

default:"true"

Si la tarea debe estar activa al crearla

eventConfig

object

Configuración para triggers tipo integration_event

Show Opciones de eventConfig

eventConfig.profileId

string

required

ID del perfil de Composio conectado

eventConfig.connectedAccountId

string

required

ID de la cuenta conectada

eventConfig.triggerSlug

string

required

Slug del trigger de Composio (ej: gmail_new_email)

eventConfig.triggerConfig

object

Configuración adicional del trigger

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"
    }
  }'

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',
    },
  }),
});

const { trigger } = await response.json();
console.log('Task creada:', trigger.id);

import requests

response = requests.post(
    'https://app.horneross.com/api/tasks',
    headers={
        'Authorization': 'Bearer sk_live_xxx',
        'Content-Type': 'application/json',
    },
    json={
        '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'
        }
    }
)

trigger = response.json()['trigger']
print(f'Task creada: {trigger["id"]}')

Response

trigger

object

required

La tarea creada

Show Propiedades

trigger.id

string

required

ID único de la tarea

trigger.agentId

string

required

ID del agente

trigger.type

string

required

Tipo de trigger

trigger.name

string

required

Nombre

trigger.config

object

required

Configuración completa

trigger.isEnabled

boolean

required

Estado de activación

{
  "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
    }
  }
}

{
  "error": "A task with this name already exists for this agent. Please choose a different name."
}

{
  "error": "Agent not found"
}

Expresiones Cron

Formato: minuto hora día-del-mes mes día-de-semana

Expresión	Descripción
`0 9 * * *`	Todos los días a las 9:00 AM
`0 9 * * 1-5`	Lunes 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 * * 0`	Domingos a las 2:30 PM

Obtener taskObtener detalles de una tarea específica.

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"
    }
  }'

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',
    },
  }),
});

const { trigger } = await response.json();
console.log('Task creada:', trigger.id);

import requests

response = requests.post(
    'https://app.horneross.com/api/tasks',
    headers={
        'Authorization': 'Bearer sk_live_xxx',
        'Content-Type': 'application/json',
    },
    json={
        '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'
        }
    }
)

trigger = response.json()['trigger']
print(f'Task creada: {trigger["id"]}')

{
  "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
    }
  }
}

{
  "error": "A task with this name already exists for this agent. Please choose a different name."
}

{
  "error": "Agent not found"
}

Empezar

Guías

Industrias

Developers

Soporte

Legal

Crear task

Endpoint

Headers

Request Body

Response

Expresiones Cron

​Endpoint

​Headers

​Request Body

​Response

​Expresiones Cron

Endpoint

Headers

Request Body

Response

Expresiones Cron