تخطَّ إلى المحتوى
عرض بصيغة Markdown

الانتقال للتشغيل

قبل أن تستبدل مفتاح الاختبار بمفتاح تشغيل، راجع هذه القائمة.

رقم واتساب#

  • رقم واتساب مربوط من الإعدادات ← أرقام واتساب وحالته تسمح بالإرسال.
  • قوالبك معتمدة من واتساب. القالب قيد المراجعة يُرجع template_not_approved.

قواعد يفرضها واتساب#

  • نافذة الـ24 ساعة. الرسائل الحرة (النص وغيره من الأنواع غير القوالب) لا تُسلَّم إلا خلال 24 ساعة من آخر رسالة من العميل، وإلا فأرسل قالبًا. تتحقق الواجهة من ذلك قبل الإرسال وتُرجع window_closed، فلا تضيع رسالة بصمت.
  • الموافقة. لا ترسل القوالب التي تبدأها أنت إلا لمن وافق على استقبالها. ولجهة اتصال غير موافِقة تطلب الواجهة "consent_confirmed": true، وتُسجَّل كل موافقة في سجل التدقيق.
  • إلغاء الاشتراك. عندما يطلب العميل التوقف، توقّف. جهات الاتصال التي ألغت الاشتراك مُعلَّمة في البوابة.
  • الجودة والحدود. يحدد واتساب عدد العملاء الجدد الذين يمكن للرقم مراسلتهم يوميًا ويراقب معدلات الحظر، والإرسال الرديء يخفض هذه الحدود.

تكاملك#

  • المفاتيح في مدير أسرار أو متغيرات بيئة، مفتاح لكل تكامل، بأقل الصلاحيات اللازمة.
  • كل طلب POST يحمل Idempotency-Key، وإعادة المحاولة تستخدم المفتاح نفسه.
  • تُعاد محاولة 429 و5xx مع زيادة الانتظار تدريجيًا، وتُصلح بقية أخطاء 4xx ولا تُعاد.
  • منطقك يعتمد على error.code ويسجّل Request-Id.
  • نقطة الاستقبال تتحقق من التواقيع، وتجيب خلال 15 ثانية، وتتجاهل التكرار بالاعتماد على webhook-id.
  • توجد نقطة استقبال حية: نقاط الاختبار لا تستقبل الأحداث الحية أبدًا.

بعد الإطلاق#

  • راقب المطورون ← السجلات للأخطاء، والمطورون ← الويب هوك لعمليات الإرسال الفاشلة.
  • إذا تسرّب مفتاح فألغِه فورًا وأنشئ مفتاحًا جديدًا.