Entegrasyonlar: giden webhook'lar

Ayarlar → Entegrasyonlar (adres /app/settings/integrations) bu çalışma alanındaki olayları sizin belirlediğiniz bir URL'ye, örneğin bir otomasyon aracına (Zapier, Make, n8n) veya kendi sunucunuza gönderir. Yalnızca Sahip ve Yönetici görebilir ve değiştirebilir.

Adım adım: bir uç nokta ekle

1. Ayarlar → Entegrasyonlar açın.
2. Uç nokta URL'si alanına uç nokta URL'nizi yazın, örneğin https://your-system.example.com/omnibrand-hook. https olmalı ve herkese açık internetten erişilebilir olmalıdır; aksi halde kırmızı bir satır hangisi olduğunu söyler ("Uç nokta adresi https:// ile başlamalıdır. Düz http:// kabul edilmez." veya internetten ulaşılamadığını).
3. Etkinlikler altında bu uç noktanın alacağı olayları işaretleyin. Her kutuda sade bir açıklama ve olayın adı vardır, örneğin post.published ("Bir gönderi yayınlandı"), post.failed, social_account.token_expired veya social_account.disconnected; Sonradan eklenenler dahil tüm olaylar * demektir. workspace.created ve invitation.accepted da oradadır. En az birini işaretleyin, aksi halde form "En az bir olay seçin." der.
4. Uç nokta ekle'ye tıklayın.
5. İmza anahtarı (şimdi kopyalayın - sadece bir kez gösterilir): sırrla birlikte formun üstünde görünür; sayfa yukarı kaydırır, böylece telefonda da görürsünüz. Eğer son nokta reddedilirse, kırmızı mesaj aynı yerde görünür ve sayfa ona kaydırır. Sırrı şimdi alıcı sisteminize kopyalayın; OmniBrand bir daha asla göstermez (sadece son dört karakteri). Gizli anahtarı kopyala , sizin için kopyalayın.
6. Uç noktada Test gönder tuşuna tıklayın. ✓ teslim edildi sunucunuzun geri verdiği HTTP durumu ile görürsünüz. Başarısız olduğunda "Teslim edilmedi: sunucunuz [status]'a cevap verdi." ifadesini görürsünüz, örneğin 405 Yöntem İzin Verilmedi "Bu adreste POST taleplerini kabul etmeli.", 404 Bulunamadı için "Bu adreste hiçbir şey yanıt vermiyor. URL'yi kontrol edin.", yönlendirme için "Başka bir adrese yönlendirildi ve webhook'lar yönlendirmeleri takip etmez. Son URL'yi kaydedin."; veya sunucuya hiç ulaşılamadığında, "Teslim edilmedi: sunucunuza ulaşamadı ([sebep]). URL'yi ve sunucunun çevrimiçi olup olmadığını kontrol edin." Bir Webhooklar nasıl çalışır bağlantısı bu makaleyi açıyor.

Her uç nokta

