باعتبارك شركة، قد تتطلع إلى إرسال رسائل WhatsApp إلى عملائك تلقائيًا عند وقوع حدث ما يتعلق بالعميل.

‍طريقة واحدة لتحقيق ذلك وذلك باستخدام Interakt تتبع واجهات برمجة التطبيقات لإرسال هذه الأحداث إلى Interakt & settings الحملات المستمرة على Interakt. يجب عليك اختيار هذه الطريقة إذا:

• تريد أن تبقي جهدك في البرمجة إلى الحد الأدنى.

• في هذه الطريقة، تحتاج ببساطة إلى إجراء استدعاءات واجهة برمجة التطبيقات (API) عند وقوع حدث ما في نظامك (موقع الويب/التطبيق/إدارة علاقات العملاء، وما إلى ذلك)

• لا داعي للقلق بشأن تغيير الرسائل التي تريد إرسالها عند حدوث هذا الحدث.

• إذا كان لديك منطق معقد عندما تريد إرسال الرسالة، فلن تضطر إلى بناء تلك المنطق. على سبيل المثال:

• لنفترض أنك تريد أن تخرج الرسالة مع بعض التأخير بعد وقوع حدث ما، أو، 

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

• تريد أن تخرج الرسالة بعد الحدث فقط إذا لم يقم المستخدم بإجراء حدث آخر خلال بضع ساعات وما إلى ذلك.

• تريد أن ترى بسهولة نتائج (إحصاءات التسليم/القراءة) لهذه الحملات دون الحاجة إلى إنشاء لوحة خاصة بك لهذا الغرض.

• ملخص حملاتك متاح لك بسهولة على لوحة معلومات حملة Interakt.

• تم إنشاء موقع الويب الخاص بك باستخدام Shopify. لدينا تكامل مباشر مع Shopify! لا تحتاج إلى الاتصال بأي واجهات برمجة تطبيقات لإرسال رسائل WhatsApp عندما يتخلى عميلك عن طلب سلة التسوق/الأماكن وما إلى ذلك.

‍

الطريقة الثانية لتحقيق ذلك يتم ذلك عن طريق استخدام واجهات برمجة تطبيقات إرسال القوالب الخاصة بـ Interakt (الموضحة أدناه) لإرسال الرسائل (القوالب/أجهزة HSM) إلى WhatsApp مباشرة ثم استهلاك خطافات الويب المرسلة بواسطة Interakt والتي تحتوي على معلومات حول ما إذا تم إرسال الرسائل أو تسليمها أو قراءتها أو فشلها. يجب عليك اختيار هذه الطريقة إذا:

• لديك عرض النطاق الترددي للتشفير والموارد من أجل:

• بناء عملية لتمكين التغييرات المتكررة للرسائل التي يجب أن تخرج

• بناء منطق معقد لتحديد موعد إرسال الرسالة.

• لديك بالفعل لوحة يمكنك من خلالها تتبع حملاتك (من القنوات الأخرى) وبالتالي تريد تتبع حملات WhatsApp الخاصة بك في نفس اللوحة.

(أو ربما كنت تستخدم التسويق عبر WhatsApp أداة أتمتة لكلا الأمرين أعلاه)

• يمكنك استخدام هذه الطريقة الثانية أيضًا إذا كنت تريد تشغيل الرسائل القصيرة / رسائل البريد الإلكتروني إذا فشلت رسالة WhatsApp في الوصول إلى العميل.

‍

تفاصيل واجهات برمجة التطبيقات لإرسال النماذج:

اتصل /v1/عام/رسالة/ لإرسال النموذج كما هو مطلوب

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

2. سوف نرسل id ردًا على استدعاء API الخاص بك. هذا id يمكن تخزينها للرجوع إليها في المستقبل. ستتم الإشارة إلى هذا المعرف عند إرجاع خطافات الويب لاحقًا.

URL: https://api.interakt.ai/v1/public/message/

الأسلوب: بريد

رؤوس: 

• المصادقة:

• يمكنك المصادقة عن طريق إرسال مفتاح API مع بيانات الطلب.

• استخدامات آلية المصادقة مصادقة HTTP الأساسية والذي يتطلب منك إرسال مفتاح API مع "أساسي' سلسلة.

• سيبدو زوج المفاتيح في رأس الصفحة كالتالي: "التفويض: أساسي"مفتاح واجهة برمجة التطبيقات>'.

• سيكون مفتاح API متاحًا في لوحة معلومات Interakt في إعدادات المطور: https://app.interakt.ai/settings/developer-setting

‍

• نوع المحتوى:

