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

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

## رقم واتساب {#number}

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

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

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

## تكاملك {#integration}

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

## بعد الإطلاق {#after}

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