Catalog والطلبات عبر WhatChimp API

إدارة Catalogات منتجات WhatsApp ومعالجة الطلبات عبر API

Updated 10 February 2026

قم بإدارة Catalogات منتجات WhatsApp الخاصة بك ومعالجة الطلبات من خلال WhatChimp API. قم بسرد Catalogات ومزامنة المنتجات واسترجاع الطلبات وتحديث حالات الطلبات.

قبل البدء: تأكد من أن لديك بيانات اعتماد WhatChimp API جاهزة.

Video: https://www.youtube.com/watch?v=DKzgOzMlv1I

نقاط النهاية

1. قائمة Catalogات

GET/POST /api/v1/whatsapp/catalog/list

استرجع جميع Catalogات المرتبطة بحسابك.

2. مزامنة Catalog

POST /api/v1/whatsapp/catalog/sync

قم بمزامنة منتجات Catalog من Meta إلى WhatChimp.

نقاط نهاية مزامنة Catalog وقائمة الطلبات

3. قائمة طلبات Catalog

GET/POST /api/v1/whatsapp/catalog/order/list

استرجع جميع الطلبات من Catalogاتك.

4. تغيير حالة طلب Catalog

GET/POST /api/v1/whatsapp/catalog/order/status-change

قم بتحديث حالة طلب من Catalog.

المعاملات

معاملات قائمة Catalogات

المعامل	النوع	مطلوب	الوصف
`apiToken`	String	نعم	رمز WhatChimp API الخاص بك

معاملات مزامنة Catalog

المعامل	النوع	مطلوب	الوصف
`apiToken`	String	نعم	رمز WhatChimp API الخاص بك
`whatsapp_catalog_id`	String	نعم	معرف Catalog WhatsApp للمزامنة

معاملات قائمة طلبات Catalog

المعامل	النوع	مطلوب	الوصف
`apiToken`	String	نعم	رمز WhatChimp API الخاص بك
`whatsapp_catalog_id`	String	لا	معرف Catalog اختياري لتصفية الطلبات

معاملات تغيير حالة طلب Catalog

المعامل	النوع	مطلوب	الوصف
`apiToken`	String	نعم	رمز WhatChimp API الخاص بك
`order_unique_id`	String	نعم	المعرف الفريد للطلب
`cart_status`	String	نعم	الحالة الجديدة: `Approved` أو `Completed` أو `Shipped` أو `Delivered` أو `Refunded`

أمثلة الطلب

قائمة Catalogات - طلب GET

curl -X GET "https://app.whatchimp.com/api/v1/whatsapp/catalog/list?apiToken=API-KEY"

قائمة Catalogات - طلب POST (cURL)

curl -X POST https://app.whatchimp.com/api/v1/whatsapp/catalog/list \
  -H "Content-Type: application/json" \
  -d '{
    "apiToken": "API-KEY"
  }'

مزامنة Catalog - طلب POST (cURL)

curl -X POST https://app.whatchimp.com/api/v1/whatsapp/catalog/sync \
  -H "Content-Type: application/json" \
  -d '{
    "apiToken": "API-KEY",
    "whatsapp_catalog_id": "CATALOG-ID"
  }'

قائمة طلبات Catalog - طلب GET

curl -X GET "https://app.whatchimp.com/api/v1/whatsapp/catalog/order/list?apiToken=API-KEY&whatsapp_catalog_id=CATALOG-ID"

قائمة طلبات Catalog - طلب POST (cURL)

curl -X POST https://app.whatchimp.com/api/v1/whatsapp/catalog/order/list \
  -H "Content-Type: application/json" \
  -d '{
    "apiToken": "API-KEY",
    "whatsapp_catalog_id": "CATALOG-ID"
  }'

تغيير حالة طلب Catalog - طلب GET

curl -X GET "https://app.whatchimp.com/api/v1/whatsapp/catalog/order/status-change?apiToken=API-KEY&order_unique_id=ORDER-ID&cart_status=Shipped"

تغيير حالة طلب Catalog - طلب POST (cURL)

curl -X POST https://app.whatchimp.com/api/v1/whatsapp/catalog/order/status-change \
  -H "Content-Type: application/json" \
  -d '{
    "apiToken": "API-KEY",
    "order_unique_id": "ORDER-ID",
    "cart_status": "Shipped"
  }'

الاستجابة

استجابة قائمة Catalogات

{
  "status": true,
  "message": [
    {
      "catalog_id": "1429267xxxx5095",
      "catalog_name": "The White",
      "catalog_url": "https:xxxxx",
      "checkout_settings": "{\"tax_percentage\":\"5.5\",\"shipping_charge\":\"20\"}"
    }
  ]
}

استجابة مزامنة Catalog

{
  "status": "1",
  "message": "Catalog products have been synced successfully."
}

استجابة قائمة طلبات Catalog

{
  "status": "1",
  "message": [
    {
      "order_unique_id": "172310467380123456789",
      "catalog_id": "762561142206860",
      "chat_id": "0123456789",
      "catalog_name": "Catalog Name",
      "first_name": "John",
      "cart_total": 4300,
      "cart_currency": "USD",
      "cart_status_raw": "Submitted",
      "ordered_at": "2024-08-08 08:11:13"
    }
  ]
}

استجابة تغيير حالة طلب Catalog

{
  "status": true,
  "message": "Cart status has been updated successfully"
}