لا تدع أي مكالمة تضيع: حوّلها إلى محادثة واتساب مع أزير

لا تدع أي مكالمة تضيع: حوّلها إلى محادثة واتساب مع أزير

تحويل المكالمات الهاتفية إلى محادثات واتساب مع أزير

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

نظرة عامة على حالة الاستخدام

كثير من الأنشطة التجارية تعتمد على خط هاتفي أو خدمة VoIP لاستقبال مكالمات العملاء. لكن لا يمكن دائمًا الرد على كل مكالمة، خصوصًا خارج أوقات العمل أو عند ازدحام المكالمات، وهنا قد يفقد العميل رغبته في التواصل.

الحل هو منح العميل خيار متابعة التواصل عبر واتساب. بدلًا من ترك المكالمة دون رد، يستقبل العميل رسالة واتساب تتيح له إكمال الحديث في الوقت الذي يناسبه، وتضمن لك عدم ضياع أي فرصة للتواصل معه.


متى تُرسل رسالة الواتساب؟

يمكنك تفعيل إرسال رسالة الواتساب في حالتين رئيسيتين:

  1. عندما يتصل العميل خارج أوقات العمل الرسمية، تُرسل له رسالة واتساب مباشرة تتيح له متابعة طلبه عبر المحادثة.
  2. عندما يختار العميل أثناء المكالمة الانتقال إلى واتساب، على سبيل المثال بالضغط على خيار معيّن في المكالمة مثل الرقم 5 للتواصل عبر واتساب، تُرسل له رسالة الواتساب فورًا.
في كلتا الحالتين تصل الرسالة إلى رقم العميل عبر واتساب، فيتحول التواصل من مكالمة قد تضيع إلى محادثة موثّقة يمكنك متابعتها والرد عليها في أي وقت.

الخيار الأول: إذا كنت تستخدم خطوط أزير

إذا كنت تستخدم خدمة الخطوط من أزير، فنحن نتولى إعداد هذه الحالة لك بالكامل. يتم ربط الخط بواتساب وضبط الحالات التي تُرسل فيها الرسالة، مثل الاتصال خارج أوقات العمل أو اختيار العميل للتواصل عبر واتساب، دون الحاجة إلى أي إعداد تقني من جانبك.

الخيار الثاني: إذا كنت تستخدم مزوّد خطوط آخر

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

قبل الإرسال: شروط القالب

يجب أن يكون القالب معتمَدًا ومنشورًا ومتاحًا بنفس اللغة التي تنوي الإرسال بها. سيفشل طلب الـ API إذا لم يتطابق تنسيق الرسالة مع بنية القالب.

يمكنك معاينة جميع قوالبك من لوحة التحكم للتأكد من نص المتن، ومكوّنات الهيدر، وتصميم الوسائط، وأنواع الأزرار قبل استخدامها في طلبات الـ API. كما يمكنك استخدام نقطة النهاية الخاصة بجلب القوالب للحصول على قائمة القوالب المتاحة والمعتمدة أو استرجاع تفاصيل قالب محدد.

بعد جاهزية القالب، ترسل الرسالة عبر الـ API بتزويده برقم المستلم، واسم أو معرّف القالب، ومعاملات الهيدر أو المتن أو الأزرار حسب الحاجة، وروابط الوسائط للقوالب التي تحتوي صورًا أو فيديو أو مستندات.

نقطة النهاية (Endpoint)

المصادقة تتم عبر ترويسة Authorization بصيغة: Bearer <token>. والمعامل create يُنشئ جهة اتصال جديدة تلقائيًا إذا لم تكن موجودة، وقيمته الافتراضية false.

المعاملات الأساسية

  • to: رقم واتساب المستلم بصيغة E.164، مثال: 9665XXXXXXXX. (مطلوب)
  • type: نوع الرسالة، وقيمته هنا template. (مطلوب)
  • template.template_id: اسم أو معرّف القالب المعتمد المراد إرساله. (مطلوب)
  • template.language: رمز لغة القالب مثل ar أو en، ويجب أن يطابق لغة القالب المعتمدة. (مطلوب)
  • template.argument: القيم المرتبطة بمكوّنات القالب (HEADER / BODY / BUTTONS)، وتُضاف فقط عند وجود هيدر أو متغيرات في المتن أو أزرار تحتاج payload. (اختياري)

مثال على جسم الطلب (Payload)

{
"to": "966555555555",
"type": "template",
"template": {
"template_id": "invoice_created",
"language": "ar",
"argument": {
"HEADER": [
"https://cdn.mottasl.ai/media/.../image.jpeg"
],
"BODY": [
"Abdelaziz",
"19,000"
],
"BUTTONS": [
"inv-234"
]
}
}
}

مثال باستخدام cURL

