كتالوج أحداث Webhook

تدرج هذه الصفحة كل حدث webhook يمكنك الاشتراك فيه على Wink. للحصول على تعليمات الإعداد، راجع دليل تكامل Webhook أو صفحة إدارة Webhooks.

كيفية الاشتراك

1. انتقل إلى التطبيقات > Webhooks في بوابتك.
2. أنشئ webhook واختر الأحداث التي تريد استلامها — أو اترك القائمة فارغة لاستلام كل حدث.
3. ترسل Wink طلب HTTP POST موقع إلى نقطة النهاية الخاصة بك في كل مرة يحدث فيها الحدث. راجع تكامل Webhook لمعرفة الظرف، الرؤوس، التحقق من التوقيع والمحاولات.

كل نوع حدث

يتم إنشاء هذا الجدول من كتالوج الأحداث الخاص بالمنصة عند وقت البناء، لذا فهو دائمًا يتطابق مع API. ترتبط أنواع الأحداث التي تم تسليمها بصفحة المرجع الخاصة بها في Webhooks API، والتي توثق جسم JSON الدقيق (WebhookEnvelope مع object خاص بالحدث)، رؤوس Wink-* وسياسة المحاولة. أنواع الأحداث التي لم تُسلم موجودة داخليًا (المدفوعات، دفتر الحسابات، مزامنة مدير القنوات، …) لكنها غير مرسلة حاليًا لمشتركي webhook.

المستلمون يوضح من يستلم الحدث: SUPPLIER (الفندق)، AFFILIATE (موزع لديه قناة مبيعات نشطة للفندق)، AGENT (وكالة السفر التي قامت بالحجز) أو SELF (الجهة المديرة التي يدور الحدث حولها). كل مستلم يستلم نفس شكل الحمولة؛ التفاصيل الخاصة بالدور موجودة خلف رابط links.self في الحمولة.

account.*

الحدث	الوصف	تم التسليم	المستلمون
account.details.updated	The account's details changed.	لم يتم التسليم	—
account.managers.update	The account's manager list changed.	✓ تم التسليم	SELF
account.task.complete	An onboarding task was completed.	لم يتم التسليم	—
account.task.create	An onboarding task was created for the account.	لم يتم التسليم	—
account.task.remove	An onboarding task was removed.	لم يتم التسليم	—
account.task.tax_id.complete	The tax-id onboarding task was completed.	لم يتم التسليم	—
account.task.update	An onboarding task was updated.	لم يتم التسليم	—
account.under_review	The account was placed under review.	لم يتم التسليم	—

activity.*

الحدث	الوصف	تم التسليم	المستلمون
activity.created	An activity was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
activity.deleted	An activity was deleted.	✓ تم التسليم	AFFILIATE, SUPPLIER
activity.updated	An activity was updated.	✓ تم التسليم	AFFILIATE, SUPPLIER

add_on.*

الحدث	الوصف	تم التسليم	المستلمون
add_on.created	An add-on was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
add_on.deleted	An add-on was deleted.	✓ تم التسليم	AFFILIATE, SUPPLIER
add_on.updated	An add-on was updated.	✓ تم التسليم	AFFILIATE, SUPPLIER

booking.*

الحدث	الوصف	تم التسليم	المستلمون
booking.cancelled	A booking was cancelled.	✓ تم التسليم	AFFILIATE, AGENT, SUPPLIER
booking.create	A booking was created (confirmed).	✓ تم التسليم	AFFILIATE, AGENT, SUPPLIER
booking.failed	A booking attempt failed.	✓ تم التسليم	AFFILIATE, AGENT, SUPPLIER
booking.funds.available	Funds for a booking became available for payout.	✓ تم التسليم	AFFILIATE, AGENT, SUPPLIER
booking.funds.ledgered	Funds for a booking were added to the ledger.	✓ تم التسليم	AFFILIATE, AGENT, SUPPLIER
booking.initialize.complete	A booking initialisation completed.	لم يتم التسليم	—
booking.initialize.request	A booking initialisation (checkout) was requested.	لم يتم التسليم	—
booking.payout.complete	A payout for a booking completed.	لم يتم التسليم	—
booking.payout.create	A payout for a booking was created.	لم يتم التسليم	—
booking.processing	A booking is being processed.	لم يتم التسليم	—
booking.refund.error	A booking was refunded because of a processing error.	لم يتم التسليم	—
booking.refund.full	A booking was fully refunded.	✓ تم التسليم	AFFILIATE, AGENT, SUPPLIER
booking.refund.partial	A booking was partially refunded.	✓ تم التسليم	AFFILIATE, AGENT, SUPPLIER
booking.refund.request	A refund was requested for a booking.	✓ تم التسليم	AFFILIATE, AGENT, SUPPLIER
booking.review.created	A guest submitted a review for a booking.	✓ تم التسليم	SUPPLIER
booking.review.responded	The hotel responded to a guest review.	✓ تم التسليم	AFFILIATE, AGENT, SUPPLIER
booking.sync.failed	A booking-to-channel-manager synchronisation failed.	لم يتم التسليم	—
booking.sync.run	A booking-to-channel-manager synchronisation run started.	لم يتم التسليم	—

