WhatsApp Chatbot API — ابنِ محادثات ذكية

أنشئ روبوتات دردشة مدعومة بالذكاء الاصطناعي ومستجيبات قائمة على القواعد وتدفقات محادثة على WhatsApp. اربط منطقك بواجهتنا وتعامل مع محادثات العملاء تلقائياً.

كيف يعمل روبوت دردشة WhatsApp

يتكون روبوت دردشة WhatsApp من ثلاثة مكونات: طبقة الاتصال وطبقة المعالجة وطبقة الاستجابة. وتتولى واجهتنا طبقة الاتصال بالكامل. وأنت تبني طبقتي المعالجة والاستجابة.

التدفق بسيط:

1. يرسل عميل رسالة إلى رقم WhatsApp الخاص بك
2. تستقبل واجهتنا الرسالة وتعيد توجيهها إلى عنوان URL الخاص بالـ webhook
3. يعالج معالج الـ webhook لديك الرسالة — وهنا يعيش منطق روبوت الدردشة لديك
4. يستدعي معالجك واجهتنا لإرسال رد إلى العميل
5. يستلم العميل الرد في محادثة WhatsApp الخاصة به

تكتمل هذه الحلقة بأكملها عادةً في أقل من 200 مللي ثانية. ويرى العميل الاستجابة شبه فورية، ما يخلق تجربة محادثة طبيعية.

أنماط معمارية لروبوتات الدردشة

النمط 1: روبوت بسيط قائم على القواعد

يستخدم أبسط روبوت دردشة مطابقة الكلمات المفتاحية. عندما يرسل العميل "تتبع الطلب"، يرد الروبوت برابط تتبع الطلب. وعندما يرسل "ساعات العمل"، يرد الروبوت بساعات العمل. يعمل هذا النمط جيداً مع الروبوتات من نوع الأسئلة الشائعة ويمكن تنفيذه في أقل من 50 سطراً من الكود.

# Python example - simple rule-based bot
def handle_message(message):
    msg = message.lower()
    if 'track' in msg or 'order' in msg:
        return 'Track your order here: https://example.com/track'
    elif 'hours' in msg:
        return 'We are open Mon-Fri, 9AM-6PM.'
    elif 'help' in msg:
        return 'Type: track, hours, or contact for support.'
    else:
        return 'I am not sure how to help. Type "help" for options.'

النمط 2: روبوت محادثة ذو حالة

يتتبع الروبوت الأكثر تطوراً حالة المحادثة. ويمر العميل بتدفق — يختار خياراً من قائمة ويقدم معلومات ويؤكد إجراءً. وتعتمد كل خطوة على سابقتها. وتحتاج إلى تخزين حالة المحادثة (في قاعدة بيانات أو Redis أو في الذاكرة) والرجوع إليها عند معالجة كل رسالة جديدة.

هذا النمط مثالي لحجز المواعيد وإجراء الطلبات وتأهيل العملاء المحتملين وأي عملية متعددة الخطوات. يطرح الروبوت سؤالاً وينتظر الإجابة ثم يطرح السؤال التالي وهكذا حتى يكتمل التدفق.

النمط 3: روبوت مدعوم بالذكاء الاصطناعي

اربط webhook لدينا بنموذج ذكاء اصطناعي (OpenAI أو Claude أو أي LLM) ودع الروبوت يتعامل مع المحادثات الحرة. يولّد الذكاء الاصطناعي الاستجابات بناءً على توجيه النظام وقاعدة المعرفة وسجل المحادثة. ويعمل هذا بشكل رائع لدعم العملاء وأسئلة المنتجات والاستفسارات العامة.

// Node.js example - AI-powered bot
app.post('/webhook', async (req, res) => {
    const { message, from } = req.body.data;

    // Call your AI model
    const aiResponse = await openai.chat.completions.create({
        model: 'gpt-4',
        messages: [
            { role: 'system', content: 'You are a helpful support agent for...' },
            { role: 'user', content: message }
        ]
    });

    // Send the AI response back via WhatsApp
    await fetch('https://api2whats.com/send-text', {
        method: 'POST',
        headers: { 'Authorization': 'Bearer ' + API_KEY },
        body: JSON.stringify({
            to: from,
            message: aiResponse.choices[0].message.content
        })
    });

    res.json({ success: true });
});

