Horneross - Automatización de Operaciones

GET

api

conversations

curl -X GET "https://app.horneross.com/api/v2/conversations?channel=website&limit=10" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "conversations": [
    {
      "id": "conv_abc123",
      "title": "Consulta sobre productos",
      "channel": "website",
      "status": "UNRESOLVED",
      "agentId": "ag_xyz789",
      "messageCount": 8,
      "agent": {
        "id": "ag_xyz789",
        "name": "Agente de Ventas",
        "iconUrl": "https://storage.horneross.com/icons/agent.png"
      },
      "lastMessage": {
        "id": "msg_001",
        "text": "Gracias por la información",
        "from": "human",
        "createdAt": "2024-01-21T15:30:00Z"
      },
      "metadata": {
        "source": "landing_page"
      },
      "createdAt": "2024-01-21T10:00:00Z",
      "updatedAt": "2024-01-21T15:30:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "cursor": "conv_abc123",
    "hasMore": true
  },
  "filters": {
    "channel": "all",
    "availableChannels": ["website", "whatsapp", "api", "dashboard", "agent_builder"]
  }
}

Endpoint

GET /api/v2/conversations

Headers

Authorization

string

required

Bearer token con tu API key de organización.

Query Parameters

channel

string

default:"all"

Filtrar por canal. Valores: api, website, whatsapp, widget, dashboard, agent_builder, instagram, telegram, all

limit

number

default:"20"

Resultados por página. Máximo 100.

cursor

string

Cursor para paginación. Usar el ID de la última conversación de la página anterior.

curl -X GET "https://app.horneross.com/api/v2/conversations?channel=website&limit=10" \
  -H "Authorization: Bearer sk_live_xxx"

Response

conversations

array

required

Array de conversaciones

Show Propiedades de cada conversación

conversations[].id

string

required

ID único de la conversación

conversations[].title

string

Título de la conversación

conversations[].channel

string

required

Canal de origen: api, website, whatsapp, dashboard, etc.

conversations[].status

string

required

Estado: UNRESOLVED, RESOLVED, HUMAN_REQUESTED

conversations[].agentId

string

ID del agente asociado

conversations[].messageCount

number

Cantidad de mensajes en la conversación

conversations[].agent

object

Datos del agente

Show Propiedades de agent

conversations[].agent.id

string

ID del agente

conversations[].agent.name

string

Nombre del agente

conversations[].agent.iconUrl

string

URL del icono del agente

conversations[].lastMessage

object

Último mensaje de la conversación

Show Propiedades de lastMessage

conversations[].lastMessage.id

string

ID del mensaje

conversations[].lastMessage.text

string

Contenido del mensaje

conversations[].lastMessage.from

string

Origen: human o agent

conversations[].lastMessage.createdAt

string

Fecha de creación (ISO 8601)

conversations[].metadata

object

Metadata personalizada de la conversación

conversations[].createdAt

string

Fecha de creación (ISO 8601)

conversations[].updatedAt

string

Última actualización (ISO 8601)

pagination

object

required

Información de paginación

Show Propiedades de pagination

pagination.limit

number

Límite de resultados por página

pagination.cursor

string

Cursor para la siguiente página (null si no hay más)

pagination.hasMore

boolean

Si hay más resultados disponibles

filters

object

Filtros aplicados

Show Propiedades de filters

filters.channel

string

Canal filtrado actual

filters.availableChannels

string[]

Lista de todos los canales disponibles

{
  "conversations": [
    {
      "id": "conv_abc123",
      "title": "Consulta sobre productos",
      "channel": "website",
      "status": "UNRESOLVED",
      "agentId": "ag_xyz789",
      "messageCount": 8,
      "agent": {
        "id": "ag_xyz789",
        "name": "Agente de Ventas",
        "iconUrl": "https://storage.horneross.com/icons/agent.png"
      },
      "lastMessage": {
        "id": "msg_001",
        "text": "Gracias por la información",
        "from": "human",
        "createdAt": "2024-01-21T15:30:00Z"
      },
      "metadata": {
        "source": "landing_page"
      },
      "createdAt": "2024-01-21T10:00:00Z",
      "updatedAt": "2024-01-21T15:30:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "cursor": "conv_abc123",
    "hasMore": true
  },
  "filters": {
    "channel": "all",
    "availableChannels": ["website", "whatsapp", "api", "dashboard", "agent_builder"]
  }
}

Crear conversaciónCrear una nueva conversación programáticamente.

curl -X GET "https://app.horneross.com/api/v2/conversations?channel=website&limit=10" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "conversations": [
    {
      "id": "conv_abc123",
      "title": "Consulta sobre productos",
      "channel": "website",
      "status": "UNRESOLVED",
      "agentId": "ag_xyz789",
      "messageCount": 8,
      "agent": {
        "id": "ag_xyz789",
        "name": "Agente de Ventas",
        "iconUrl": "https://storage.horneross.com/icons/agent.png"
      },
      "lastMessage": {
        "id": "msg_001",
        "text": "Gracias por la información",
        "from": "human",
        "createdAt": "2024-01-21T15:30:00Z"
      },
      "metadata": {
        "source": "landing_page"
      },
      "createdAt": "2024-01-21T10:00:00Z",
      "updatedAt": "2024-01-21T15:30:00Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "cursor": "conv_abc123",
    "hasMore": true
  },
  "filters": {
    "channel": "all",
    "availableChannels": ["website", "whatsapp", "api", "dashboard", "agent_builder"]
  }
}

​Endpoint

​Headers

​Query Parameters

​Response

Endpoint

Headers

Query Parameters

Response