Dokümantasyon / Webhook'lar
Webhook'lar
Ayarlar → Webhook'lar altında bir uç nokta yapılandırın; Meshwire, abone olunan her olay için imzalı bir JSON yükünü POST ile gönderir.
Olay kataloğu
| Olay | Açıklama |
|---|---|
| bot.published | Yeni bir akış sürümü yayınlandı |
| subscriber.created | Yeni bir abone bir bota katıldı |
| subscriber.blocked | Bir abone botu engelledi |
| broadcast.completed | Bir yayının gönderimi tamamlandı |
| broadcast.failed | Bir yayın gönderilemedi |
| message.inbound | Gelen bir mesaj alındı |
İmzaları doğrulama
Her istek bir X-Meshwire-Signature başlığı içerir: uç nokta gizli anahtarınızla imzalanmış, ham istek gövdesinin HMAC-SHA256 onaltılık özeti.
const expected = crypto
.createHmac("sha256", endpointSecret)
.update(rawBody)
.digest("hex");
if (expected !== req.headers["x-botforge-signature"]) {
return res.status(401).end();
}Yeniden denemeler ve geri çekilme
5 saniye içinde 2xx yanıtı almayan teslimatlar, üstel geri çekilmeyle yeniden denenir: 1 dk, 5 dk, 30 dk, 2 sa, ardından 12 sa, toplamda 24 saate kadar. Son deneme başarısız olduktan sonra uç nokta işaretlenir ve size e-posta ile bildirim gönderilir. 1 saat içinde %50'den fazla başarısızlık oranına sahip uç noktalar geçici olarak devre dışı bırakılır.
Yük örneği
{
"id": "evt_3n7f",
"type": "broadcast.completed",
"createdAt": "2024-05-02T14:03:11Z",
"data": {
"broadcastId": "bcast_7f1",
"botId": "bot_9k2",
"stats": { "total": 4210, "delivered": 4180, "blocked": 19, "failed": 11 }
}
}