• URL ve rozet aktif veya devre dışı.
• "olaylar: ... · gizli ••••1234", her olayın açıklaması (örneğin "Bir gönderi yayınlandı"), ayrıca "· N ardışık başarısızlık" teslimat girişimleri başarısız olduğunda ve "· N tekrar deneme bekliyor" ve olaylar bir sonraki denemesini beklerken.
• Kırmızı bir çizgi "N teslimat başarısız oldu - tekrar göndermek için Teslimat geçmişini aç." (aşağıdaki Teslimat geçmişi ve Yeniden Teslim Et.
• Etkin / Devre dışı dışı bırakan anahtarı teslimatı duraklatır veya devam ettirir. Değişiklik kaydedilirken kartta "Çalışıyorum..." yazıyor ve Test gönder ve Sil bekler; Anahtarlama veya Sil başarısız olursa, neden o uç noktanın kartının alt kısmında kırmızı renkte görünür ve sayfa ona kaydırır.
• Test gönder , 'webhook.test' adlı bir olayı bir kez gönderir (tekrar denenmez ve geçmişte tutulmaz).
• Teslimat geçmişi, uç noktanın son teslimatlarını açar ( Teslimat geçmişini gizle butonu onları kapatır).
• Sil şunu sorar: "(adres) adresine giden webhook silinsin mi? Olaylar hemen gönderilmeyi durdurur ve imza anahtarı kalıcı olarak silinir. Bunun yerine duraklatmak için anahtarını kapatın." Pencerenin başlığı Webhook silinsin mi? olur; uç noktayı hemen kaldırmak için Sil, tutmak için İptal düğmesine tıklayın.

Sunucunuzun aldığı

JSON gövdesine sahip bir GÖNDERİ: id (etkinliğin kimliği - tekrarları görmezden gelmek için kullanın), event (örneğin post.published), occurredAt ve data (etkinliğin detayları). Başlıklar:

• X-OmniBrand-Signature: sha256= ve ardından ham gövdenin HMAC-SHA256 harfleri, imza sırrınızla anahtarlanmış.
• X-OmniBrand-Timestamp ve X-OmniBrand-Signature-V2: zaman damgası, bir nokta ve gövdenin HMAC-SHA256'sı - eski tekrarları reddetmek için kullanılır.

5 saniye içinde herhangi bir 2xx durumu ile cevap verin.

Tekrarlar: OmniBrand ne kadar süredir denemeye devam eder

Her olay gönderilmeden önce kaydedilir, yani sunucunuz veya bizim sunucumuz yeniden başlatılırsa hiçbir şey kaybolmaz. Sunucunuz 5 saniye içinde 2xx durumuyla cevap vermediğinde (hata, zaman aşağı, yönlendirme, 2xx olmayan herhangi bir cevap), olay yaklaşık 1 dakika, 5 dakika, 15 dakika, 30 dakika, 1 saat, 2 saat, 4 saat, 8 saat ve 12 saat - 10 deneme ile tekrar denenir, yaklaşık 28 saat içinde. Her bekleme %20'ye kadar değişir, bu yüzden tekrar denemeler hepsi aynı anda gelmez. Yeniden deneme daha sonraki bir olaydan sonra gelebileceğinden, tekrarları görmezden gelmek için 'id' ve olayları sıralamak için 'occurredAt' kullanın.

Eğer tüm 10 deneme başarısız olursa, teslimat Başarısız olarak işaretlenir ve 30 gün boyunca geçmişte kalır, sonra tekrar gönderebilirsiniz.

Teslimat geçmişi ve Yeniden Teslim

1. Uç noktada, Teslimat geçmişi sayfasına tıklayın. Son teslimatlar son 30 günü, en yenileri ilk olarak listeliyor.
2. Her satırda bir durum rozeti - Teslim edildi, Yeniden deneniyor veya Başarısız - olay adı, gerçekleştiği zaman, "Deneme N of 10", "Bir sonraki deneme" zamanı için ve "Son cevap"dan geçemeyen bir durum için sunucunuzun yanıtladığı (örneğin "HTTP 503" veya "5 saniye içinde cevap yok").
3. Yalnızca başarısızlar başarısız olanları görür; Daha eskileri göster yüklemeleri göster. Hiçbir şey yoksa, "Son 30 günde başarısız teslimat yok. Hâlâ tekrar denenen teslimatlar başarısız sayılmaz." ( Yeniden deneniyor teslimatı henüz başarısız olmamıştır).
4. Tekrar göndermek için satırında Yeniden gönder et'e tıklayın. Hemen gönderilir: "Teslim edildi." veya "Henüz teslim edilmedi (cevap) görürsünüz. Otomatik olarak tekrar denenir." - yeniden teslim edilen bir olay 10 denemelik yeni bir yayın başlatır.
5. Sunucunu düzelttikten sonra hepsini tekrar göndermek için, başarısız Başarısızların tümünü yeniden gönder Et'e tıklayın. "N başarısız teslimat sıraya girdi ve bir dakika içinde gönderiliyor." diye bakıyorsunuz.

Yeniden teslim için uç nokta açık olmalıdır; Devre dışı bırakıldığı sürece düğmeler bekler ve geçmiş "Bu uç nokta devre dışı bırakıldı. Yeniden teslim etmek için anahtarını açın." diyor. Bir uç nokta devre dışı bırakıldığı sırada gelen olaylar gönderilmez veya saklanmaz.

Bir şeyler ters giderse

• Yönlendirmeler asla takip edilmez; nihai URL'yi kaydet. Eğer sizin yönlendirmeniz yönlendirilirse, test "Teslim edilmedi: sunucunuz 301 Kalıcı Taşındı yanıtını verdi. Başka bir adrese yönlendirildi ve webhooklar yönlendirmeleri asla takip etmez. Bunun yerine son URL'yi kaydedin." (sunucunuzun gönderdiği durumla).
• Bir uç noktaya yapılan her girişim bir gün boyunca başarısız olduğunda (en az 20 deneme üst üste), uç nokta otomatik olarak devre dışı bırakılır ve yöneticilere bildirilir. Bekleyen teslimatlar Başarısız olarak işaretlenir. Alıcıyı düzeltin, anahtarı Etkin çevirin, ardından Teslimat geçmişi açın ve Başarısızların tümünü yeniden gönder et'e tıklayın.

API erişimi (geliştiriciler için)

Sayfanın altında API erişimi (geliştiriciler için) kartı bulunur: "Gönderileri otomatik oluşturmak, kişi eklemek veya analizleri okumak için OmniBrand'i kendi sistemlerinize, Zapier'e veya Make'e bağlayın." Agency ve Enterprise planlarında genel API için anahtarlarınızı içerir (bkz. API erişimi). Diğer planlarda "API erişimi Agency planında sunulur." yazar ve Planları gör bağlantısını gösterir. Bu sayfadaki webhook'lar her planda çalışır.

Bilmek iyi

• Bir uç nokta yalnızca bu çalışma alanının olaylarını ve ayrıca hesap genelinde olayları (faturalama ve hesap olayları) alır.
• Uç noktayı eklediğinizde bulunduğunuz çalışma alanı, ait olduğu alandır.