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

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

1. مقدمة

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

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

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

 

  1. أرسل رسائلك الأولى
مثال >>>
طلب POST إلى https://api.chatarchitect.com/whatsappmessage
 المصادقة: أساسية Content-Type: application/json
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "payload" : {     "type" : "text" ,     "message" : "مرحباً جون، كيف حالك؟"
 } }

 

  1. تلقي تحديثات التسليم عبر Webhook
مثال >>>
{   "type" : "message-event" ,   "payload" : {     "id" : "ee4a68a0-1203-4c85-8dc3-49d0b3226a35" ,     "type" : "delivered"
 } }

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

يكتب وصف حقل مثال
نص رسائل نصية بسيطة رسالة
صورة أرسل الصور (JPG/PNG) originalUrl
صوتي إرسال الصوت (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" : "مرحباً [John]! رمز الخصم الخاص بك هو [12345]."
 } }

5. روابط الويب والأحداث

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

6. نماذج من مقتطفات التعليمات البرمجية

Node.js

import fetch from  "node-fetch" ; const auth = Buffer.from( ` ${APP_ID} : ${APP_SECRET} ` ).toString( "base64" );
 await fetch( "https://api.chatarchitect.com/whatsappmessage" , {   method : "POST" ,   headers : { "Authorization" : `Basic ${auth} ` , "Content-Type" : "application/json" },   body : JSON.stringify ({     channel : "whatsapp" ,     destination : "96996999699" ,     payload : { type : "text" , message : "Hi John!" } }) });


بايثون

استوردنا  requests و base64. ثم  بتشفير البيانات باستخدام base64.b64encode(f "{APP_ID}:{APP_SECRET}" .encode()).decode().  ، أرسلنا طلب POST إلى   "https://api.chatarchitect.com/whatsappmessage" مع تحديد الرؤوس التالية: { "Authorization" : f "Basic {auth}" , "Content-Type" : "application/json"  و json={ "channel" : "whatsapp" , "destination" : "96996999699" , "payload" : { "type" : "text" , "message" : "Hi John!" }} )  طبعنا البيانات المُرسلة باستخدام print(r.json()).