channel-manager.*

الحدث	الوصف	تم التسليم	المستلمون
channel-manager.update	A channel manager pushed an update.	لم يتم التسليم	—
channel-manager.update.availability	A channel manager pushed an availability update.	لم يتم التسليم	—
channel-manager.update.rate	A channel manager pushed a rate update.	لم يتم التسليم	—

email.*

الحدث	الوصف	تم التسليم	المستلمون
email.correspondence	An email correspondence was recorded.	لم يتم التسليم	—

internal.*

الحدث	الوصف	تم التسليم	المستلمون
internal.payment.failed	A payment failed (internal).	لم يتم التسليم	—
internal.payment.processing	A payment is processing (internal).	لم يتم التسليم	—
internal.payment.succeeded	A payment succeeded (internal).	لم يتم التسليم	—

ledger.*

الحدث	الوصف	تم التسليم	المستلمون
ledger.entry.create	A ledger entry was created.	لم يتم التسليم	—

managing_entity.*

الحدث	الوصف	تم التسليم	المستلمون
managing_entity.account_representative.updated	The account representative changed.	لم يتم التسليم	—
managing_entity.agent.email.notification	An email notification was sent to the account's agent.	لم يتم التسليم	—
managing_entity.agent.updated	The account's travel-agent details changed.	لم يتم التسليم	—
managing_entity.city.updated	The account's address or city changed.	✓ تم التسليم	SELF
managing_entity.created	A managing entity (account) was created.	✓ تم التسليم	SELF
managing_entity.deleted	The account was deleted.	✓ تم التسليم	SELF
managing_entity.information.updated	The account's general information changed.	✓ تم التسليم	SELF
managing_entity.logo.updated	The account's logo changed.	✓ تم التسليم	SELF
managing_entity.managed_by.updated	The entity managing this account on its behalf changed.	✓ تم التسليم	SELF
managing_entity.manager.accepted	An invited manager accepted the invitation.	لم يتم التسليم	—
managing_entity.manager.added	A manager was added to the account.	✓ تم التسليم	SELF
managing_entity.manager.email.notification	An email notification was sent to an account manager.	لم يتم التسليم	—
managing_entity.manager.invited	A manager was invited to the account.	✓ تم التسليم	SELF
managing_entity.manager.owner.set	The account owner was set.	✓ تم التسليم	SELF
managing_entity.manager.rejected	An invited manager rejected the invitation.	لم يتم التسليم	—
managing_entity.manager.removed	A manager was removed from the account.	✓ تم التسليم	SELF
managing_entity.name.updated	The account's display name changed.	لم يتم التسليم	—
managing_entity.place_id.updated	The account's Google Place ID changed.	✓ تم التسليم	SELF
managing_entity.profile_picture.updated	The account's profile picture changed.	✓ تم التسليم	SELF
managing_entity.status.updated	The account's platform status changed (e.g. approved, suspended).	✓ تم التسليم	SELF
managing_entity.subscription.changed	The account's platform subscription changed.	لم يتم التسليم	—
managing_entity.subscription.invoice.changed	The status of a subscription invoice changed.	✓ تم التسليم	SELF
managing_entity.subscription.provisioned	A platform subscription was provisioned for the account.	✓ تم التسليم	SELF
managing_entity.unique_id.updated	The account's short unique id changed.	✓ تم التسليم	SELF
managing_entity.url_name.updated	The account's URL name (slug) changed.	✓ تم التسليم	SELF

master_rate.*

الحدث	الوصف	تم التسليم	المستلمون
master_rate.created	A master rate was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
master_rate.deleted	A master rate was deleted.	✓ تم التسليم	AFFILIATE, SUPPLIER
master_rate.updated	A master rate was updated.	✓ تم التسليم	AFFILIATE, SUPPLIER

meeting_room.*

الحدث	الوصف	تم التسليم	المستلمون
meeting_room.created	A meeting room was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
meeting_room.deleted	A meeting room was deleted.	✓ تم التسليم	AFFILIATE, SUPPLIER
meeting_room.updated	A meeting room was updated.	✓ تم التسليم	AFFILIATE, SUPPLIER

payee.*

