باعتبارك شركة، قد تتطلع إلى إرسال رسائل 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 ديناميكي

 

{

"رمز البلد": "+xx"، /* مطلوب */

"رقم الهاتف": "xxxxxxxxxxxx"، /* مطلوب */

"النوع": "قالب"، /* مطلوب */

"callbackData": "some_callback_data"، /* سلسلة اختيارية بحد أقصى للطول 512 */

"نموذج": {

"الاسم": "delivered_alert_101"، /* مطلوب */

"رمز اللغة": "en"، /* مطلوب */

"قيم الرأس": [

"تنبيه"، /* قيمة المتغير {{1}} في نص الرأس*/

],

"اسم الملف": "dummy.pdf"، /* اختياري، ولا ينطبق إلا مع رأس المستند */

 

"قيم الجسم": [

"هناك"، /* قيمة المتغير {{1}} في النص الأساسي */

"1234" /* قيمة المتغير {{2}} في النص الأساسي */

],

"قيم الزر": {

"0" /*فهرس الزر */ :[

"12344" /* قيمة {{1}} لعنوان URL الديناميكي في الزر الموجود في الفهرس

الموضع 0*/

]

}

}

}

‍

مثال 2:

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

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

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

 

{

"رمز البلد": "+xx"، /* مطلوب */

"رقم الهاتف": "xxxxxxxxxxxx"، /* مطلوب */

"النوع": "قالب"، /* مطلوب */

"callbackData": "some_callback_data"، /* سلسلة اختيارية بحد أقصى للطول 512 */

"نموذج": {

"الاسم": "delivered_alert_101"، /* مطلوب */

"رمز اللغة": "en"، /* مطلوب */

"قيم الرأس": [

“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 */

],

"قيم الجسم": [

"هناك"، /* قيمة المتغير {{1}} في النص الأساسي */

"1234" /* قيمة المتغير {{2}} في النص الأساسي */

],

"قيم الزر": {

"1" /*فهرس الزر */ :[

"12344" /* قيمة {{1}} لعنوان URL الديناميكي في الزر عند موضع الفهرس 0*/

]

}

}

}

 

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

 

{

"النتيجة": صحيح،

"message": "تم إنشاء الرسالة بنجاح"،

“id”: “6c2d7175-fddd-4fbf-b0eb-084f170dbe08”

}

 

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

‍

حقل الوصف

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

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

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

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

اسم القالب

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

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

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

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

• الاسم الرمزي = جزء عنوان URL الموجود بين "قالب/" و"/عرض"

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 أزرار للرد السريع (والحمولات لكل زر)

 

{

"رمز البلد": "+91"،

"رقم الهاتف": "9999999999"،

"بيانات رد الاتصال": "بعض النص هنا"،

"النوع": "القالب"،

"نموذج": {

"الاسم": "أزرار_الرد_السريع_المؤقتة"،

"رمز اللغة": "en"،

"قيم الرأس": [

“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”

],

"اسم الملف": "نموذج مستند للاختبار.pdf"،

"قيم الجسم": [

"بعض النص هنا إن وجد متغير في نص الرسالة"

],

"زر الحمولة": {

"0": ["الحمولة0"]،

"1": ["الحمولة1"]،

"2": ["الحمولة 2"]

}

}

}

‍

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

ButtonPayload

الوصف

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

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

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

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

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

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

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

مثال 

طلب الهيئة

 

حليقة – الموقع "https://api.interakt.ai/v1/public/message/" \

–الرأس "التفويض: {{YOUR_API_KEY}}" الأساسي \

- عنوان "نوع المحتوى: تطبيق / json" \

-بيانات '{

    "رمز البلد": "+91"،

    "رقم الهاتف": "9999999999"،

    "معرف الحملة" : "YOUR_CAMPAIGN_ID", 

    "بيانات رد الاتصال": "بعض النص هنا"،

    "النوع": "القالب"،

    "نموذج": {

        "الاسم": "template_name_هنا"،

        "رمز اللغة": "en"،

        "قيم الجسم": [

            "body_variable_value_1"،

            "body_variable_value_n"

        ]

    }

}'

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