تفاصيل الطلب متاحة فقط لحسابات الدفع البرازيلية، وجميع المبالغ موجودة برقم BRL.

نظرة عامة
تتيح تفاصيل طلبات واتساب للأعمال التجارية إرسال طلب دفع للعميل، وهو طلب مفصل بالمبلغ الإجمالي، وخيار دفع أو أكثر من خيارات الدفع البرازيلية، مباشرة داخل محادثة واتساب. يمكن للعميل الدفع دون مغادرة واتساب (على سبيل المثال، نسخ رمز بيكس الديناميكي إلى تطبيقه البنكي أو فتح رابط دفع)، ثم يقوم العمل بتحديث تقدم الطلب برسالة حالة الطلب.

في NewAge Ai يتم تقديم الميزة من خلال خطوتين تدفق:

• تفاصيل الطلب واتساب — ترسل رسالة الطلب/الفاتورة مع خيار الدفع.
• حالة الطلب واتساب — ترسل رسالة متابعة تحدث حالة الطلب وحالة الدفع (مثل المعالجة، الشحن، الدفع).

الخطوتان كما تظهران في منشئ التدفق، كل واحدة تحتوي على فرع "إذا فشل إرسال واتساب".

كلاهما ميزات قالب رسائل واتساب، لذا يجب إنشاء القالب الأساسي في NewAge Ai وموافقته من قبل ميتا قبل استخدامه لإرسال الرسائل.

كيف يعمل

1. يتحدث العميل مع الشركة ويختار ما يشتري.
2. يرسل العمل رسالة عبر واتساب تحتوي على تفاصيل الطلب المفصل، والمجموع بالدولار البريالي، وخيارات الدفع.

1. يدفع العميل — بالنسبة لبيكس ينسخ رمز بيكس ويدفع في تطبيق البنك الخاص به؛ وبالنسبة لرابط الدفع الذي يفتحه جهاز الدفع في متصفحه؛ أما في بوليتو فينسخ رمز بوليتو.
2. ترسل الشركة رسالة حالة الطلب عبر واتساب لتحديث الطلب (مثل "معالجة") وحالة الدفع.

كل طلب يحمل معرف مرجعي فريد (يظهر للعميل ك "Nº da cobrança"). واتساب لا يقوم بمطابقة المدفوعات نيابة عنك — مزود خدمة الدفع (PSP) يؤكد الدفع، وتتناسبه مع الطلب باستخدام هذا المعرف المرجعي.

المتطلبات
قبل أن تتمكن من استخدام تفاصيل الطلب، تحتاج:

• رقم واتساب برازيلي متصل بمساحة عمل NewAge Ai الخاصة بك.
• قالب رسالة تفاصيل الطلب المعتمد (انظر "إنشاء قالب تفاصيل الطلب"). لا تسمح ميتا بإرفاق خيارات الدفع عند وقت إنشاء القالب — تتم إضافتها فقط عند إرسال الرسالة.
• للاختبار، يتم استخدام رقم برازيلي ثاني لاستقبال الرسائل. لا يمكن تسليم الرسائل إلى أرقام الهاتف الأرضي (انظر "القيود المعروفة").

إنشاء قالب تفاصيل الطلب
رسائل تفاصيل الطلب ترسل من قالب معتمد. لإنشاء نموذج في NewAge Ai:

1. افتح مدير القوالب في قناة واتساب واضغط على إضافة قالب جديد.
2. املأ حقول القالب:
   • الاسم (مطلوب، حتى 200 حرف) — يجب إدخاله بالإنجليزية، بحروف صغيرة مع خطوط سفلية، مثل test_order_details.
   • الفئة / النوع (مطلوب) — اختر المنفعة أو التسويق.
   • اللغة (المطلوبة) — يجب أن تتطابق لغة نص الجسم/التذييل مع هذا الاختيار (مثل البرتغالية (BR)).
