الـ Webhooks

استكشف جميع العمليات والأدلة الخاصة بـ الـ Webhooks.

نظرة عامة على الويب هوك (Webhooks)

بث أحداث واتساب إلى خادمك في الوقت الفعلي.

أوامر الـ Webhooks

24 أوامر
POST
/session.status

تغير حالة الجلسة

يتم تفعيل هذا الحدث عند تغير حالة الجلسة (مثلاً من WORKING إلى STOPPED).

POST
/message

رسالة واردة

يتم تفعيل هذا الحدث عند استلام رسالة جديدة بواسطة مثيل واتساب الخاص بك.

POST
/message.reaction

تفاعل مع الرسالة

يتم تفعيله عندما يتفاعل المستخدم مع رسالة باستخدام إيموجي.

POST
/message.any

أي نشاط للرسائل (Catch-all)

حدث شامل يلتقط أي نشاط يتعلق بالرسائل في الجلسة.

POST
/message.ack

تأكيد استلام الرسالة (ACK)

تتبع حالة تسليم وقراءة الرسالة (تم الإرسال، تم التسليم، تمت القراءة).

POST
/message.revoked

حذف الرسالة (للجميع)

يتم تفعيله عندما يقوم المستخدم بحذف رسالة للجميع.

POST
/message.edited

تعديل الرسالة

يتم تفعيله عندما يقوم المستخدم بتعديل رسالة مرسلة.

POST
/group.v2.join

انضمام لمجموعة (V2)

يتم تفعيله عند انضمام عضو جديد أو إضافته إلى مجموعة.

POST
/group.v2.leave

مغادرة مجموعة (V2)

يتم تفعيله عند مغادرة عضو للمجموعة أو إزالته منها.

POST
/group.v2.update

تحديث بيانات المجموعة (V2)

يتم تفعيله عند تغيير إعدادات المجموعة مثل الاسم، الوصف، أو أيقونة المجموعة.

POST
/group.v2.participants

تغيير رتب المشاركين في المجموعة

يتم تفعيله عند ترقية أحد المشاركين إلى مسؤول (Admin) أو تنزيل رتبته.

POST
/presence.update

تحديث التواجد

يتم تفعيله عندما يبدأ جهة اتصال في الكتابة، أو تسجيل صوت، أو تغيير حالة اتصاله بالإنترنت.

POST
/poll.vote.failed

فشل التصويت في الاستطلاع

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

POST
/chat.archive

أرشفة الدردشة

يتم تفعيله عند تغير حالة أرشفة الدردشة.

POST
/call.received

استلام مكالمة

يتم تفعيله عند اكتشاف مكالمة صوتية أو مرئية واردة.

POST
/call.accepted

قبول المكالمة

يتم تفعيله عند الرد على مكالمة واردة من جهاز آخر.

POST
/call.rejected

رفض المكالمة

يتم تفعيله عند رفض مكالمة واردة.

POST
/label.upsert

تم إنشاء/تحديث تصنيف

يتم إطلاقه عند إضافة أو تعديل تصنيف واتساب بيزنس.

POST
/label.deleted

تم حذف تصنيف

يتم إطلاقه عند إزالة تصنيف بالكامل من الحساب.

POST
/label.chat.added

تمت إضافة تصنيف للدردشة

يتم إطلاقه عند تعيين تصنيف لمحادثة محددة.

POST
/label.chat.deleted

تم حذف تصنيف من الدردشة

يتم إطلاقه عند إلغاء تعيين تصنيف من محادثة.

POST
/event.response

استجابة الحدث بنجاح

يتم تفعيله عند اكتمال حدث غير متزامن بنجاح.

POST
/event.response.failed

Event Failure Response

Triggered when an asynchronous event fails to complete.

POST
/engine.event

حدث المحرك الخام

لاقط شامل لأحداث النظام منخفضة المستوى مباشرة من محرك واتساب.