ساعي للمطورين

أرسل رسائل واتساب، واستقبل الردود وتحديثات التسليم، واربط أنظمتك بواجهة برمجية واحدة.

الرابط الأساسي

https://api.saei.automize.sa/v1

كل الطلبات تُرسل إلى هذا الرابط عبر HTTPS، مع مفتاحك في ترويسة Authorization.

أرسل أول رسالة في ثلاث خطوات

1
أنشئ مفتاح اختبار من المطورين ← مفاتيح API. مفاتيح الاختبار تحاكي كل شيء ولا تصل إلى واتساب أبدًا.
2
أرسل رسالة إلى الرقم التجريبي ‎+966500000001، وستمر بحالات الإرسال والتسليم والقراءة.
3
أضف نقطة استقبال ويب هوك وتابع وصول أحداث التسليم موقّعة.

البدء السريع

على هاتف العميلشكل تقريبي

نشاطك التجاريحساب أعمال

اليوم

أهلًا سارة! طلبك جاهز للاستلام 🎉

9:41

ثم تصلك أحداث الويب هوك هذه

أُرسلتmessage.sent
وصلتmessage.delivered
قُرئتmessage.read

مثال

curl -X POST https://api.saei.automize.sa/v1/messages \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "to": "+966501234567",
  "type": "text",
  "text": {
    "body": "أهلًا سارة! طلبك جاهز للاستلام 🎉"
  },
  "reference": "order-10482"
}'

الاستجابة

قبلها واتساب (أو المحاكي في وضع الاختبار).

{
  "id": "msg_48213",
  "object": "message",
  "livemode": false,
  "direction": "outbound",
  "channel": "whatsapp",
  "from": "+966112345678",
  "to": "+966501234567",
  "type": "text",
  "text": {
    "body": "أهلًا سارة! طلبك جاهز للاستلام 🎉"
  },
  "status": "accepted",
  "error": null,
  "reference": "order-10482",
  "conversation_id": "conv_311",
  "provider_message_id": "wamid.HBgMOTY2NTAxMjM0NTY3FQIAERgSMEM4",
  "created_at": "2026-10-01T09:30:00Z",
  "updated_at": "2026-10-01T09:30:00Z"
}

تصفّح حسب المورد

كل الموارد

مفاهيم مهمة

نافذة الـ24 ساعة: لا تصل الرسائل الحرة إلى العميل إلا خلال 24 ساعة من آخر رسالة منه، وخارجها أرسل قالبًا معتمدًا.; اقرأ الدليل
العناصر والمعرّفات: لكل عنصر معرّف ببادئة (msg_ وct_ وconv_ وcmp_…). احفظ المعرّفات كنصوص معتمة.; اقرأ الدليل
أحداث بدل الاستعلام المتكرر: ترسل الرسائل وجهات الاتصال والمحادثات والقوالب والحملات والتدفقات تغيّراتها إلى نقطة استقبالك، موقّعة وفق Standard Webhooks.; اقرأ الدليل