3. تحت مكون التفاعل، اختر تفاصيل الطلب. يظهر وسم "البرازيل فقط"، مما يؤكد أن القالب مخصص للمدفوعات البرازيلية في BRL. (الخيارات الأخرى — الأزرار، طلب إذن الاتصال — هي أنواع قوالب مختلفة.)
4. اختر نوع الرأس — لا شيء، نص، صورة، أو مستند. اختر مستند لإرفاق ملف PDF (مثل فاتورة أو بوليتو) في الرأس.
5. اكتب النص (مطلوب، حتى 1,000 حرف). استخدم رمز المتغير (</>) لإدراج عناصر مؤقتة مثل اسم العميل، والمبلغ، وتاريخ الاستحقاق.
6. يمكنك إضافة تذييل اختياري (حتى 60 حرفا).
7. انقر على إرسال للمراجعة. يتم تقديم القالب إلى الميتا، وتصنيفه، ومراجعته. بمجرد الموافقة، تصبح حالته نشطة ويمكن استخدامه لإرسال الرسائل.

إنشاء قالب تفاصيل الطلب في NewAge Ai (فئة: تسويق أو مصلحة، اللغة: البرتغالية (BR)، المكون التفاعلي: تفاصيل الطلب).

قاعدة الرأس لا يمكن تغيير نوع الرأس بعد إنشاء القالب. يسمح Meta فقط بالتعديلات اللاحقة على القوالب التي تم إنشاؤها باستخدام صورة أو رأس مستند — لذا إذا احتجت يوما إلى تحديث القالب، قم بإنشائه مع صورة أو رأس مستند من البداية.

ملاحظة المعاينة المعروضة أثناء بناء القالب (زر "مراجعة ودفع" واحد) ليست تمثيلا دقيقا للرسالة النهائية. طرق الدفع وأزرارها ليست جزءا من القالب؛ تضاف عند إرسال الرسالة، وتحدد تسميات الأزرار بواسطة ميتا.

إرسال الرسالة: خطوة تفاصيل الطلب على واتساب

أضف خطوة تفاصيل طلب واتساب إلى تدفقك واختر القالب المعتمد. عند إعداد الخطوة التي تحددها:

• طريقة الدفع — طريقة الدفع البرازيلية التي يمكن تقديمها (رمز Dynamic Pix، Boleto، رابط الدفع، أو البطاقة). راجع "طرق الدفع" أدناه.
• نوع العنصر — مثل السلع الرقمية.
• اسم العنصر — العنصر الظاهر على بطاقة الطلب، مثل دفع الفاتورة.
• المبلغ الإجمالي — المبلغ بالبرازيلاند (مثلا 500.00).
• معرف المرجع — معرف الرسوم/الطلب الفريد (يظهر للعميل باسم "Nº da cobrança").
• متغيرات الجسم — قيم للعوامل المؤقتة المعرفة في القالب (مثل الاسم، المبلغ، تاريخ الاستحقاق). إذا كان الرأس مستندا، فإنك تقدم أيضا عنوان URL لملف PDF واسم ملف.

يمكن تعيين كل قيمة كافتراضية في القالب أو تقديمها كقيمة وقت تشغيل عند إرسال الرسالة (على سبيل المثال، من حقل المستخدم أو من مخرج خطوة سابقة).

إذا لم يكن بالإمكان إرسال الرسالة، فإن فرع "إذا فشل إرسال واتساب" في الخطوة يوجه جهة الاتصال إلى الخطوة التالية التي تختارها (انظر "معالجة الأخطاء واستكشاف الأخطاء").

تحديث الطلب: خطوة حالة طلب واتساب
أضف خطوة حالة طلب واتساب لإرسال تحديث التقدم لطلب موجود. تقوم بإعداد:

• النص (حتى 1,024 حرفا) — نص الرسالة؛ يمكنك تضمين حالة الطلب والدفع عبر المتغيرات.
• التذييل (حتى 60 حرفا) — اختياري.
• حالة الطلب وحالة الدفع — القيم المنظمة التي تدفع حالة الطلب في واتساب. القيم المسموح بها مدرجة أدناه.
  

