تتيح webhooks لتطبيقك استقبال إشعارات فورية عند حدوث أحداث في مساحة عمل BuzzBip. يرسل BuzzBip طلب HTTP POST إلى endpoint المُعدّ لديك مع payload JSON.
إعداد webhooks
- انتقل إلى Settings → Developer → Webhooks في مساحة عمل BuzzBip
- انقر Add Webhook وأدخل عنوان URL لـ endpoint HTTPS
- اختر الأحداث التي تريد الاشتراك فيها
- احفظ وانسخ signing secret للتحقق من payload
- رد بـ
200 OKخلال 10 ثوانٍ لتأكيد الاستلام
الأحداث المدعومة
مثال payload
json
{
"id": "evt_7f3a9b2c",
"type": "message.received",
"createdAt": "2026-06-01T14:32:00Z",
"data": {
"messageId": "msg_abc123",
"conversationId": "conv_xyz789",
"contactId": "cnt_def456",
"channel": "whatsapp",
"body": "Hello, I need help with my order",
"from": "+21612345678"
}
}التحقق من التوقيعات
يتضمن كل طلب webhook رأس X-BuzzBip-Signature. احسب hash HMAC-SHA256 لجسم الطلب الخام باستخدام signing secret وقارنه بقيمة الرأس للتحقق من الأصالة.
يعيد BuzzBip محاولة تسليم webhooks الفاشلة حتى 5 مرات مع backoff أسي. تأكد أن endpoint لديك idempotent.