Webhook
جریان رویدادها
Webhookهای لحظهای برای هر سرویس؛ دریافت رویدادهای ارسال، دریافت، کلیک و خطا با هدر احراز هویت و لاگ تحویل.
جریان رویدادها چیست؟
جریان رویدادها به شما اجازه میدهد خروجی رویدادهای Pushfa را برای هر سرویس جداگانه به یک webhook عمومی بفرستید. این قابلیت برای سینک با CRM، آرشیو داخلی، اتوماسیون بیرونی و مانیتورینگ لحظهای مفید است.
رویدادهای قابل ارسال
| رویداد | زمان ثبت | کاربرد |
|---|---|---|
| message.push.sent | وقتی پیام برای گیرنده ثبت میشود | ردگیری آغاز ارسال |
| message.push.received | وقتی گیرنده تحویل را تأیید میکند | اتصال به CRM یا گزارش تحویل |
| message.push.clicked | وقتی کاربر روی اعلان کلیک میکند | تحلیل تعامل |
| message.push.failed | وقتی ارسال یا پردازش ناموفق میشود | ثبت خطا و هشدار |
راهاندازی در پنل
قابلیت را فعال کنید
در تنظیمات سامانه، منوی جریان رویدادها را برای کاربران نمایش دهید.
جریان بسازید
در پنل کاربر، برای هر سرویس یک webhook جدید تعریف کنید.
امنیت را تنظیم کنید
آدرس مقصد باید HTTPS عمومی باشد و در صورت نیاز هدر احراز هویت بگیرد.
تست کنید
دکمه تست را بزنید و نتیجه را در لاگ تحویل ببینید.
نمونه payload
{\n "event": {\n "kind": "message.push.received",\n "subscription_id": "SUBSCRIBER_UUID",\n "external_id": "CRM-123"\n },\n "message": {\n "title": "عنوان پیام",\n "contents": "متن پیام"\n },\n "service": {\n "name": "نام سرویس"\n }\n}نکات مهم
لاگهای تحویل جریانها ۳۰ روز نگهداری میشوند. اگر webhook پاسخ 2xx ندهد، درخواست در صف retry قرار میگیرد و وضعیت خطا در پنل ثبت میشود.