‏API إدارة حساب واتساب للأعمال‏

رموز QR والروابط القصيرة

يشرح هذا الدليل كيفية إنشاء رموز QR وإدارتها باستخدام API إدارة واتساب للأعمال.

بإمكان العملاء مسح رمز QR ضوئيًا من الهاتف لبدء محادثة بشكل سريع مع نشاطك التجاري. تتيح API إدارة واتساب للأعمال إنشاء رموز QR هذه والروابط القصيرة المرتبطة والوصول إليها.

إذا كان بإمكانك استخدام مدير الأعمال لإدارة رموز QR بدلاً من API، فراجع إدارة رموز QR واتساب.

قبل البدء

ستحتاج إلى ما يلي:

إنشاء رمز QR

لإنشاء رمز QR، أرسل طلب POST إلى نقطة النهاية رقم هاتف واتساب للأعمال > Message Qrdls.

في النص الرئيسي للمنشور، يمكنك تضمين كائن مع تعيين الخاصية prefilled_message على نص الرسالة وتعيين الخاصية generate_qr_image على تنسيق الصورة المفضل، إما SVG أو PNG.

مثال على الطلب

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "prefilled_message": "Cyber Monday",
  "generate_qr_image": "SVG"
}'

مثال على الاستجابة

{
  "code": "4O4YGZEG3RIVE1",
  "prefilled_message": "Cyber Monday 1",
  "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1",
  "qr_image_url": "https://scontent-iad3-2.xx.fbcdn.net/..."
}

الحصول على قائمة رموز QR

للحصول على قائمة بكل رموز QR على رقم هاتف النشاط التجاري، أرسل طلب GET إلى نقطة النهاية رقم هاتف حساب واتساب للأعمال > Message Qrdls.

مثال على الطلب

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Authorization: Bearer EAAJB...'

مثال على الاستجابة

{
  "data": [
    {
      "code": "4O4YGZEG3RIVE1",
      "prefilled_message": "Cyber Monday",
      "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
    },
    {
      "code": "WOMVT6TJ2BP7A1",
      "prefilled_message": "Tell me more about your production workshop",
      "deep_link_url": "https://wa.me/message/WOMVT6TJ2BP7A1"
    }
  ]
}

الحصور على رمز QR

للحصول على معلومات حول رمز QR محدد، أرسل طلب GET إلى نقطة نهاية رقم هاتف حساب واتساب للأعمال > Message Qrdls وقم بإلحاق معرف رمز QR كمعلمة مسار.

مثال على الطلب

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
-H 'Authorization: Bearer EAAJB...'

مثال على الاستجابة

{
  "data": [
    {
      "code": "4O4YGZEG3RIVE1",
      "prefilled_message": "Cyber Monday",
      "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
    }
  ]
}

تحديث رمز QR

لتحديث رمز QR، أرسل طلب POST إلى نقطة النهاية رقم هاتف واتساب للأعمال > Message Qrdls.

في النص الرئيسي للمنشور، يمكنك تضمين الخاصية code مع تعيينها على معرف رمز QR الذي تريد تحديثه، وتعيين الخاصية prefilled_message على نص رمز QR جديد.

مثال على الطلب

curl 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
    "code": "4O4YGZEG3RIVE1",
    "prefilled_message": "Cyber Tuesday"
}'

مثال على الاستجابة

{
  "code": "4O4YGZEG3RIVE1",
  "prefilled_message": "Cyber Tuesday",
  "deep_link_url": "https://wa.me/message/4O4YGZEG3RIVE1"
}

حذف رمز QR

لا تنتهي صلاحية رموز QR تلقائيًا. لحذف رمز QR، أرسل طلب DELETE إلى نقطة نهاية رقم هاتف حساب واتساب للأعمال > Message Qrdls وقم بإلحاق معرف رمز QR الذي تريد إيقاف العمل به كمعلمة مسار.

مثال على الطلب

curl -X DELETE 'https://graph.facebook.com/v19.0/106540352242922/message_qrdls/4O4YGZEG3RIVE1' \
-H 'Authorization: Bearer EAAJB...'

مثال على الاستجابة

{
  "success": true
}

المرجع

معرفة المزيد