POST/webhooks/your-whatsapp-web-endpoint

رد وارد واتساب ويب

هذا المسار ليس API تستدعيه. راسل يرسل POST إلى رابط HTTPS الذي تضبطه في إعدادات المطوّر. أعد HTTP 2xx خلال 10 ثوانٍ. يُعاد المحاولة حتى 3 مرات. الوسائط وصف فقط بدون بايتات الملف.

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

مثال الطلب

مثال صحيح: رسالة واردة نصية

curl --location 'https://raselsms.com/webhooks/your-whatsapp-web-endpoint' \--header 'Authorization: Bearer YOUR_WEBHOOK_API_KEY' \--header 'X-API-Key: YOUR_WEBHOOK_API_KEY' \--header 'X-Rasel-Event: whatsapp_web.message.received' \--header 'X-Rasel-Delivery-Id: 6800del123def4567890aaaa' \--header 'Content-Type: application/json' \--data '{"event":"whatsapp_web.message.received","timestamp":"2026-09-05T10:04:00.000Z","data":{"accountId":"session-user-whatsapp-1","conversationKey":"whatsapp_web:session-user-whatsapp-1:963912345678@s.whatsapp.net","remoteChatId":"963912345678@s.whatsapp.net","remoteMessageId":"3EB0AABBCCDDEEFF","from":{"jid":"963912345678@s.whatsapp.net","phone":"+963912345678","displayName":"Ali"},"isGroup":false,"text":"مرحباً، أريد تتبع طلبي","messageType":"text","timestamp":"2026-09-05T10:04:00.000Z","hasMedia":false,"mediaType":null,"mimetype":null,"fileName":null}}'

مثال خاطئ: خطأ: نظامك يعيد 500

curl --location 'https://raselsms.com/webhooks/your-whatsapp-web-endpoint' \--header 'Authorization: Bearer YOUR_WEBHOOK_API_KEY' \--header 'Content-Type: application/json' \--data '{"event":"whatsapp_web.message.received","timestamp":"2026-09-05T10:04:00.000Z","data":{"accountId":"session-user-whatsapp-1","conversationKey":"whatsapp_web:session-user-whatsapp-1:963912345678@s.whatsapp.net","remoteChatId":"963912345678@s.whatsapp.net","remoteMessageId":"3EB0AABBCCDDEEFF","from":{"jid":"963912345678@s.whatsapp.net","phone":"+963912345678","displayName":"Ali"},"isGroup":false,"text":"مرحباً، أريد تتبع طلبي","messageType":"text","timestamp":"2026-09-05T10:04:00.000Z","hasMedia":false,"mediaType":null,"mimetype":null,"fileName":null}}'

راسل سيعيد المحاولة. أعد 2xx حتى لو كنت ستعالج لاحقاً.

مثال الاستجابة

200 — رسالة واردة نصية

{  "ok": true}

500 — خطأ: نظامك يعيد 500

{  "error": "internal"}

راسل سيعيد المحاولة. أعد 2xx حتى لو كنت ستعالج لاحقاً.

طلب HTTP

POST /webhooks/your-whatsapp-web-endpoint

ترويسات الطلب

لا توجد حقول موثّقة في هذا القسم.

جسم الطلب

الحقل	النوع	الوصف
event	enum	اسم حدث الويب هوك. *
timestamp	string	وقت الحدث أو الرسالة بصيغة ISO 8601. *
data	object	البيانات الأساسية في مسارات القوائم وملخص الحساب. *
data.accountId	string	اسم جلسة واتساب ويب في الحدث الوارد. *
data.conversationKey	string	مفتاح المحادثة في الحدث الوارد. *
data.remoteChatId	string	معرّف المحادثة عند المزوّد. *
data.remoteMessageId	string	معرّف الرسالة عند المزوّد. *
data.from	object	مرسل الرسالة الواردة. *
data.from.jid	string	معرّف واتساب JID لمرسل الحدث الوارد.
data.from.phone	string	هاتف مرسل الحدث الوارد عند توفره.
data.from.displayName	string	الاسم الظاهر لمرسل الحدث الوارد.
data.isGroup	boolean	صحيح عندما تكون المحادثة الواردة مجموعة. *
data.text	string	نص الرسالة الواردة. *
data.messageType	string	تصنيف الرسالة الواردة. *
data.timestamp	string	وقت الحدث الوارد بصيغة ISO 8601. *
data.hasMedia	boolean	صحيح عندما تتضمن الرسالة الواردة وسائط. *
data.mediaType	string	نوع الوسائط الواردة.
data.mimetype	string	نوع MIME للوسائط الواردة.
data.fileName	string	اسم ملف الوسائط الواردة.

رموز الحالة

الحالة	الوصف
200	نجاح.

حالات يجب أن تعرفها

تُرسل الرسائل الواردة فقط. ما ترسله أنت وأحداث المزامنة التاريخية لا تُعاد.
اضبط الرابط من إعدادات المطوّر → Webhook واتساب ويب، ثم أرسل حدثاً تجريبياً.

جرّب الطلب

هذا إشعار يرسله راسل إلى عنوانك. لا يمكن تجربته من هذه الصفحة.