EnvoiSMS
تجربة مجانية
سجل التغييرات

API Changelog

كل تغيير يمكن أن يلاحظه المطوّر، مؤرخاً. داخل ‎/v1 لا تتغير الواجهة إلا بالإضافة.

← العودة إلى التوثيقسياسة الإصدارات والإيقاف

أرقام اختبار تجريبية، دليل الأخطاء، سياسة الإصدارات

  • جديد: مع مفتاح تجريبي، يفشل ‎+212600000002، و‎+212600000003 غير قابل للتسليم، و‎+212600000004 ملغى الاشتراك (403 OPTED_OUT)، و‎+212600000005 لا يتلقى إشعاراً أبداً — ولكل منها webhook.
  • تصحيح: كان الإشعار المحاكى للمفتاح التجريبي يُرسل باسم الحدث message.message.delivered؛ وأصبح الآن message.delivered.
  • سياسة الإصدارات: لا يتغير ‎/v1 إلا بالإضافة؛ ويُعلن أي حذف قبل 12 شهراً مع ترويستي Deprecation وSunset على المسار المعني.
  • Webhooks: ‏GET /v1/webhooks/logs وPOST /v1/webhooks/logs/{log_id}/replay لقراءة تسليم وإعادة إرساله.
  • نماذج واتساب: الدوّارات وأزرار FLOW في POST /v1/templates؛ ومراجعة تلقائية من EnvoiSMS قبل Meta ‏(TEMPLATE_PENDING_REVIEW وTEMPLATE_REJECTED_BY_REVIEW).
  • حملات واتساب: template_variables ‏(_header_media_url و_button_<i> و"static:…") وconsent_attested، الإلزامي لنموذج تسويقي (CONSENT_ATTESTATION_REQUIRED).
  • يعيد المسار الخاطئ الشائع (‎/v1/sms و‎/v1/send…) الرمز 404 مع ذكر المسار الصحيح.

واتساب خارج المغرب

  • تُسعَّر رسالة واتساب إلى الخارج حسب سوق Meta الخاص بالمستلم.
  • رمز جديد 429 OTP_COUNTRY_PAUSED: إيقاف رموز التحقق نحو بلد خارج المغرب لليوم عندما يُؤكَّد عدد قليل جداً منها.
  • يمكن لمفتاح API رفع وسائط لإرسال (POST /v1/whatsapp/media/upload)؛ وتبقى تعديلات واتساب الأخرى خاصة بلوحة التحكم.

معرّف مرسل غير مسجّل

  • لم يعد SENDER_ID_NOT_REGISTERED يُعاد: يُرسل معرّف المرسل المخصّص غير المسجّل تلقائياً بالتسعيرة القياسية.

المفاتيح التجريبية

  • يحاكي المفتاح التجريبي مسار التحقق كاملاً (send وresend وcheck) والبحث عن الرقم دون أي فوترة؛ ويُعاد sandbox_code.

التكرار الآمن، webhooks موقّعة v2، البحث عن الرقم

  • ترويسة Idempotency-Key على POST /v1/messages و‎/v1/messages/bulk.
  • X-EnvoiSMS-Signature-256 (بطابع زمني ضد إعادة الإرسال) على كل webhook؛ ولا تزال X-EnvoiSMS-Signature القديمة تُرسل.
  • GET /v1/lookup/{number}: صحة الرقم وبلده ومشغّله.

الإصدار v1 المستقر

  • رسائل SMS نحو المشغلين المغاربة وواتساب للأعمال، تسلسل واتساب ← SMS، وwebhooks تسليم موقّعة.