Webhook'lar

Bir uç ekleyin

Ayarlar → Geliştiriciler altında bir https adresi ekleyin ve olayları seçin: kişi oluşturuldu, etiket eklendi, mesaj geldi, satış kaydedildi, randevu iptal edildi ve dahası. İmza sırrını kopyalayın; yalnızca bir kez gösterilir.

İmzayı doğrulayın

Her istek `X-ChatinFlow-Signature: t=<unix time>,v1=<signature>` taşır. `<t>.<raw body>` için sırla HMAC-SHA256 hesaplayın, sabit sürede `v1` ile karşılaştırın ve beş dakikadan eski zaman damgalarını reddedin.

signature = hex(hmac_sha256(secret, t + "." + raw_body))
valid = equals(signature, v1) and now - t < 300

Hızlı yanıt verin, tekrarları atın

Herhangi bir 2xx ile 10 saniye içinde yanıt verin. Başarısız bir teslim 1 dakika, 5 dakika, 30 dakika, 2 saat ve 12 saat sonra yeniden denenir. Teslim en az bir kezdir: `X-ChatinFlow-Delivery` denemeler boyunca aynı kalır, zaten işlediğiniz kimlikleri atlayın.

Durdurulan uçlar

Art arda 50 başarısız denemeden ya da 410 Gone yanıtından sonra uç durur ve nedenini gösterir. Düzeltin, yeniden açın ve başarısız teslimleri günlükten yeniden gönderin.

Zapier, Make ve n8n

İhtiyacınız olan olay için bir uç oluşturun ve Zap'inizin ya da senaryonuzun yakalama adresini yapıştırın. `GET /api/v1/workspaces/<workspace>/webhooks/events` alan eşlemesi için her olayı örnek bir yükle listeler.

Önce kanalı bağla

Panel → Kanallar altındaki OAuth ya da kimlik bilgisiyle bağlantı, webhook yolunu ve gizli anahtarları kaydeder. Birinci taraf ürün için Meta geri çağırma URL'lerini elle yapıştırmazsın.

Idempotent alım

Sağlayıcı teslimleri Idempotency-Key ya da sağlayıcı mesaj kimlikleriyle tekilleştirilir; böylece tekrarlar konuşmaları iki kez oluşturmaz.

İzin kaybı

Kapsamlar iptal edilirse Kanallar yeniden yetkilendirme ister. “Eksik webhook” hatalarını ayıklamadan önce izinleri düzelt.