المطورون / الوكلاء

عرض النص المفرّغ لمحادثة

GET https://api.echonova.ai/v1/agents/{agentId}/conversations/{sessionId}/transcript

تعيد أحدث `limit` رسالة من محادثة واحدة، والأقدم أولًا داخل الصفحة. للرسائل الأقدم، مرّر `createdAt` لأول رسالة في الصفحة في `before`. يحتاج المفتاح إلى النطاق `agents:read`.

Headers

Authorization string مطلوب

كلمة ⁦Bearer⁩ ثم مسافة ثم مفتاح ⁦API⁩ الذي يبدأ بـ ⁦ek_⁩. أنشئ المفاتيح في البوابة من المطورون، ثم مفاتيح واجهة برمجة التطبيقات.

معاملات المسار

agentId string مطلوب

معرّف الوكيل كما أعادته `GET /v1/agents`.

sessionId string مطلوب

معرّف المحادثة كما أعادته `GET /v1/agents/{agentId}/conversations`.

معاملات الاستعلام

limit integer اختياري

عدد الرسائل التي تُعاد، من الأحدث إلى الأقدم.

من 1 إلى 50الافتراضي 20
before string اختياري

الرسائل المرسلة قبل هذا التاريخ والوقت بصيغة ISO 8601 فقط. مرّر `createdAt` لأقدم رسالة لديك لتحصل على الصفحة التي قبلها.

الاستجابة

200 application/json كل استجابة تستخدم هذا الغلاف.

data object

النتيجة.

success boolean

قيمته ⁦true⁩ عند نجاح الطلب.

statusCode integer

يكرر رمز حالة ⁦HTTP⁩.

errorMessage string or null

قيمته ⁦null⁩ عند النجاح.

الأخطاء

الغلاف نفسه، مع ⁦success⁩ بقيمة ⁦false⁩ و ⁦data⁩ بقيمة ⁦null⁩. كل الأخطاء

GET /v1/agents/{agentId}/conversations/{sessionId}/transcript

curl "https://api.echonova.ai/v1/agents/{agentId}/conversations/{sessionId}/transcript" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "6652a1b2c3d4e5f6a7b8c9d0",
      "direction": "inbound",
      "sender": "customer",
      "text": "How much is the Pro plan?",
      "createdAt": "2026-11-02T10:00:01.000Z"
    }
  ],
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}