النمط 4: روبوت هجين

يجمع النهج الأكثر عملية بين القواعد والحالة والذكاء الاصطناعي. فالاستفسارات البسيطة تحصل على استجابات سريعة قائمة على القواعد. والاستفسارات المعقدة تشغّل الذكاء الاصطناعي. وإذا لم يستطع الذكاء الاصطناعي حل المشكلة، تُصعَّد المحادثة إلى موظف بشري. ويمنحك هذا سرعة القواعد ومرونة الذكاء الاصطناعي وشبكة الأمان المتمثلة في الدعم البشري.

بناء روبوت دردشة: خطوة بخطوة

الخطوة 1: إعداد اتصال API

أنشئ حساباً واربط رقم WhatsApp واحصل على مفتاح API الخاص بك. وهيّئ عنوان URL الخاص بالـ webhook في لوحة التحكم أو عبر الواجهة. واختبر وصول الرسائل الواردة إلى خادمك بالتحقق من سجلات webhook.

الخطوة 2: صمم تدفقات محادثتك

ارسم المحادثات التي يحتاج روبوتك إلى التعامل معها. ابدأ بأكثر 5-10 استفسارات عملاء شيوعاً. ولكل استفسار، حدد:

• ما الذي يشغّل التدفق (كلمات مفتاحية أو نوايا أو أوامر مباشرة)
• ما الأسئلة التي يطرحها الروبوت
• ما المعلومات التي يحتاجها الروبوت من العميل
• ما الاستجابة أو الإجراء الذي يقدمه الروبوت
• ماذا يحدث إذا لم يستطع الروبوت المساعدة (مسار التصعيد)

الخطوة 3: نفّذ معالج الـ webhook

اكتب نقطة نهاية خادم تستقبل طلبات POST من واجهتنا. حلّل الرسالة الواردة ومرّرها عبر منطق روبوت الدردشة وأرسل استجابة باستخدام واجهتنا. وتعامل مع الحالات الحدية: الرسائل الفارغة ورسائل الوسائط والرسائل الواردة من أرقام لا تتعرف عليها.

الخطوة 4: اختبر وكرر

اربط رقمك الشخصي كمثيل اختباري. وأرسل رسائل إليه من هاتف آخر. واختبر كل تدفق محادثة. وتحقق من أن الروبوت يتعامل مع المدخلات غير المتوقعة بأناقة. وراقب سجلات webhook بحثاً عن الأخطاء.

الخطوة 5: انشر وراقب

انشر معالج الـ webhook على خادم إنتاج. وهيئ المراقبة لأزمنة الاستجابة ومعدلات الأخطاء ومعدلات اكتمال المحادثات. واستخدم webhooks حالة الرسائل لتتبع معدلات التسليم والقراءة.

حالات استخدام روبوتات دردشة WhatsApp

دعم العملاء

تعامل مع استفسارات الدعم الأكثر شيوعاً تلقائياً: حالة الطلبات وسياسات الإرجاع وساعات العمل وأسئلة الحساب. وقلّل حجم التذاكر بنسبة 40-60% مع تقديم استجابات فورية على مدار الساعة. وصعّد المشكلات المعقدة إلى موظفين بشريين مع سياق المحادثة الكامل.

التجارة الإلكترونية

أرسل تأكيدات الطلبات وتحديثات الشحن وإشعارات التسليم تلقائياً. ودع العملاء يتتبعون طلباتهم بإرسال رقم الطلب. وأوصِ بالمنتجات بناءً على سجل الشراء. وتعامل مع عمليات الإرجاع والاستبدال عبر تدفقات محادثة.

حجز المواعيد

دع العملاء يحجزون المواعيد مباشرة في WhatsApp. واعرض الفترات الزمنية المتاحة واجمع المعلومات اللازمة وأرسل رسائل تأكيد وتعامل مع إعادة الجدولة. وتكامل مع نظام التقويم لديك لمنع الحجز المزدوج.

توليد العملاء المحتملين

أهّل العملاء المحتملين عبر تدفقات محادثة. واسأل عن الميزانية والجدول الزمني والمتطلبات وحجم الشركة. وقيّم العملاء المحتملين تلقائياً وحوّل العملاء المؤهلين إلى فريق المبيعات لديك. وأرسل رسائل متابعة على فترات مجدولة.

أدوات داخلية

