الحصول على سجل المحادثات عبر WhatChimp API

استرجع سجل الرسائل الكامل مع أي مشترك: الرسائل المرسلة والمستلمة والطوابع الزمنية وحالة التسليم.

Updated 5 February 2026

استرجع سجل المحادثات الكامل مع أي مشترك: كل رسالة مرسلة ومستلمة، مع الطوابع الزمنية ومعلومات المرسل وحالة التسليم.

قبل البدء: تأكد من أن لديك مفتاح API الخاص بك ورقم تعريف الهاتف. راجع البدء مع WhatChimp Developer API للحصول على تعليمات الإعداد.

Endpoint

GET/POST /api/v1/whatsapp/get/conversation

https://app.whatchimp.com/api/v1/whatsapp/get/conversation

المعاملات

المعامل	النوع	مطلوب	الوصف
`apiToken`	String	نعم	مفتاح WhatChimp API الخاص بك
`phone_number_id`	String	نعم	رقم تعريف هاتف WhatsApp الخاص بك
`phone_number`	String	نعم	رقم هاتف المشترك مع رمز الدولة (مثل، `919999999999`)
`limit`	Number	نعم	عدد الرسائل المراد استرجاعها
`offset`	Number	لا	إزاحة الترقيم (البدء من هذا الموضع)

أمثلة الطلبات

GET:

https://app.whatchimp.com/api/v1/whatsapp/get/conversation?apiToken=API-KEY&phone_number_id=PHONE-NUMBER-ID&phone_number=919999999999&limit=10&offset=1

POST (cURL):

curl -X POST \
  'https://app.whatchimp.com/api/v1/whatsapp/get/conversation' \
  -d 'apiToken=API-KEY' \
  -d 'phone_number_id=PHONE-NUMBER-ID' \
  -d 'phone_number=919999999999' \
  -d 'limit=10' \
  -d 'offset=1'

Get Conversation endpoint showing parameters, request examples, and sample response in the API console

الاستجابة

{
  "status": "1",
  "message": [
    {
      "id": 8003,
      "sender": "bot",
      "agent_name": null,
      "message_content": "{...}",
      "conversation_time": "2024-07-28 13:21:03",
      "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABEYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
      "message_status": "delivered",
      "delivery_status_updated_at": "2024-07-28 13:21:05"
    },
    {
      "id": 8004,
      "sender": "subscriber",
      "agent_name": null,
      "message_content": "مرحباً، أحتاج مساعدة بطلبي",
      "conversation_time": "2024-07-28 13:25:10",
      "wa_message_id": "wamid.HBgNODgwMTcyMzMwOTAwMxUCABIYEjlGQkY3MEFEMEVGODhCNDkxNQA=",
      "message_status": null,
      "delivery_status_updated_at": null
    }
  ]
}

حقول الاستجابة

الحقل	الوصف
`id`	معرّف الرسالة الداخلي
`sender`	من أرسل الرسالة: `"bot"` أو `"subscriber"` أو اسم وكيل
`agent_name`	اسم الوكيل البشري (إذا تم إرسال الرسالة من Live Chat)
`message_content`	نص الرسالة. بالنسبة لرسائل الروبوت، هذا عبارة عن سلسلة JSON مع حمولة الرسالة الكاملة
`conversation_time`	الطابع الزمني عند إرسال الرسالة
`wa_message_id`	معرّف رسالة WhatsApp: استخدم هذا مع Delivery Status API لتتبع التسليم
`message_status`	حالة التسليم الحالية (`sent`، `delivered`، `read`، `failed`)
`delivery_status_updated_at`	متى تم تحديث حالة التسليم آخر مرة

الترقيم

استخدم limit و offset لترقيم المحادثات الطويلة:

# أول 10 رسائل
?limit=10&offset=1

# 10 رسائل التالية
?limit=10&offset=11

# 10 التالية
?limit=10&offset=21

حالات الاستخدام

تكامل CRM: مزامنة سجل المحادثات في نظام CRM أو مكتب المساعدة الخاص بك
التحليلات: تحليل أوقات الاستجابة وأحجام الرسائل وأنماط المحادثة
مسار التدقيق: احتفظ بسجل لجميع تفاعلات العملاء
تصحيح أخطاء الروبوت: راجع ما أرسله روبوتك مقابل ما رد عليه العميل