الحدث	الوصف	تم التسليم	المستلمون
payee.create	A payee was created.	لم يتم التسليم	—
payee.create.failure	Creating a payee failed.	لم يتم التسليم	—
payee.update	A payee was updated.	لم يتم التسليم	—
payee.update.failure	Updating a payee failed.	لم يتم التسليم	—

perk.*

الحدث	الوصف	تم التسليم	المستلمون
perk.deleted	A perk was deleted.	لم يتم التسليم	—
perk.updated	A perk was updated.	لم يتم التسليم	—

property.*

الحدث	الوصف	تم التسليم	المستلمون
property.address.updated	A property's address changed.	✓ تم التسليم	AFFILIATE, SUPPLIER
property.created	A property (hotel) was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
property.deleted	A property was deleted.	✓ تم التسليم	AFFILIATE, SUPPLIER
property.geolocation.updated	A property's geolocation changed.	✓ تم التسليم	AFFILIATE, SUPPLIER
property.name.updated	A property's name changed.	✓ تم التسليم	AFFILIATE, SUPPLIER
property.policy.created	A property policy was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
property.policy.updated	A property policy changed.	✓ تم التسليم	AFFILIATE, SUPPLIER
property.profile.updated	A property's profile changed.	✓ تم التسليم	AFFILIATE, SUPPLIER
property.registered	A property completed registration.	✓ تم التسليم	AFFILIATE, SUPPLIER
property.services.updated	A property's services/amenities changed.	✓ تم التسليم	AFFILIATE, SUPPLIER
property.status.updated	A property's platform status changed.	✓ تم التسليم	AFFILIATE, SUPPLIER
property.updated	A property was updated.	لم يتم التسليم	—
property.welcome_text.updated	A property's welcome text changed.	✓ تم التسليم	AFFILIATE, SUPPLIER

rate_modifier.*

الحدث	الوصف	تم التسليم	المستلمون
rate_modifier.updated	A rate modifier was updated.	لم يتم التسليم	—

rate_plan.*

الحدث	الوصف	تم التسليم	المستلمون
rate_plan.created	A rate plan was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
rate_plan.deleted	A rate plan was deleted.	✓ تم التسليم	AFFILIATE, SUPPLIER
rate_plan.updated	A rate plan was updated.	✓ تم التسليم	AFFILIATE, SUPPLIER

restaurant.*

الحدث	الوصف	تم التسليم	المستلمون
restaurant.created	A restaurant was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
restaurant.deleted	A restaurant was deleted.	✓ تم التسليم	AFFILIATE, SUPPLIER
restaurant.updated	A restaurant was updated.	✓ تم التسليم	AFFILIATE, SUPPLIER

room_type.*

الحدث	الوصف	تم التسليم	المستلمون
room_type.created	A room type was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
room_type.deleted	A room type was deleted.	✓ تم التسليم	AFFILIATE, SUPPLIER
room_type.updated	A room type was updated.	✓ تم التسليم	AFFILIATE, SUPPLIER

sales_channel.*

الحدث	الوصف	تم التسليم	المستلمون
sales_channel.created	A sales-channel relationship (supplier ↔ reseller) was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
sales_channel.deleted	A sales-channel relationship was deleted.	✓ تم التسليم	AFFILIATE, SUPPLIER
sales_channel.updated	A sales-channel relationship was updated.	✓ تم التسليم	AFFILIATE, SUPPLIER

spa.*

الحدث	الوصف	تم التسليم	المستلمون
spa.created	A spa was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
spa.deleted	A spa was deleted.	✓ تم التسليم	AFFILIATE, SUPPLIER
spa.updated	A spa was updated.	✓ تم التسليم	AFFILIATE, SUPPLIER

special_rate.*

الحدث	الوصف	تم التسليم	المستلمون
special_rate.created	A promotion (special rate) was created.	✓ تم التسليم	AFFILIATE, SUPPLIER
special_rate.deleted	A promotion was deleted.	✓ تم التسليم	AFFILIATE, SUPPLIER
special_rate.updated	A promotion was updated.	✓ تم التسليم	AFFILIATE, SUPPLIER

نصيحة

ابدأ بالاشتراك في كل الأحداث أثناء التطوير. بمجرد أن تفهم الحمولات التي يحتاجها نظامك، قلل اشتراكاتك لتقليل الضوضاء. أرسل لنفسك حدث اختبار من التطبيقات > Webhooks (أو POST …/webhook/{id}/test) لتأكيد نقطة النهاية وفحص التوقيع قبل التشغيل الفعلي.

قراءة إضافية

• دليل تكامل Webhook — خطوات الإعداد وأفضل الممارسات.
• Webhooks — إدارة اشتراكات webhook الخاصة بك.
• التطبيقات — إدارة بيانات اعتماد API.
• البناء على Wink — نظرة عامة على المنصة للمطورين.