• يجب عليك تعيين رأس نوع المحتوى إلى 'application/json' لتتمكن من إرسال البيانات إلى نقطة نهاية HTTP API الخاصة بنا.

• حدود المعدل: يوجد حد أقصى لكل دقيقة لعدد طلبات واجهة برمجة التطبيقات، وذلك حسب خطة الاشتراك الخاصة بك. إذا تم تجاوز حد المعدل، فسيتم إرجاع خطأ (رمز الحالة: 429 ورسالة الخطأ: تم تجاوز حد المعدل لهذا المورد).

• خطة النمو - 300 طلب في الدقيقة

• الخطة المتقدمة - 600 طلب في الدقيقة

• خطة المؤسسات - قابلة للتكوين وفقًا لحدود معدل البيانات المسموح بها من Meta

(ملاحظة - لا يمكن الوصول إلى واجهات برمجة التطبيقات العامة في الخطة الأساسية)

 

نص الطلب:

مثال 1:

• إذا كان رأس القالب من النوع النصي ويحتوي على متغير أيضًا

• الجسم يحتوي على متغيرات

• يحتوي القالب على زر CTA واحد يحتوي على عنوان URL ديناميكي

{
 "countryCode": "+xx", /* required */
 "phoneNumber": "xxxxxxxxxx", /* required */
 "type": "Template", /* required */
 "callbackData": "some_callback_data", /* optional string with max length 512 */
 "template": {
   "name": "delivered_alert_101", /* required */
   "languageCode": "en", /* required */
   "headerValues": [
     "Alert" /* value for variable {{1}} in header text*/
   ],
   "fileName": "dummy.pdf", /* optional, and only applicable with document header */
   "bodyValues": [
     "There", /* value for variable {{1}} in body text */
     "1234" /* value for variable {{2}} in body text */
   ],
   "buttonValues": {
     "0" /*button index */ :[
       "12344" /* value for {{1}} for dynamic url in button at index position 0*/
     ]
   }
 }
}

‍

مثال 2:

• إذا كان رأس القالب من نوع وسائط (صورة / فيديو / مستند) - فستحتوي قائمة قيم الرأس على عنصر واحد فقط بقيمة عنوان URL للوسائط

• الجسم يحتوي على متغيرات

• يحتوي القالب على زرين للحث على اتخاذ إجراء - الأول يحتوي على رقم هاتف والثاني يحتوي على عنوان URL ديناميكي.

{
 "countryCode": "+xx", /* required */
 "phoneNumber": "xxxxxxxxxx", /* required */
 "type": "Template", /* required */
 "callbackData": "some_callback_data", /* optional string with max length 512 */
 "template": {
   "name": "delivered_alert_101", /* required */
   "languageCode": "en", /* required */
   "headerValues": [
     "https://interaktstorage.blob.core.windows.net/mediastoragecontainer/91e5634a-33b0-44b4-a075-884778f02feb/message_template_sample/tcITOHfOz6vy.png?se=2026-08-13T11%3A53%3A58Z&sp=rt&sv=2019-12-12&sr=b&sig=PDn3cPLmV%2BYu3D7Wd10JYmPLQeyGyytl013wAtmbL6g%3D" /* media url for the header's media file */
   ],
   "bodyValues": [
     "There", /* value for variable {{1}} in body text */
     "1234" /* value for variable {{2}} in body text */
   ],
   "buttonValues": {
     "1" /*button index */ :[
       "12344" /* value for {{1}} for dynamic url in button at index position 0*/
     ]
   }
 }
}

 

هيئة الاستجابة:

{
 "result": true,
 "message": "Message created successfully",
 "id": "6c2d7175-fddd-4fbf-b0eb-084f170dbe08"
}

 

استخدم id تم إرجاع معرف الرسالة. ويمكن استخدامه للإشارة إلى رسائل webhooks.

‍

حقل الوصف

رقم التليفونرقم هاتف المستخدم، تأكد من أنه لا يحتوي على رمز الدولة أو الرقم "0" (صفر) في بدايته.

الرقم الدوليرمز البلد الخاص بهاتف المستخدم

النوع: نوع الرسالة التي سيتم إرسالها

القيم المدعومة: القالب

اسم القالب

تأكد من إنشاء القالب في Interakt. اسم القالب الذي سيتم استخدامه هو الاسم الرمزي للقالب. كيفية الحصول على اسم الرمز؟

• انتقل إلى البرنامج المساعد في التأليف  https://app.interakt.ai/templates/list.

• انقر على القالب الذي تريد استخدامه

• سيكون للصفحة التي يتم فتحها عنوان URL التالي: https://app.interakt.ai/template/اسم الرمز/منظر