curl --location 'https://api.mottasl.ai/v1/message/send?create=true' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"to": "966555555555",
"type": "template",
"template": {
"template_id": "invoice_created",
"language": "ar",
"argument": {
"HEADER": [
"https://cdn.mottasl.ai/media/.../image.jpeg"
],
"BODY": [
"Abdelaziz",
"19,000"
],
"BUTTONS": [
"inv-234"
]
}
}
}'

ملاحظات مهمة عند بناء الطلب

  1. راجع بنية القالب أولًا (الهيدر / متغيرات المتن / الأزرار) قبل بناء الطلب، فيجب أن يطابق طلبك مكوّنات القالب وترتيبها بدقة.
  2. رتّب متغيرات المتن حسب موضعها، فالقيم داخل BODY[] موضعية وتملأ {{1}} و {{2}} و {{3}} بنفس الترتيب المعرّف في القالب.
  3. استخدم HEADER فقط عندما يحتوي القالب على مكوّن هيدر، وفي هيدر الوسائط (صورة أو فيديو أو مستند) يجب أن يحتوي HEADER على رابط وسائط صالح ومتاح للوصول العام.
  4. الأزرار تستخدم payloads وليس النصوص الظاهرة، فالقيم داخل BUTTONS[] هي الـ payload الذي يُرجَع عند الضغط (للأتمتة والتتبّع)، ولا تغيّر عنوان الزر الظاهر للعميل.

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

{
"data": {
"id": 53009555,
"message_id": "wamid.HBgM...AA==",
"from_id": "96600008478",
"to_id": "201000000005",
"channel": "whatsapp",
"type": "template",
"direction": "out",
"template_id": 12345
},
"message": "Message sent successfully",
"success": true
}
للاطلاع على التفاصيل الكاملة لواجهة برمجة التطبيقات، راجع التوثيق الرسمي على الرابط: https://docs.azeer.com/api-26232078

لماذا يُفضّل استخدام قالب من نوع Utility

يُفضّل استخدام قالب من نوع Utility في هذه الحالة، لأنه مخصّص للرسائل المرتبطة بإجراء أو طلب قام به العميل، مثل متابعة مكالمة أو طلب تواصل. هذا يجعل الرسالة أكثر توافقًا مع سياسات واتساب ويعطي تجربة أوضح للعميل، إذ تصله الرسالة كاستكمال لتواصل بدأه بنفسه وليس كرسالة تسويقية.

خلاصة

يمكنك عبر أزير تحويل مكالمات خطك الهاتفي أو خدمة VoIP إلى محادثات واتساب في الحالات المهمة، مثل الاتصال خارج أوقات العمل أو رغبة العميل في التواصل عبر واتساب. إذا كنت تستخدم خطوط أزير فنحن نتولى الإعداد بالكامل، وإذا كنت تستخدم مزوّدًا آخر فيمكنك تنفيذ ذلك عبر الـ API لإرسال رسائل القوالب، مع تفضيل استخدام قالب من نوع Utility لضمان تجربة أفضل وتوافق أعلى مع سياسات واتساب.


الأسئلة الشائعة

متى تُرسل رسالة الواتساب للعميل؟

تُرسل الرسالة عندما يتصل العميل خارج أوقات العمل، أو عندما يختار أثناء المكالمة الانتقال إلى واتساب مثل الضغط على خيار معيّن في المكالمة.

هل أحتاج إلى إعداد تقني إذا كنت أستخدم خطوط أزير؟

لا، إذا كنت تستخدم خدمة الخطوط من أزير فنحن نتولى إعداد هذه الحالة لك بالكامل دون أي إعداد تقني من جانبك.

كيف أنفّذ الحالة إذا كنت أستخدم مزوّد خطوط آخر؟

تربط نظام الخطوط لديك بواجهة برمجة التطبيقات الخاصة بإرسال رسائل القوالب في أزير عبر نقطة النهاية POST على api.mottasl.ai/v1/message/send، فيستدعي نظامك الـ API لإرسال رسالة القالب عند حدوث الحالة المطلوبة.

لماذا يفشل طلب الـ API أحيانًا؟

يفشل الطلب إذا لم يكن القالب معتمَدًا ومنشورًا ومتاحًا بنفس اللغة، أو إذا لم يتطابق تنسيق الرسالة ومكوّناتها وترتيبها مع بنية القالب المعتمدة.

ما نوع القالب المناسب لهذه الحالة؟

يُفضّل استخدام قالب من نوع Utility لأنه مخصّص للرسائل المرتبطة بإجراء أو طلب قام به العميل، مما يجعله أكثر توافقًا مع سياسات واتساب.

كيف أتأكد من بنية القالب قبل الإرسال؟

يمكنك معاينة جميع قوالبك من لوحة التحكم لتأكيد نص المتن ومكوّنات الهيدر وأنواع الأزرار، أو استخدام نقطة النهاية الخاصة بجلب قائمة القوالب المعتمدة أو تفاصيل قالب محدد.