تعد WhatsApp Business API من Twilio خدمة قوية وسهلة الاستخدام تتيح لك التواصل مع المستخدمين على تطبيق المراسلة الشهير.

1.  ستقوم بتوصيل هاتفك الذكي بصندوق الحماية. من Twilio Console ، حدد المراسلة ، ثم انقر فوق "جربه". اختر قسم WhatsApp على الشريط الجانبي الأيسر. ستظهر لك صفحة وضع الحماية في WhatsApp رقم الحماية المخصص لحسابك ، ورمز الانضمام.
2. أنت الآن جاهز لتثبيت تبعيات Python المستخدمة في هذا المشروع: 

pip install  twilio pyngrok

حزم Python الثلاثة التي يحتاجها هذا المشروع هي:

• إطار عمل Django ، لإنشاء تطبيق الويب.
• مكتبة Twilio Python Helper ، للعمل مع رسائل SMS.
• Pyngrok ، لجعل تطبيق Django متاحًا مؤقتًا على الإنترنت للاختبار عبر الأداة المساعدة ngrok.

   3. تشغيل ngrok 

ngrok http 8000

افتح ملف settings.py من دليل الرسائل في محرر النصوص أو IDE. ابحث عن السطر الذي يحتوي على المتغير ALLOWED_HOSTS وقم بتغييره على النحو التالي

ALLOWED_HOSTS = ['.ngrok.io']

إنشاء خطاف ويب WhatsApp

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

سيتضمن الويب هوك لرسالة WhatsApp الواردة معلومات مثل رقم هاتف المستخدم ونص الرسالة. في الرد ، يمكن للتطبيق توفير استجابة لإرسالها مرة أخرى إلى المستخدم. يجب تقديم الإجراءات التي تريد أن يتخذها Twilio ردًا على حدث وارد بلغة مخصصة محددة بواسطة Twilio تستند إلى XML وتسمى TwiML.

إضافة نقطة نهاية جديدة

افتح ملف settings.py من دليل الرسائل مرة أخرى. ابحث عن المتغير INSTALLED_APPS. هذه قائمة بالعديد من السلاسل ، وهي وحدات معيارية في إطار عمل Django. في نهاية القائمة ، تحتاج إلى إضافة إدخال آخر لتسجيل تطبيق whatsapp الذي قمت بإنشائه مسبقًا.

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'whatsapp.apps.WhatsappConfig',   # ← العنصر الجديد
]

افتح الملف views.py من الدليل الفرعي whatsapp. هذا هو المكان الذي ستنشئ فيه نقطة النهاية التي ستتعامل مع رسائل WhatsApp الواردة. استبدل محتويات هذا الملف بما يلي:

from django.http import HttpResponse
from django.views.decorators.csrf import csrf_exempt


@csrf_exempt
def message(self):
    return HttpResponse('Hello!')

وظيفة message () هي وظيفة نقطة النهاية التي سيتم تشغيلها عندما يقوم Twilio بإخطار التطبيق برسالة WhatsApp واردة. في الوقت الحالي ، تقوم هذه الوظيفة بإرجاع استجابة بسيطة بالنص "Hello!".

لتسهيل الوصول إلى نقطة النهاية هذه من خلال تطبيق الويب ، يجب تخصيص عنوان URL لها. افتح ملف urls.py من دليل الرسائل وقم بإضافة إدخال جديد إلى قائمة  urlpatterns كما هو موضح أدناه:

from django.contrib import admin
from django.urls import path
from whatsapp import views    # ← استيراد الدالة

urlpatterns = [
    path('admin/', admin.site.urls),
    path('message', views.message),    # ← اضافة الى المسار
]

استقبال رسائل WhatsApp

الخطوة التالية هي تحديث المنطق داخل نقطة نهاية message () لاستخراج المعلومات حول الرسالة الواردة. استبدل محتويات ملف views.py في دليل whatsapp الفرعي بما يلي:

from django.http import HttpResponse
from django.views.decorators.csrf import csrf_exempt


@csrf_exempt
def message(request):
    user = request.POST.get('From')#
    message = request.POST.get('Body')#
    print(f'{user} يقول {message}')#

    return HttpResponse('مرحبا!')

إرسال رد

from django.http import HttpResponse
from django.views.decorators.csrf import csrf_exempt
from twilio.twiml.messaging_response import MessagingResponse


@csrf_exempt
def message(request):
    user = request.POST.get('From')
    message = request.POST.get('Body')
    print(f'{user} يقول {message}')

    response = MessagingResponse()
    response.message('شكرا على اهتمامك ، سنقوم بالرد في أقرب وقت')
    return HttpResponse(str(response))

إذا كان هذا البوت سيستخدم للإنتاج ، فيُنصح رفعه على استضافة vps 

انا الان اعمل على مشروع (موقع لطلب الطعام) لاحدى المطاعم 

وارغب فى انشاء اعداد بحيث يقوم المستخدم باختيار  الطلب ومن ثم استلم رساله عبر برنامج whatsapp او اى برنامج اخر بمعلومات الطلب لكى يستطيع المطعم باعداد الطلب 

اريد. سؤال. وجوب