Conversaciones

Lee las conversaciones que tu integración creó a través de la API.

Listar

GET/v1/conversations

Las más recientes primero. limit de 1 a 100 (por defecto 20).

curl "https://api.oryksa.com/v1/conversations?limit=20" -H "Authorization: Bearer oryk_live_YOUR_KEY"

{
  "object": "list",
  "data": [
    {
      "id": "customer-4812",
      "messages": 6,
      "last_message": { "role": "assistant", "content": "Done! Saturday at 10am is booked." },
      "last_activity_at": "2026-09-24T09:41:07"
    }
  ]
}

Una conversación

GET/v1/conversations/{id}

Todos los mensajes, en orden.

curl https://api.oryksa.com/v1/conversations/customer-4812 -H "Authorization: Bearer oryk_live_YOUR_KEY"

{
  "object": "conversation",
  "id": "customer-4812",
  "messages": [
    { "role": "user", "content": "Can I book for Saturday at 10am?" },
    { "role": "assistant", "content": "Of course, Ana! Saturday at 10am is available. Shall I confirm?" }
  ]
}

Por privacidad, la API solo devuelve conversaciones creadas por la API. Las de WhatsApp y del chat del sitio se quedan en el panel del dueño; para seguirlas en tiempo real usa el webhook message.replied.