• الاسم الرمزي = الجزء من عنوان URL بين 'template/' و '/view'

OR، إذا كنت تريد استخدام قالب قمت بإنشائه في Facebook Business Manager، فيرجى النقر فوق "مزامنة". https://app.interakt.ai/templates/list وبعد اكتمال المزامنة سترى القالب يظهر في القائمة.

رمز اللغة

يجب أن يتطابق رمز اللغة مع اللغة التي أنشأت بها القالب. يمكنك العثور على جميع رموز اللغة هنا: https://developers.facebook.com/docs/whatsapp/api/messages/message-templates/

headerValues ​​/ bodyValues ​​/ ButtonValues 

قيم المتغيرات الموجودة في القالب

• الرأس (إذا كان نوع الرأس نصًا ويوجد متغير فيه أو إذا كان نوع الرأس وسائط)

• الجسد

• الزر (فقط في حالة وجود عنوان URL ديناميكي في الزر)

 

مثال 3: كيفية إرسال البيانات ضمن أزرار الرد السريع في القالب

(هذا مناسب فقط إذا كنت تستخدم حساب Interakt لإرسال حملات WhatsApp وكان لديك أيضًا روبوت Haptik مباشر. سيتم إرجاع حمولات الزر بواسطة WhatsApp في خطافات الويب الخاصة بهم، عندما ينقر العميل على الزر المعني.)

يوضح المثال أدناه الحمولة التي سيتم استخدامها لقالب يحتوي على:

• رأس مستند

• 1 متغير في الجسم

• 3 أزرار للرد السريع (والحمولات لكل زر)

{
 "countryCode": "+91",
 "phoneNumber": "9999999999",
 "callbackData": "some text here",
 "type": "Template",
 "template": {
   "name": "temp_with_quick_reply_buttons",
   "languageCode": "en",
   "headerValues": [
     "https://interaktstorage.blob.core.windows.net/mediastoragecontainer/07ed4524-9549-481b-ad51-400200cabe0b/message_template_media/UkJYYpHdmCBc.pdf?se=2027-01-14T09%3A53%3A35Z&sp=rt&sv=2019-12-12&sr=b&sig=iJvIT6trhzcb81xg92HytxN2SH8p4YPX8xg5IItCUgQ%3D"
   ],
   "fileName": "Sample Document for testing.pdf",
   "bodyValues": [
     "some text here if any variable in message body"
   ],
   "buttonPayload": {
     "0": ["payload0"],
     "1": ["payload1"],
     "2": ["payload2"]
   }
 }
}

‍

المعلمة المستخدمة

ButtonPayload

الوصف

أنواع البيانات المدعومة - يُسمح فقط بنوع بيانات السلسلة النصية للحمولة. تُقبل أي أحرف مثل @، %، * أو مسافة، بالإضافة إلى القيم الأبجدية الرقمية، ولكن فقط ضمن نوع بيانات السلسلة النصية مثل

"12 345abc() ؟ ! . # % @ ^ = + - & * ` ~ ; : < > { }"

الحد الأقصى لعدد الأحرف في الحمولة - الحد الأقصى لعدد الأحرف في الحمولة هو 128 حرفًا.

ملاحظات: يبدأ ترقيم الأزرار بالرقم 0. ويمكن أن يكون هناك 3 أزرار كحد أقصى.

واجهة برمجة تطبيقات إرسال قوالب واتساب من Interakt

لتتبع حملة API لقالب إرسال تحليلاتك، يمكنك إنشاء حملة API وتتبع التحليلات على لوحة معلومات Interakt نفسها. انقر اضغط هنا لمعرفة المزيد عن حملات API.

لضمان تسجيل تحليلات حملة API على لوحة معلومات Interakt، استخدم "معرف الحملة" القيمة التي تم تلقيها في الاستجابة أثناء استدعاء واجهة برمجة التطبيقات "Create API Campaign".

مثال 

طلب الهيئة

curl --location 'https://api.interakt.ai/v1/public/message/' \
--header 'Authorization: Basic {{YOUR_API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
    "countryCode": "+91",
    "phoneNumber": "9999999999",
    "campaignId" : "YOUR_CAMPAIGN_ID",
    "callbackData": "some text here",
    "type": "Template",
    "template": {
        "name": "template_name_here",
        "languageCode": "en",
        "bodyValues": [
            "body_variable_value_1",
            "body_variable_value_n"
        ]
    }
}'

ملاحظات: في حالة عدم ذكر "معرف الحملة"في الجسم، ستظل الحملة مستمرة أرسلت ولكن لن يتم تسجيل التحليلات في لوحة معلومات Interakt.