حالة الطلب (order_status) | حالة الدفع (payment_status)

تم إلغاء المعالجة المعلقة partially_shipped الشحن مكتمل | فشل الاستيلاء في انتظار الوقوع

طرق الدفع
يدعم Order Details طرق الدفع البرازيلية أدناه. يتم إنشاء وتوظيف تسميات الأزرار بواسطة Meta ولا يمكن تخصيصها:

• رمز Pix الديناميكي — زر "Copiar código Pix". توفر رمز Pix و merchant_name والمفتاح و key_type (مثل CNPJ)؛ تقوم Meta بعرض زر النسخ تلقائيا.
• بوليتو — زر "Copiar código do boleto".
• رابط الدفع — زر "Abrir link de pagamento".
• بطاقة (فيزا / ماستركارد) — تظهر في صف "Pagar com".

عندما يتم تكوين أكثر من خيار دفع، يرى العميل الخيار الرئيسي كأزرار مباشرة، بينما يرى الخيارات المتبقية تحت زر "Mais formas de pagar" ("طرق أكثر للدفع"). تعتمد الأزرار الدقيقة التي يتم عرضها على طريقة الدفع ويتم التحكم بها بواسطة ميتا.

ما يراه العميل
تظهر رسالة تفاصيل الطلب كبطاقة تحتوي على المبلغ الكلي، صف "Pagar com" لأيقونات طرق الدفع المتاحة، نص النص، وأزرار الدفع. تظهر رسالة حالة الطلب المنفصلة حالة الطلب الحالي وحالة الدفع.

مثال: رسالة تفاصيل الطلب بقيمة 100,000 ريال بلغاري (Pix، Boleto، Visa وMastercard) مع أزرار "Copiar código Pix"، "Abrir link de pagamento" و"Mais formas de pagar"، تليها تحديث حالة الطلب.

القيود والمشاكل المعروفة

• نوع الرأس دائم. لا يمكنك تغيير نوع رأس القالب بعد الإنشاء، ويسمح Meta فقط بالتعديلات على القوالب التي تم إنشاؤها باستخدام صورة أو رأس مستند.
• تثبت تسميات الأزرار بواسطة Meta. لا يمكن تخصيص نص زر الدفع (مثل "Copiar código Pix") النص؛ يتم توليده وتعريبه بواسطة Meta إلى لغة القالب. يفشل نص الأزرار المخصص في التحقق من Meta API.
• رأس PDF فقط في القوالب. يدعم رأس PDF/المستند في قوالب تفاصيل الطلب، وليس في رسائل تفاصيل الطلب التفاعلية.
• تحميل PDF على الجوال. خلال الاختبار، لم يكن بالإمكان تنزيل ملف PDF مرفق في الرأس على تطبيق واتساب على الأندرويد، لكن تم تنزيله بشكل صحيح على تطبيق واتساب لسطح المكتب وواتساب ويب. يبدو أن هذه مشكلة من جانب الميتا — تحقق من حسابك.
• لا يوجد توصيل إلى أرقام الهاتف الأرضي. لا يتم تسليم الرسائل إلى أرقام الهاتف الأرضي؛ الإرسال إلى رقم واتساب للأعمال القياسي يعمل. غير قابل للتسليم يرسل رسالة خطأ ميتا 131026 ("الرسالة غير قابلة للتسليم").
• طرق الدفع ليست محددة عند الإنشاء. يمكن ربط خيارات الدفع فقط عند إرسال الرسالة، لذا تختلف معاينة البناء عن الرسالة النهائية.

معالجة الأخطاء وحل المشكلات

