أرسل رسائل واتساب من نظامك بطلب API واحد
بطلب واحد إلى POST https://tawked.com/v1/whatsapp/messages يرسل نظامك عبر توكيد للإشعارات (Tawked Notifications) قالب واتساب معتمدًا من Meta إلى رقم جوال في السعودية. يكفيه مفتاح تطبيق من توكيد، فلا تحتاج إلى تطبيق في Meta أو رمز وصول منها، لأن توكيد مزوّد تقني لدى Meta يربط رقم نشاطك من اللوحة ويحفظ رمز Meta عنده.
توكيد للإشعارات خدمة واتساب للأعمال API للمنشآت في السعودية.بلا اشتراك، ورسوم توكيد على الرسالة 0.00 ر.س حاليًا، وتحاسبك Meta بأسعارها مباشرة.
أهم ما في الصفحة
طلب واحد وحقوله
في جسم الطلب to لرقم العميل، وtemplate لاسم القالب، وparams لقيم متغيراته، وlang إذا كان للقالب أكثر من لغة، وreference لمرجعك في سجل الرسائل. وعند الحاجة تضيف header لنص الترويسة أو رابط صورتها، وbuttons لتكملة رابط الزر. وترويسة Idempotency-Key تجعل إعادة المحاولة بالمفتاح نفسه ترجع الرد الأول، دون إرسال ثانٍ أو رسوم ثانية.
متابعة التسليم والقراءة من لوحة توكيد
يعود الطلب بـ202 وفيه id والحالة accepted وprice_halalas، ثم تنتقل الحالة إلى sent فـdelivered فـread، أو إلى failed مع رمز الخطأ. ويتابع توكيد حالة كل رسالة 48 ساعة بعد إرسالها. وتظهر الرسائل التي فشل إرسالها في السجل لمراجعتها.
ويبهوك موقّع إلى خادمك
يبلغ توكيد رابط الويبهوك في تطبيقك بالأحداث message.sent وmessage.delivered وmessage.read وmessage.failed. كل حدث موقّع بـHMAC-SHA256 على طابعه الزمني وجسمه، ويُعاد إرساله حتى 5 مرات إن لم يرد خادمك.
مفاتيح بصلاحيات محددة
الإرسال يحتاج إلى صلاحية notifications:send، وقراءة الحالات والقوالب تكفيها notifications:read، ولكل مفتاح 120 طلبًا في الدقيقة. ويعرض GET /v1/whatsapp/templates قوالب رقمك ومتغيراتها كما هي عند Meta. والمستلم رقم جوال سعودي، وأي رقم آخر يعود بـ422 invalid_destination.
من الحساب الجديد إلى أول رسالة
خمس خطوات، أربع منها في اللوحة. بعدها يقرر نظامك وقت كل رسالة، ويرسلها توكيد حين يطلبها نظامك.
أنشئ حسابك.
سجّل برقم جوالك، واختر توكيد للإشعارات، ثم أضف تطبيقك. وإرسال واتساب يعمل والتطبيق قيد المراجعة، لأن مراجعة توكيد تخص رموز التحقق وحدها.
اربط رقم نشاطك.
تفتح نافذة Meta من اللوحة وتدخل فيها بحسابك على فيسبوك، ويأخذ الربط نحو 10 دقائق. ويصلح لذلك رقم جديد على واتساب، أو رقم تنقله من مزوّد آخر، أو رقم تبقيه على تطبيق واتساب للأعمال وتربطه بالواجهة معًا.
جهّز قالبًا.
اختر من القوالب الجاهزة أو اكتب قالبك، وقد تأخذ مراجعة Meta حتى 24 ساعة.
أنشئ مفتاحًا حيًّا.
من صفحة «مفاتيح API» اختر النوع الحي وصلاحية الإرسال، واحفظ المفتاح في متغيرات البيئة على خادمك. أما مفتاح التجربة فلا يرسل واتساب، ويُرد عليه بـ403 live_key_required.
أرسل وتابع.
جرّب أولًا على جوالك بقالب hello_world من Meta، وهو معتمد في أغلب الحسابات الجديدة، أو بقالبك. ثم أرسل POST /v1/whatsapp/messages من خادمك، وتابع الحالة بالويبهوك.
أسئلة شائعة
كيف أعرف أن الإشعار وصل؟
من حالة الرسالة: تصبح delivered حين تصل إلى جوال العميل، وread حين يفتحها. تراها في سجل الرسائل في لوحة توكيد، ويصل كل تغيير إلى خادمك بويبهوك موقّع. وقد يطفئ العميل إشعارات القراءة في واتساب، وغياب حالة القراءة لا يعني أن الرسالة لم تصل.
هل أحتاج إلى تطبيق في Meta أو رمز وصول لأرسل عبر واتساب API؟
لا. يربط توكيد رقمك من نافذة التسجيل المدمج في Meta ويحفظ رمزها عنده، ويبقى رقمك وحساب واتساب للأعمال في محفظة نشاطك لدى Meta. وإن كان عندك مطورون يريدون الاتصال بـMeta دون وسيط، فواجهة Cloud API من Meta بلا رسوم منصة، لكنهم يبنون بأنفسهم التسجيل وحفظ الرموز والويبهوك وأدوات القوالب وصندوق الردود.
بأي لغة برمجة أستخدم واجهة واتساب في توكيد؟
بأي لغة ترسل طلب HTTPS، مثل PHP وNode.js وPython، ومعها أطر مثل Laravel. الواجهة من نوع REST تعمل دون مكتبة تثبّتها، وفي توثيق توكيد أمثلة جاهزة لكل طلب، والمواصفة الكاملة في https://tawked.com/openapi.json.
هل أجرّب إرسال واتساب بمفتاح التجربة؟
لا. مفتاح التجربة في توكيد يُرد عليه في طلبات واتساب الثلاثة بـ403 live_key_required، لذلك جرّب بمفتاح حي على جوالك قبل أرقام عملائك. ومن اللوحة ترسل القالب إلى جوالك دون مفتاح.
هل يصلني رد العميل عبر ويبهوك؟
لا. أحداث الويبهوك تخص حالة الرسائل التي ترسلها. أما ردود العملاء فتصل إلى توكيد شات، صندوق فريقك للرقم نفسه على الويب والجوال، بجانب الرسالة التي ردّوا عليها.
هل يستطيع مساعد ذكاء اصطناعي أن يرسل رسائل واتساب عني؟
نعم، عبر خادم MCP في توكيد على https://tawked.com/mcp. يدخل المساعد بحسابك بعد موافقتك، ويعرض قوالبك ويفحصها وينشئها ويعدّلها، وقبل أن يرسل أي رسالة يريك معاينتها وينتظر تأكيدك.
ابدأ بإشعار يحتاجه عميلك
أنشئ حسابك برقم جوالك
بلا بطاقة، وبلا عقود.
اربط رقم نشاطك
في نافذة Meta، من داخل لوحة توكيد.
أرسل أول قالب
جرّبه على جوالك من اللوحة، ثم أرسله من نظامك بمفتاح
tk_live_.