إنشاء تكاملات WhatsApp بسرعة باستخدام واجهة برمجة تطبيقات ChatArchitect

قم بتوصيل أنظمتك بسهولة بتطبيق WhatsApp باستخدام واجهة برمجة التطبيقات REST الخاصة بنا - قم بإرسال واستقبال الرسائل، وتتبع حالات التسليم، وإدارة القوالب.

البدء بمرجع واجهة برمجة التطبيقات

1. المقدمة

يوفر ChatArchitect واجهة برمجة تطبيقات بسيطة وموثوقة لدمج رسائل واتساب في أنظمتك أو تطبيقاتك أو أنظمة إدارة علاقات العملاء (CRM). يمكنك إرسال الرسائل النصية والوسائط والرسائل التفاعلية، وتتبع الحالات، وإدارة القوالب، وتخزين البيانات المخصصة - كل ذلك باستخدام طلبات HTTPS بسيطة.

2. البدء السريع

  1. قم بالمصادقة باستخدام بيانات الاعتماد الخاصة بك: استخدم APP_ID و APP_SECRET عبر المصادقة الأساسية.
  2. سجل خطاف الويب الخاص بك
مثال >>>
POST https: //api.chatarchitect.com/webhook
 التفويض: أساسي نوع المحتوى: application/json
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "webhook" : "https://your-server.com/webhook" ,   "webhook_separate" : "false"
 }

 

  1. أرسل رسالتك الأولى
مثال >>>
POST https://api.chatarchitect.com/whatsappmessage
 التفويض: أساسي نوع المحتوى: application/json
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "payload" : {     "type" : "text" ,     "message" : "مرحباً جون، كيف حالك؟"
 } }

 

  1. تلقي تحديثات التسليم عبر Webhook
مثال >>>
{   "النوع" : "حدث الرسالة" ،   "الحمولة" : {     "المعرف" : "ee4a68a0-1203-4c85-8dc3-49d0b3226a35" ،     "النوع" : "تم التسليم"
 } }

3. أنواع الرسائل المدعومة

يكتب وصف حقل المثال
نص رسالة نصية بسيطة رسالة
صورة إرسال الصور (JPG/PNG) عنوان URL الأصلي
صوتي إرسال الصوت (MP3/OGG/AAC) عنوان URL
فيديو إرسال مقاطع الفيديو (MP4) عنوان URL، التسمية التوضيحية
ملف إرسال المستندات اسم الملف، التسمية التوضيحية
موقع إرسال إحداثيات GPS خط العرض، خط الطول
اتصال إرسال معلومات الاتصال اتصال
القائمة / الرد السريع الرسائل التفاعلية خيارات

4. قوالب الرسائل (HSM)

القوالب ضرورية للرسائل الصادرة عن الشركات. يمكنك استرداد أو إنشاء القوالب بسهولة عبر واجهة برمجة التطبيقات (API).

  1. استرداد القوالب المتاحة
مثال >>>
POST https: //api.chatarchitect.com/getHSM
 التفويض: أساسي {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "getHSM" : "true"
 }

 

  1. إرسال قالب جديد
مثال >>>
POST https: //api.chatarchitect.com/submit_template
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "submit_template" : {     "elementName" : "welcome_offer" ,     "languageCode" : "en_US" ,     "category" : "MARKETING" ,     "templateType" : "TEXT" ,     "content" : "مرحبًا {{1}}! رمز الخصم الخاص بك هو {{2}}." ,     "example" : "مرحبًا [جون]! رمز الخصم الخاص بك هو [12345]."
 } }

5. خطافات الويب والأحداث

نوع الحدث وصف
رسالة الرسائل الواردة الجديدة
حدث الرسالة حالات التسليم (مُرسل، مُسلَّم، مقروء، فاشل)
حدث المستخدم اختيار المستخدم/إلغاء الاشتراك

6. أمثلة على مقتطفات التعليمات البرمجية

نود.جي اس

استيراد جلب من "  node-fetch" ؛ ثابت auth = Buffer.from( ` ${APP_ID} : ${APP_SECRET} ` ).toString( "base64" );
 انتظار جلب( "https://api.chatarchitect.com/whatsappmessage" ، {   الطريقة : "POST" ،   الرؤوس : { "Authorization" : `Basic ${auth} ` ، "Content-Type" : "application/json" } ،   النص : JSON .stringify({     القناة : "whatsapp" ،     الوجهة : "96996999699" ،     الحمولة : { النوع : "text" ، الرسالة : "مرحباً جون!" } } ) });


‍

بايثون

 الاستيراد ، مصادقة base64 = base64.b64encode(f "{APP_ID}:{APP_SECRET}" .encode()).decode() r = requests.post(   "https://api.chatarchitect.com/whatsappmessage" , headers={ "Authorization" : f "Basic {auth}" , "Content-Type" : "application/json" }, json={ "channel" : "whatsapp" , "destination" : "96996999699" , "payload" : { "type" : "text" , "message" : "Hi John!" }} ) print(r.json())


‍