• فرع "إذا فشل إرسال واتساب". كلتا الخطوتين تكشف هذا الفرع؛ ربطه بخطوة احتياطية (مثل إخطار وكيل، إعادة المحاولة، أو إرسال رسالة بديلة) حتى لا تتوقف جهات الاتصال عند فشل الإرسال.
• خطأ 131026 — "الرسالة غير قابلة للتسليم". يظهر عادة عند الإرسال إلى هاتف أرضي أو رقم لا يستطيع استقبال الرسالة. تأكد من أن رقم المستلم غير متصل بواتساب.
• رسائل واردة مكررة. إذا كانت الرسائل مكررة بعد الاتصال بالرقم، اذهب إلى إعدادات فيسبوك → والخصوصية → تكاملات الأعمال وقم بإزالة تكامل "NewAge Ai" المكرر (اترك تكامل تطبيق الدردشة الروبوت كما هو).
• أحيانا تظهر "فشل الإرسال" أثناء اختبار القالب. أثناء التحقق من صحة قالب جديد كليا، قد ترى إشعارات "إرسال فاشل" بين الحين والآخر؛ يمكن أن تحدث هذه قبل أن يصبح القالب نشطا بالكامل.

المرجع التقني (API)

معظم المستخدمين يخصصون كل شيء من خلال الخطوات NewAge Ai أعلاه ولن يحتاجوا إلى واجهة برمجة التطبيقات مباشرة. يتم تلخيص هياكل الميتا و NewAge Ai الأساسية هنا للاستخدام المتقدم.

• الفئة: الفائدة أم التسويق.
• display_format: ORDER_DETAILS.
• تنسيق الرأس: نص، صورة، أو مستند.
• المكونات: الرأس، الجسم، التذييل، وكتلة أزرار تحتوي على زر واحد من النوع ORDER_DETAILS.

تستخدم القيم النقدية زوج إزاحة + قيمة واحدة؛ المبلغ الفعلي هو القيمة ÷ التعويض. على سبيل المثال { "قيمة": 55700، "تعويض": 100 } = R$ 557.00.

{ "messaging_product": "واتساب", "recipient_type": "فرد", "إلى": "<RECIPIENT_PHONE_NUMBER>", "type": "template", "قالب": { "الاسم": "<TEMPLATE_NAME>", "اللغة": { "السياسة": "الحتمية", "الرمز": "pt_BR" }, "المكونات": [ { "النوع": "الجسم", "المعاملات": [ { "type": "text", "text": "<CUSTOMER_NAME>" }, { "type": "text", "text": "<REFERENCE_ID>" } ] }, { "type": "button", "sub_type": "order_details", "مؤشر": 0، "المعاملات": [ { "النوع": "الفعل"، "action": { "order_details": { "reference_id": "<REFERENCE_ID>", "النوع": "السلع الرقمية", "payment_type": "بر"، "payment_settings": [ { "type": "pix_dynamic_code", "pix_dynamic_code": { "رمز": "<DYNAMIC_PIX_COPY_PASTE_CODE>", "merchant_name": "<MERCHANT_NAME>", "المفتاح": "<PIX_KEY>", "key_type": "CNPJ" } } ], "العملة": "BRL", "total_amount": { "القيمة": 55700، "إزاحة": 100 }, "الترتيب": { "الحالة": "قيد الانتظار"، "العناصر": [ { "retailer_id": "<ITEM_ID>", "الاسم": "<ITEM_NAME>", "المبلغ": { "القيمة": 55700، "التعويض": 100 }, "الكمية": 1 } ], "المجموع الفرعي": { "القيمة": 55700، "الإزاحة": 100 }, "الضريبة": { "القيمة": 0، "التعويض": 100 } } } } } ] } ] }}

ابن اسم القالب واللغة والمعلمات، ثم أرسل القالب المعتمد إلى المشترك:

انشر /api/subscriber/send-whatsapp-template-by-user-id

المرجع

• ميتا — رسالة قالب إرسال تفاصيل الطلب (البرازيل)
• ميتا — واجهة برمجة تطبيقات المدفوعات، البرازيل (نظرة عامة)
• Meta — رفع وسائط واجهة برمجة التطبيقات للرسم البياني (رؤوس المستندات / الصور)