بواسطة Avi
نُشر في 20 نوفمبر 2026
عقدة API لروبوت WhatsApp: كيفية الاتصال بنظامك الخلفي أو CRM أو محرك الذكاء الاصطناعي أثناء المحادثة
سرعان ما يصل روبوت المحادثة الذي يرسل رسائل ثابتة فقط إلى طريق مسدود. تتيح عقدة API لروبوت WhatsApp الاتصال بنظامك الخلفي أو CRM أو بوابة الدفع أو محرك الذكاء الاصطناعي أثناء المحادثة، وتخزين الرد، وتحديد المسار بناءً على النجاح أو الإخفاق. تعرّف على الإعداد والاختبار وحالات الاستخدام وأفضل الممارسات.
الخلاصة
- تتيح عقدة API لروبوت WhatsApp الاتصال بنظام خارجي (نظامك الخلفي أو CRM أو بوابة الدفع أو محرك الذكاء الاصطناعي) بينما لا يزال العميل يتحدث.
- يرسل الروبوت طلبًا، وينتظر الرد، ثم يقرر ما سيفعله بعد ذلك.
- في Chakra Chat، تضبط API، وتخزّن الرد في متغير، وتختار القيمة باستخدام مسار JSON، وتوجّه ردود 2xx إلى مسار النجاح وردود غير 2xx إلى مسار الإخفاق.
- استخدمها عندما يتطلب الرد بيانات مباشرةلا رسالة ثابتة.
- أنشئ نقطة نهاية صغيرة، وسيتولى Chakra جانب WhatsApp.
يرسل عميل رسالة إلى رقم WhatsApp الخاص بك: «أين طلبي؟»
لا يستطيع روبوت محادثة أساسي سوى القول: «يرجى إرسال رقم طلبك وسيتواصل معك فريقنا». بعد ذلك، يسجل أحد الموظفين الدخول إلى لوحة التحكم، ويعثر على الطلب، ويكتب ردًا.
ينجح هذا مع 20 محادثة يوميًا، لكنه ينهار عند 2,000.
الحل ليس نصًا أكثر ذكاءً، بل تمكين الروبوت من الاستعلام عن أنظمتك للحصول على الإجابة. وهذا ما تتيحه عقدة API.
ما عقدة API في روبوت المحادثة؟
يتألف تدفق روبوت المحادثة من سلسلة خطوات (عُقد): إرسال رسالة، وطرح سؤال، وإحالة المحادثة إلى موظف، وغير ذلك. عقدة API هي الخطوة التي تتواصل مع العالم الخارجي.
وفقًا إلى Chakra، تتيح هذه العقدة لروبوت المحادثة استدعاء API من داخله، ويمكن استخدام الرد لاحقًا في التدفق.
تخيّلها كمكالمة هاتفية يجريها الروبوت أثناء المحادثة:
- الجهة التي يتصل بها: نظامك الخلفي أو CRM أو بوابة دفع أو محرك ذكاء اصطناعي أو أي خدمة خارجية تابعة لجهة أخرى لديها API
- ما الذي يستعلم عنه: «ما حالة الطلب 4821؟» أو «هل القسيمة DIWALI20 صالحة؟»
- ما الذي يفعله بالإجابة: يعرضها على العميل أو يخزّنها أو يختار الخطوة التالية
استخدمها كلما تطلبت خطوة ما بيانات مباشرة من مصدر خارجي بدلًا من رسالة ثابتة.
كيف تعمل؟
الفكرة بسيطة: طلب، ورد، وقرار.
- يرد العميل. يجمع الروبوت المعلومات اللازمة، مثل رقم الطلب، من خلال عقدة السؤال.
- تُنفَّذ عقدة API. ترسل طلبًا إلى عنوان URL الخاص بك مع البيانات التي جُمعت.
- يرد نظامك. يعيد البيانات (حالة الطلب أو نتيجة القسيمة أو رد الذكاء الاصطناعي) ورمز الحالة.
- يتخذ الروبوت قرارًا. ينقل رد 2xx المحادثة إلى مسار النجاح ، وينقل أي رد آخر إلى مسار الإخفاق .
- يرى العميل النتيجة. تعرض عقدة الرسالة القيمة المخزّنة، أو ينتقل التدفق إلى الخطوة التالية.
رسالة العميل
|
عقدة السؤال (جمع رقم الطلب)
|
عقدة API ---> نظامك الخلفي / CRM / محرك الذكاء الاصطناعي
| |
|<------ الرد ---+
|
2xx؟ ---- نعم ---> الرسالة: «طلبك {{status}}»
|
لا ----------> رد احتياطي: «سأوصلك بفريقنا»
لا تغادر المحادثة WhatsApp أبدًا، وكل ما يراه العميل هو إجابة سريعة ومحددة.
فيمَ يمكنك استخدامها؟
في كل الحالات التي يعتمد فيها الرد على بيانات موجودة في مكان آخر.
| حالة الاستخدام | ما يستعلم عنه الروبوت | ما يحصل عليه العميل |
|---|---|---|
| حالة الطلب | نظام الطلبات لديك | «طلبك في طريقه إليك، وسيصل اليوم» |
| التحقق من القسيمة | محرك العروض الترويجية لديك | «الرمز صالح. ستحصل على خصم 20%» |
| البحث عن العميل | CRM الخاص بك | تحية شخصية وتفاصيل الحساب |
| حالة الدفع | بوابة الدفع | «تم استلام الدفعة، شكرًا لك» |
| حجز موعد | التقويم أو نظام الحجز لديك | المواعيد المتاحة، ثم تأكيد الحجز |
| جمع بيانات العملاء المحتملين | CRM أو Google Sheets | إنشاء عميل محتمل جديد من المحادثة |
| إجابات الذكاء الاصطناعي | محرك الذكاء الاصطناعي أو خدمة RAG لديك | إجابة موثوقة عن سؤال مفتوح |
| التحقق من الهوية (KYC) أو الأهلية | خدمة داخلية أو تابعة لجهة خارجية | «أنت مؤهل، وإليك الخطوة التالية» |
أمثلة حسب المجال
- البيع المباشر للمستهلك والتجارة الإلكترونية: تتبّع الطلبات، والإرجاع، والتحقق من المخزون
- التعليم: حالة الرسوم، ومواعيد الدفعات، والاستعلام عن النتائج
- العقارات: استرجاع بيانات المشاريع والوحدات المتاحة من CRM
- الرعاية الصحية والعيادات: التحقق من المواعيد المتاحة وتأكيد الحجوزات
- الخدمات اللوجستية: تتبّع الشحنات باستخدام رقم AWB
- التمويل والتأمين: حالة وثيقة التأمين، ومواعيد استحقاق الأقساط
الاتصال بمحرك الذكاء الاصطناعي الخاص بك
إذا كنت قد أنشأت طبقة الذكاء الاصطناعي الخاصة بك (مثل خط أنابيب RAG، أو نموذج مضبوط بدقة، أو مساعد دعم)، فإن عقدة API هي الجسر الذي يربطها.
سير العمل:
- اطرح على العميل سؤالًا باستخدام عقدة السؤال
- أرسل النص إلى نقطة نهاية الذكاء الاصطناعي باستخدام عقدة API
- خزّن الإجابة في متغير
- اعرضها في عقدة الرسالة
- إذا فشل الاتصال، فحوّل المحادثة إلى موظف
إليك بعض النصائح:
- أعِد حقل إجابة قصيرًا وواضحًا. يصعب قراءة المخرجات الطويلة على WhatsApp.
- احرص على تقليل زمن الاستجابة. فالعميل يتابع نافذة المحادثة.
- احرص دائمًا على توفير مسار احتياطي، إذ قد تنتهي مهلة نقاط نهاية الذكاء الاصطناعي أو يحدث فيها خطأ.
تتضمن Chakra أيضًا عقدة ذكاء اصطناعي مدمجة و ميزات للذكاء الاصطناعي الحواري. استخدم هذه الميزات عندما تريد الاستفادة من الذكاء الاصطناعي دون كتابة تعليمات برمجية. واستخدم عقدة API عندما تريد إحضار محركك الخاص أو بياناتك أو منطق أعمالك.
إعداد ذلك في Chakra Chat
إليك سير العمل الوارد في دليل عقدة استدعاء APIمن Chakra، موضحًا بخطوات مبسطة.
1. إعداد API المراد استدعاؤه
- اسحب عقدة استدعاء API إلى مساحة العمل، على يمين العقدة التي تجمع الإدخال
- انقر على إظهار المحرر لفتح إعدادات API
- أدخل URL واختر طريقة HTTP
- اختر نوع المحتوى: form url encoded أو form multipart
- أضف أزواج المفتاح والقيمة، مثلًا
order_idواربطه بإجابة العميل - انقر على حفظ API
2. تمرير بيانات المحادثة ضمن الطلب
اكتب {{ في محتوى الطلب للاطلاع على المتغيرات التي يمكنك إدراجها. يمكنك استخدام نص آخر رسالة في المحادثة وأي بيانات جُمعت سابقًا في روبوت المحادثة.
بهذه الطريقة يُدرج رقم طلب العميل أو بريده الإلكتروني في طلبك.
3. تخزين استجابة API في متغير
ضمن تخزين الاستجابة في متغير؟، أدخل اسمًا مثل api_response.
4. اختيار القيمة المطلوبة باستخدام مسار JSON
ضمن مسار JSON للقيمة المطلوب تخزينها؟، أدخل مسار القيمة التي تريدها. تُقرأ الاستجابة عبر المفتاح response.data.
مثال على استجابة من خادمك:
{
"order": {
"id": "4821",
"status": "Out for delivery",
"eta": "Today, 6 PM"
}
}
لتخزين الحالة فقط، استخدم:
response.data.order.status
استخدم المسار لاستخراج القيمة التي تحتاج إليها فقط، لتظل رسائلك واضحة بدلًا من عرض الاستجابة كاملة.
5. التفرّع عند النجاح والإخفاق
للعقدة مخرجان:
- النجاح: استجابة 2xx
- الإخفاق: استجابة غير 2xx
اربط كل مخرج بالعقدة التالية التي تريدها.
6. استخدام المتغير في ردك
أضف عقدة رسالة بعد مخرج النجاح. اكتب @ واختر المتغير، مثلًا:
خبر سار! حالة طلبك هي: @order_status.
احفظ العقدة، ثم احفظ روبوت المحادثة.
مثال بسيط لنقطة نهاية
كل ما عليك فعله من جهتك هو إرجاع JSON. إليك مثالًا مبسطًا باستخدام Node.js (قد يختلف المثال لديك):
app.use(express.urlencoded({ extended: true }));
app.post("/order-status", async (req, res) => {
const order = await db.findOrder(req.body.order_id);
if (!order) {
return res.status(404).json({ error: "Order not found" });
}
res.json({
order: { id: order.id, status: order.status, eta: order.eta }
});
});
ينتقل 404 إلى مسار الإخفاق ، ليتمكن روبوت المحادثة من قول «لم أتمكن من العثور على هذا الطلب» بدلًا من عدم عرض أي شيء.
الاختبار قبل الإطلاق
اختبر على مراحل.
- اختبر نقطة النهاية بشكل مستقل. استخدم أولًا أداة مثل cURL أو Postman. وتأكد من أنها تُرجع رموز الحالة وبيانات JSON المتوقعة.
- اختبر سير العمل في وضع المعاينة ضمن أداة الإنشاء. تتيح لك أداة إنشاء روبوتات المحادثة في Chakra محاكاة محادثة على WhatsApp قبل إطلاقها.
- اختبر الحالات غير المتوقعة. رقم طلب خاطئ، أو رد فارغ، أو تعطل الخادم.
- تحقق من مسار JSON. إذا ظهرت الرسالة فارغة، فعادةً ما يكون المسار غير مطابق للاستجابة.
- اختبر على هاتف حقيقي باستخدام رقم تجريبي قبل تفعيله للعملاء.
ماذا يحدث بعد الاستجابة؟
تخيّل الاستجابة كمفترق طرق.
عند النجاح (2xx):
- اعرض الإجابة في عقدة رسالة
- استخدم القيمة المحفوظة لاحقًا في مسار التدفق
- انتقل إلى السؤال التالي أو أنهِ المحادثة بأدب
عند الإخفاق (غير 2xx):
- أرسل رسالة بديلة ودودة
- أتِح إعادة المحاولة
- حوّل المحادثة إلى موظف بشري باستخدام عقدة Assign to Human
التعامل مع الإخفاقات بفاعلية
قد يتعطّل API أحيانًا. خطّط لذلك.
- لا تترك العميل أبدًا دون رد. يجب أن يكون لكل عقدة API مسار عند الإخفاق.
- استخدم رسائل محددة. عبارة «لم نتمكن من العثور على هذا الطلب. يُرجى التحقق من المعرّف» أفضل من «حدث خطأ ما».
- أتِح التواصل مع موظف. فالإخفاقات هي تحديدًا الحالات التي يضيف فيها الشخص قيمة.
- أعِد رموز حالة واضحة. يتيح لك استخدام 404 لحالة «غير موجود» و500 لحالة «مشكلة في الخادم» التعامل مع كل حالة على النحو المناسب.
- اجعل الاستدعاء سريعًا. تنتظر المحادثة الإجابة، لذا تبدو نقاط النهاية البطيئة كأنها ردود بطيئة.
- لا تستخدمه للمهام الطويلة. إذا كانت المهمة تستغرق دقائق، فابدأها وأرسل النتيجة لاحقًا في رسالة منفصلة.
المزايا الرئيسية
- إجابات مباشرة بدلًا من الردود الجاهزة. يحصل العملاء على بيانات حقيقية في المحادثة.
- عدد أقل من طلبات الدعم لفريقك. تُعالَج الأسئلة المتكررة من البداية إلى النهاية.
- يعمل مع الأنظمة التي تستخدمها بالفعل. لا حاجة إلى نقل بياناتك إلى روبوت الدردشة.
- استخدم منطقك الخاص. تبقى قواعد العمل والتسعير والأهلية والذكاء الاصطناعي ضمن التعليمات البرمجية لديك.
- تدفق يتطلب قدرًا قليلًا من البرمجة، وبرمجة عند الحاجة فقط. تدير فرق العمليات المحادثة، ويتولى المطورون نقطة النهاية.
- قابل لإعادة الاستخدام. يمكن لنقطة نهاية واحدة خدمة تدفقات متعددة.
لماذا لا تبني كل شيء على نظامك الخاص؟
يمكنك ذلك، وبعض الفرق تفعل. إليك ما يتطلبه الأمر:
| المهمة | ابنه بنفسك | استخدم Chakra مع عقدة API |
|---|---|---|
| الاتصال بمنصة WhatsApp Business | تتولى بناءه وصيانته | جاهز للاستخدام |
| استقبال خطافات الويب وتوجيهها | تتولى بناءه | تتم إدارته ضمن المنصة |
| حالة المحادثة ومنطق التدفق | تكتب التعليمات البرمجية وتخزّنها | منشئ تدفقات مرئي |
| إدارة القوالب | تتولى بناءه | إدارة القوالب مدمجة في المنصة |
| صندوق وارد للفريق وتحويل المحادثة إلى موظف | تتولى بناءه | مدمج |
| منطق العمل والبيانات | التعليمات البرمجية لديك | التعليمات البرمجية لديك، ويُستدعى تشغيلها عبر عقدة API |
| تغيير تدفق | تعديل التعليمات البرمجية ونشرها | التعديل في أداة الإنشاء |
ليس الخيار الحقيقي هو «البناء أم الشراء»، بل ما تريد أن يكرّس مطورك وقته له.
- كرّس هذا الوقت لـ منطق العمل: الاستعلام عن الطلبات، والتسعير، والأهلية، والذكاء الاصطناعي
- لا لـ الأعمال التمهيدية: اتصالات WhatsApp، وخطافات الويب، وصندوق الوارد، وأدوات التدفق
متى يكون بناء نظامك الخاص خيارًا مناسبًا؟ إذا كان منطق روبوت الدردشة مخصصًا للغاية، أو كان لا بد من تشغيل كل شيء ضمن بنيتك التحتية. أما بالنسبة إلى معظم الفرق، فالحل الهجين أسرع: تتولى المنصة إدارة المحادثة، ويوفر نظامك الإجابات.
أفضل الممارسات
- أمّن نقطة النهاية. استخدم HTTPS وطريقة للمصادقة. لا تترك نقطة نهاية البيانات مفتوحة أبدًا.
- أعِد JSON موجزًا وبنيةً مسطحة. فهذا أسهل في الربط وأقل عرضة للأعطال.
- حافظ على ثبات أسماء الحقول. قد يؤدي تغيير بنية الاستجابة إلى تعطيل مسار JSON بصمت.
- استخدم أسماء متغيرات واضحة مثل
order_status، وليسdata1. - تحقق من صحة المدخلات أولًا. تحقّق من تنسيق معرّف الطلب في التدفق قبل الاتصال بخادمك.
- احرص دائمًا على إعداد مسار للتعامل مع الإخفاق.
- احترم الخصوصية. أعد فقط ما ينبغي أن يراه العميل، وتحقق من هويته قبل عرض تفاصيل الحساب.
- سجّل الطلبات من جانبك لتتمكن من تصحيح المشكلات.
قيود عليك معرفتها
- تنتظر المحادثة الرد، لذا تؤثر نقاط النهاية البطيئة سلبًا في التجربة.
- ستحتاج إلى مطور لإنشاء نقطة النهاية وتأمينها.
- ستظهر الأخطاء في مسار JSON على شكل قيم فارغة.
- تحقق من الخطة التي تتضمن عقدة Chatbot API في صفحة الأسعار. يتوفر الوصول إلى Developer API وخطافات الويب في الخطط المدفوعة بدءًا من Starter.
لماذا تستخدم الفرق هذه الميزة في Chakra Chat
تخدم Chakra أكثر من 2,500 عميل في أكثر من 65 دولة، وقد صُمم منشئ روبوتات الدردشة ليكون بسيطًا لفرق الأعمال ومرنًا للمطورين.
- منشئ مرئي مع وضع المعاينة لاختبار التدفقات قبل إطلاقها
- دعم التعايش لتتمكن من الاحتفاظ برقم تطبيق WhatsApp Business. اطّلع على آلية عمله
- لا توجد رسوم إضافية على الرسائل النموذجية
- المساعدة في الإعداد والدعم المستمر
- تطبيقات للأجهزة المحمولة لنظامي iOS وAndroid
- واجهات API للمطورين على apidocs.chakrahq.com لإجراء تكاملات أكثر تعمقًا
هل تريد الاطلاع على أداة الإنشاء؟ استكشف منشئ روبوتات الدردشة على WhatsApp.
الأسئلة الشائعة
ما عقدة API في روبوت دردشة على WhatsApp؟ هي خطوة في التدفق ترسل طلبًا إلى نظام خارجي وتستخدم الرد في المحادثة.
هل يمكن لعقدة API الاتصال بمحرك الذكاء الاصطناعي الخاص بي؟ نعم. أرسل رسالة العميل إلى نقطة نهاية الذكاء الاصطناعي، واحفظ الإجابة في متغير، ثم اعرضها في عقدة رسالة.
ما الذي يحدد النجاح أو الإخفاق؟ رمز حالة HTTP. ينتقل الرد الذي يبدأ برمزه 2xx إلى مسار النجاح. أما أي رد آخر فينتقل إلى مسار الإخفاق.
كيف أختار قيمة واحدة من رد طويل؟ استخدم حقل مسار JSON. تتم قراءة الرد عبر response.data، لذا قد يكون مسار حقل الحالة response.data.order.status.
هل يمكنني تمرير تفاصيل العميل إلى واجهة API الخاصة بي؟ نعم. اكتب {{ في الحمولة لإدراج آخر رسالة في المحادثة أو أي متغير جُمِع مسبقًا.
ماذا لو تعطل الخادم؟ يتبع التدفق مسار الإخفاق. استخدمه لإرسال رد بديل مهذب وتحويل المحادثة إلى موظف.
هل أحتاج إلى كتابة التعليمات البرمجية؟ لن تحتاج إلى كتابة التعليمات البرمجية لتدفق روبوت الدردشة. لكنك ستحتاج إلى مطور لإنشاء نقطة النهاية التي تستدعيها العقدة.
ما الخطة التي أحتاج إليها؟ يتوفر الوصول إلى Developer API وخطافات الويب في الخطط المدفوعة بدءًا من Starter. راجع صفحة الأسعار لمعرفة الخطة التي تتضمن عقدة Chatbot API.
في الختام
روبوت الدردشة الذي لا يرسل سوى رسائل ثابتة هو قائمة خيارات. أما روبوت الدردشة الذي يستطيع الاستعلام من أنظمتك لمعرفة الحقيقة فهو مساعد.
عقدة API هي الخطوة الصغيرة التي تصنع الفرق: اجمع المدخلات، واتصل بنظامك، واحفظ الإجابة، ثم وجّه التدفق بناءً على النجاح أو الإخفاق. ابدأ بحالة استخدام بسيطة، مثل حالة الطلب أو التحقق من قسيمة، ثم انطلق منها.
المراجع
- مساعدة Chakra: استخدام عقدة Call API في روبوت الدردشة
- Chakra Chat: منشئ روبوتات الدردشة على WhatsApp
- Chakra Chat: واجهات API للمطورين
- مستندات Chakra API
- أسعار Chakra Chat