Conversations

Consultez les conversations créées par votre intégration via l’API.

Liste

GET/v1/conversations

Les plus récentes en premier. limit de 1 à 100 (par défaut 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"
    }
  ]
}

Une conversation

GET/v1/conversations/{id}

Tous les messages, dans l’ordre.

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?" }
  ]
}

Pour garantir la confidentialité, l’API ne retourne que les conversations créées via l’API. Les chats WhatsApp et du site restent dans le tableau de bord du propriétaire ; pour les suivre en temps réel, utilisez le message.replied webhook.