Conversas

Leia as conversas que a sua integração criou através da API.

Listar

GET/v1/conversations

As mais recentes primeiro. limit de 1 a 100 (por padrão 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"
    }
  ]
}

Uma conversa

GET/v1/conversations/{id}

Todas as mensagens, em ordem.

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 privacidade, a API só retorna conversas criadas pela API. As conversas do WhatsApp e do chat do site ficam no painel do dono; para acompanhá-las em tempo real, use o webhook message.replied.