تعمل تابيا مع حساب WhatsApp Business الخاص بك. نحن لا نوفر رقم WhatsApp نيابةً عنك، ولا نعيد بيع الرسائل. تُرسل Meta الفاتورة إليك مباشرة عن الرسائل التي ترسلها.
يشرح هذا الدليل كل شيء، من إنشاء الحساب على Meta حتى إرسال أول رسالة.
قبل أن تبدأ
ستحتاج إلى:
- حساب Meta Business Manager. يجب توثيق النشاط التجاري قبل أن تراسل عملاء حقيقيين. بدون التوثيق، تسمح Meta بمراسلة عدد قليل من أرقام الاختبار المسجلة مسبقًا فقط.
- رقم هاتف غير مستخدم حاليًا في تطبيق WhatsApp أو WhatsApp Business. نقل رقم موجود إلى الـ API يخرجه من هذه التطبيقات نهائيًا، لذلك اختر بعناية. كثير من المطاعم تستخدم رقمًا جديدًا لهذا الغرض.
خطّط لأن التوثيق قد يأخذ وقتًا. توثيق النشاط التجاري لدى Meta قد يتم في نفس اليوم أو يستغرق عدة أيام حسب المستندات التي تقدمها.
الخطوة 1: أنشئ تطبيق Meta
اذهب إلى developers.facebook.com ← My Apps ← Create App، واختر النوع Business، ثم أضف منتج WhatsApp إليه. هذا يربط التطبيق بحساب Business Manager وينشئ حساب WhatsApp Business (WABA).
الخطوة 2: أنشئ System User
هذا الجزء يفوته أغلب الناس. الرمز الظاهر في شاشة API Setup لدى Meta رمز مؤقت يتوقف عن العمل بعد 24 ساعة. أنت تحتاج رمزًا دائمًا، وهذا يأتي من System User.
اذهب إلى business.facebook.com/settings ← Users ← System Users ← Add. أعطه اسمًا واضحًا مثل "Tappya Integration" واجعل دوره Admin.
الخطوة 3: امنح الـ System User صلاحية الوصول إلى حساب WhatsApp
وأنت على نفس الـ System User الذي أنشأته، اضغط Add Assets وامنحه:
- WhatsApp Account الخاص بك (الـ WABA)، مع Full control
- الـ App الذي أنشأته في الخطوة 1
إذا تخطيت هذه الخطوة، ستحصل على رمز في الخطوة التالية، لكن كل رسالة ستفشل بخطأ صلاحيات، لأن الـ System User ليس لديه وصول إلى الحساب الذي يُفترض أن يرسل منه.
الخطوة 4: أنشئ الرمز
على الـ System User، اضغط Generate New Token واختر:
- App: التطبيق من الخطوة 1
- Token expiration: Never
- Permissions:
whatsapp_business_messagingوwhatsapp_business_management
تعرض Meta الرمز مرة واحدة فقط. انسخه فورًا. إذا فقدته، لن تستطيع رؤيته مرة أخرى وستحتاج إلى إنشاء رمز جديد.
الخطوة 5: اعثر على المعرّفين
في تطبيقك، اذهب إلى WhatsApp ← API Setup. انسخ Phone number ID وWhatsApp Business Account ID. هذه معرّفات وليست أسرارًا، لذلك يمكنك مشاركتها مع فريقك بأمان.
الخطوة 6: أدخل كل شيء في تابيا
في تابيا، اذهب إلى «الإعدادات» (Settings) ← «المراسلة» (Messaging) ← «القنوات» (Channels) واختر صف WhatsApp. املأ الحقول التالية:
| الحقل | من أين تحصل عليه |
|---|---|
| «معرف رقم الهاتف» (Phone Number ID) | الخطوة 5 |
| «معرف WABA» (WhatsApp Business Account ID) | الخطوة 5 |
| «اسم النشاط» (Business name) | الاسم الذي سيراه العملاء |
| «رمز الوصول» (Access token) | الخطوة 4 |
اضغط «حفظ» (Save). تتغير الحالة إلى «مفعّلة» (Active).
لا يوجد زر تشغيل وإيقاف منفصل لـ WhatsApp. حفظ اتصال مكتمل هو ما يشغّله.
عن رمز الوصول
بعد الحفظ، لا يظهر الرمز مرة أخرى أبدًا. يوضح الحقل أن هناك رمزًا محفوظًا، مع آخر أربعة أحرف منه.
يمكنك ترك حقل الرمز فارغًا عند تعديل أي شيء آخر في الصفحة، وسيبقى رمزك المحفوظ كما هو. اكتب رمزًا جديدًا فقط عندما تريد استبداله فعلًا، مثلًا بعد إنشاء رمز جديد على Meta.
الخطوة 7: وجّه الـ Webhook في Meta إلى تابيا
حتى تصلك ردود العملاء وإشعارات التسليم، اذهب إلى تطبيقك ← WhatsApp ← Configuration ← Webhook واضبط:
- Callback URL:
https://api.tappya.com/v1/messaging/webhooks/whatsapp - Verify token: اطلب هذه القيمة من دعم تابيا
- Subscribe to:
messages
بدون هذه الخطوة، يمكنك إرسال الرسائل لكن لن تستقبل أي ردود أو حالة التسليم.
الخطوة 8: اختر استخدامات WhatsApp
ارجع إلى صف WhatsApp، وشغّل المنتجات التي تريدها:
- «تحديثات الطلبات والحساب» (Order updates): تأكيدات الطلبات وإشعارات التوصيل عبر WhatsApp
- «الحملات التسويقية» (Marketing): الحملات، مع مراعاة موافقة العميل
- «ردود العملاء» (Inbox): تصل الرسائل الواردة إلى «المحادثات» (Conversations)، حيث يرد فريقك وينشئ الطلب مباشرة داخل المحادثة. متاح في الخطط Premium فقط.
لإرسال رموز الدخول عبر WhatsApp، استخدم قسم «إلى أين تذهب رسائلك» (Where your messages go) أعلى الصفحة. يتطلب هذا قالب مصادقة معتمدًا باسم otp على حساب WhatsApp الخاص بك.
قوالب الرسائل
أي رسالة ترسلها بعد مرور 24 ساعة من آخر رسالة من العميل يجب أن تستخدم قالبًا وافقت عليه Meta على حسابك. قدّم القوالب من «الإعدادات» ← «المراسلة» ← «القوالب» (Templates). الموافقة قرار Meta، وتستغرق عادةً من بضع دقائق إلى يوم.
إذا كان هناك شيء لا يعمل
| ما تراه | ماذا يعني عادةً |
|---|---|
| الحالة تبقى «تحتاج إعداد» (Needs setup) | معرف رقم الهاتف أو رمز الوصول ناقص. |
| الرسائل تفشل بخطأ مصادقة | انتهت صلاحية الرمز أو تم إلغاؤه. يحدث هذا إذا حُذف الـ System User، أو تغيّر دوره، أو تم تغيير الـ app secret. أنشئ رمزًا جديدًا وأدخله مرة أخرى. |
| الرسائل تفشل بخطأ صلاحيات | لم يحصل الـ System User على صلاحية الوصول إلى حساب WhatsApp. ارجع إلى الخطوة 3. |
| ردود العملاء لا تصل إلى «المحادثات» | الـ Webhook غير مشترك في messages، أو منتج «ردود العملاء» متوقف، أو خطتك لا تشمل «صندوق وارد الفريق» (Team Inbox). |
| WhatsApp غير متاح (رمادي) لرموز الدخول | الحساب غير متصل بعد، أو لا يوجد قالب معتمد باسم otp. |
| يمكنك مراسلة عدد قليل من الأرقام فقط | نشاطك التجاري غير موثّق لدى Meta بعد. |