ابنِ روبوتات دردشة داخلية لفريقك. روبوتات مساعدة تقنية تتعامل مع إعادة تعيين كلمات المرور وفحوصات حالة النظام. وروبوتات موارد بشرية تجيب عن أسئلة السياسات. وروبوتات عمليات تُبلغ عن صحة النظام وتطلق التنبيهات.

أفضل الممارسات

• اجعل الاستجابات قصيرة — WhatsApp منصة تعطي الأولوية للهاتف. فالفقرات الطويلة تُتجاهل. استهدف جملة إلى ثلاث جمل لكل استجابة.
• استخدم الردود السريعة — عندما يكون ذلك ممكناً، قدم خيارات مرقمة ("أرسل 1 لحالة الطلب و2 لعمليات الإرجاع") بدلاً من الأسئلة المفتوحة.
• وفّر مخرجاً دائماً — يجب أن يكون لكل تدفق محادثة طريقة للوصول إلى موظف بشري. "اكتب 'موظف' للتحدث مع شخص."
• خصّص الرسائل — استخدم اسم العميل وأشر إلى طلبه أو حسابه. فالرسائل المخصصة تحصل على تفاعل أعلى بمقدار 3-5 أضعاف.
• اختبر مع مستخدمين حقيقيين — سيستخدم روبوتك أشخاص حقيقيون لديهم أسئلة حقيقية لم تتوقعها. فاختبر مبكراً وبشكل متكرر.
• راقب وحسّن — تتبع الرسائل التي تسبب الارتباك أو التخلي. وصقّل تدفقاتك بناءً على بيانات الاستخدام الفعلية.

متقدم: دعم متعدد اللغات

إذا كان عملاؤك يتحدثون لغات متعددة، فيجب على روبوت الدردشة لديك التعامل مع ذلك. وهناك نهجان:

اكتشاف اللغة

حلّل الرسالة الواردة لاكتشاف اللغة ثم استجب باللغة نفسها. وبالنسبة للروبوتات القائمة على القواعد، حافظ على مجموعات كلمات مفتاحية منفصلة لكل لغة. وبالنسبة للروبوتات المدعومة بالذكاء الاصطناعي، وجّه النموذج للرد باللغة المكتشفة.

اختيار اللغة

ابدأ المحادثة بمطالبة العميل باختيار لغته: "أرسل 1 للإنجليزية و2 للعربية و3 للإسبانية." هذا أبسط في التنفيذ وأكثر موثوقية من الاكتشاف التلقائي.

تدعم واجهتنا Unicode، لذا تعمل الرسائل بالعربية والعبرية والهندية والصينية وأي نظام كتابة آخر بشكل مثالي. ويتولى عميل WhatsApp نفسه التعامل مع النص من اليمين إلى اليسار.

التكامل مع نماذج الذكاء الاصطناعي

تستخدم أقوى روبوتات الدردشة نماذج لغوية كبيرة لتوليد الاستجابات. إليك كيفية التكامل مع نماذج الذكاء الاصطناعي الشائعة:

OpenAI (GPT-4)

أرسل رسالة WhatsApp الواردة إلى OpenAI API مع توجيه نظام يصف عملك وكيف ينبغي للروبوت أن يستجيب. ومرّر سجل المحادثة للسياق. وأعد استجابة الذكاء الاصطناعي إلى العميل عبر واجهتنا.

Claude (Anthropic)

يشبه تكامل OpenAI. يتفوق Claude في المحادثات الدقيقة واتباع التعليمات المعقدة. استخدم Messages API مع توجيه نظام مصمم خصيصاً لحالة الاستخدام لديك.

النماذج المحلية

بالنسبة للشركات التي تحتاج إلى خصوصية البيانات، شغّل LLM محلياً (مثل Llama أو Mistral) على خوادمك الخاصة. ونمط التكامل هو نفسه — استقبل الرسالة وأرسلها إلى نموذجك المحلي وأعد الاستجابة.

اعتبارات التكلفة: تكلف الروبوتات المدعومة بالذكاء الاصطناعي أكثر لكل محادثة من الروبوتات القائمة على القواعد، لكنها تتعامل مع نطاق أوسع بكثير من الاستفسارات. ابدأ بالقواعد لأهم 20 استفساراً وأضف الذكاء الاصطناعي للذيل الطويل.