Skip to main content
GET
/
api
/
v2
/
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
​
pagination
object
required
Información de paginación
​
filters
object
Filtros aplicados
{
  "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"]
  }
}