🪝 Webhooks & otomasyon

Her şeyi Tesir, Her yerde.

Bir HTTPS abone olun URL (Ve) OpsIQ Her teslimat HMAC-SHA256 imzalanmış, iş alanı-skop ve altı yıllık bir yeniden deneme yaşamı döngüsü aracılığıyla takip edilmiştir. Kuralları görsel olarak oluşturun, haritalanan olaylar veya genel işlem yoluyla çağrılayın API.

52 canonical eventsHMAC-SHA256 her teslimattaİlk deneme + beş retriesYeniden kayıtlarla ilgili sabit teslimat kimlik
Kaynakta imza attı
Topraklara kadar yeniden canlanıyor
Derece Bir olay. İmzalandı. Teslimat yoluyla takip edildi. OLAY Otobüs invoice.paid HMAC-SHA256 your-crm.com /hook 200 Tamam Son nokta Deney 2/6 · backoff DÜŞÜN LOG your-crm.com/hook200 · teslim slack.com/services200 · teslim
52Abone olmak için canonical events
HMACHer teslimatta imzalanmış her teslimatta imzalanmıştır.
İlk denemeden sonra planlanan yenidenlemeler
Kapsamendpoints ve loglar bir çalışma alanına kilitlenir
Event yönlendirici

Olaylar dışarı çıkıyor. Etkinlikler in. Her iki şekilde de eylemler.

Üç ayrı yol için yönetilen entegrasyon kontrolü odası: sınırsız teslimatlar imzaladı, gelen makbuzlarda doğrulandı ve açık geri dönüş işlemleri sözleşmeleri.

Dışarı

Dışarıya giden olaylar

Hedef başına filtrelerle kanonik OpsIQ olaylarına herhangi bir HTTPS endpoint abone olun.

İÇERİDE

Inbound maküller

İmzalanan JSON, alanlarını haritalayın ve doğru temasa kabul edilen aktiviteyi ekleyin.

HAREKET

Governed eylemleri

Declare parametreleri, doğrulama, operasyon başına izinler ve onay gereklilikleri.

OpsIQ olay yolu trafik imzalanmış trafik imzaladı

Bir otobüs, üç yol

Dışarı
webhooks
Giriş
olaylar olayları
Kayıt Olmuş
Olay otobüsü
Eylem
POST
invoice.paidyour-crm.com/hook200
stripe.payment_intentİletişim süresi zaman süresiharitalandı
ai.action.approved/api/provisionimzalanmış
İmzaHMAC-SHA256

Her teslimat, üst düzey alıcılara sürekli bir karşılaştırma ile doğrulanabilir.

CorrelationStabilis ID

X-OpsIQ-Delivery Her yeniden deneme girişiminin aynı teslimatını tanımlar.

Tarih TarihiInspectableable

Durum bakın, her bir kesintiye maruz kalma için sayım, tepki parçaları ve yeniden deneme zamanlamasını düşünün.

Yeniden kullanılabilirlik · yeniden tarihler

Endpoints aşağı in. Teslimatlar denemeye devam eder.

Başarısız bir teslimat, tanımlanmış bir merdivenle hareket eder (1m → 5m → 30m → 2h → 12h) Bu, her olayı bir ilk deneme artı beş planlanan retries verir. Teslimat tarihi HTTP statüsünü tutar, yanıt parçaları, girişim sayısını, bir sonraki yeniden deneme zamanını ve istikrarlı teslimat kimlik alıcınızın deduplication için kullanabileceğini sağlar.

Açıklama : Defined backoff: 5 planlanan retries (1m)→5m→30m→ 2h → 12hİlk istekten sonra, teslimat başarısız oldu.
Per-endpoint teslimat demiryolu: Son teslimatlar yeşil / amber / kırmızı bir bakışta, durum kodu ve zamanı ile.
En küçük-once açık yaptı: İmzayı doğrulayın, durgun zamanlarını reddediyor ve istikrarlı bir şekilde çözüyor X-OpsIQ-Delivery Alıcınızda değer.
14h 36mSon deneme yoluyla
6maksimum toplam denemeler
Retry merdiven & teslimat log 1 dakika. 5 dakika. 30 dakika. 2s 12s DÜŞÜN LOG your-crm.com/hook · order.created 200 · teslim slack.com/services · invoice.paid200 · teslim stale-endpoint · ödeme. completedattempt 2/6 support-bot · bilet. created200 · teslim Ölü-host · abonelik. yenilendi502 · başarısız Cevap yakalanan cevap
Geri çekilme1m→5m→30m→ 2h → 12h
Correlationstabil teslimat ID girişimleri
Alıcı güvenliğiZamanlar Not check + teslimat-ID dedupe
Two-way otomasyon

Olayları alın ve AI'ya izin verin Güvenli hareket eder.

Inbound endpoints and action endpoints are different Surface, so they now look different: one map outside events on contact, the other door AI actions before your backend is called.

Giriş Son Noktaları

Dış olaylar doğru zaman çizelgesine doğru topraklar.

Benzersiz bir URL oluşturun ve gizli imzalayın, JSON alanları haritalayın, sonra OpsIQ her kabul edilen olayı eşleşen temasa ekleyin.

https://opsiq.example/api/v1/inbound.php?t=wh_7c91...
contact_email_path $.customer.email event_type_path $.type idempotency_key_path $.id
Etkinlik son noktaları

AI, sözleşmeden kaçmak olmadan çalışmayı isteyebilir.

Declare parametreleri, doğrulama ve izinler; infazdan önce yüksek riskli yazı için onay gerektirir.

billing.issue_credit
PeroseOnaylandıYürüt
REST API anahtarları

İzinler, sınırlar ve listelere izin veren anahtarlar.

Her entegrasyon tam güç vermeden araçlar ve ortaklar için sorun çalışma alanı anahtarları.

BI pano Sadece okuyun
Partner uygulaması Kısıtlı
İç araç Hepsi
API aksiyon çağrısı

Kod yolları temiz kalır.

Karmaşık iş akışları için, REST API doğrudan aynı kapsamı modelle arayın.

POST /api/v1.php
Yetkilendirme: İşletim sistemi
{ "action": "crm.conversions.record" }
Sertleştirilmiş izolasyon

Her uç noktası ve anahtar her uç noktadır İş alanına kaynaklayın.

Güvenlik burada kendi görsel sistemine sahiptir: teslimat URLs, anahtarlar bir çalışma alanına karşı koruyor ve çapraz istekler herhangi bir veri okumadan önce geri dönüyor.

0Global jetonlar
403kapsamı yanlış
Outbound security

Teslimat URLs inward.

OpsIQ özel, döngülü, bağlantı-yerel ve bulut metadata hedeflerini zamanında ve tekrar göndermekte.

your-crm.comizin ver
127.0.0.1blok
10.0.0.5blok
169.254.169.254blok
Workspace to

Tenant sınırları anahtarın parçasıdır.

Endpoints, inbound makbuzlar, teslimat günlükleri ve API anahtarları hepsini yaratan iş alanı damgasını taşıyor.

A İş Alanlarıanahtar opq_a1...
son nokta /hook-a
kapsamı_key ws_a
B İş Alanıanahtar opq_b7 ...
son nokta /hook-b
kapsamı_key ws_b
İş Alanından Bir Anahtar Arama Çalışma Alanı B, veri erişiminden önce 403 döndürür.
Kapsam

Her istek aynı kapıyı aşıyor.

İmza, çalışma alanı kapsamı, izin modu, oran limit ve Seçmeli IP İzin listesi, talep iş verilerinden önce kontrol edilir.

Kutudaki her şey

Bir entegrasyon yüzeyi, Tam tel.

Yeniden Tarihler ve Tarih İlk deneme artı beş planlı retries, statü ile yanıt parçaları ve teslimat tarihinde bir sonraki yeniden deneme zamanı.
Kapsama API anahtarları Tüm, sadece veya Restrikted modları okuyun, per-key oranı sınırları ve IP izin listeleri, çalışma alanına kilitlenir.
Yaşamaktan önce test Bir çıkış testi gönderin, bir inbound haritalama testi çalıştırın veya imzalanmış tel zarfı denetlemek için gönderileyici kuru-run kullanın.
Teslimat korelasyon Stabil X-OpsIQ-Delivery değeri, alıcıların tekrarlanan girişimleri tanımlamasına ve çözmesine olanak sağlar.
Görsel kural oluşturucu Drag-drop "X olduğunda, Y": tier, öncelik veya anahtar kelime koşulları, gerekli kod yok.
Alıcı replay rehberlik İmzalanan Unix zamantamp'ı, bir yazı yapmadan önce teslimat ID'sini geri almak için kullanın.
⚖️ Nerede uyuyor

Kiraladığınız bir yapıştırıcı aracı değil. Bir yerli entegrasyon katmanı.

Zapier ve birlikte uygulamalar atmak için harikalar, ancak platformunuzun dışında oturabilirler, her run. OpsIQ'ın olayları, imzalar ve eylemler yerlidir, aynı verileri sohbetiniz, CRM ve biletleriniz ile paylaşırlar.

İhtiyacınız olan şey nedirHam Zapier / YapOpsIQ Webhooks & Etkinlikler
Tipd, belgelenmiş olay kataloguPer-app, tutarsız52 canonical OpsIQ events
HMAC-SHA256 imzalanmış teslimatNadir / DIY per zapHer teslimatı imzalayın, uç nokta başına gizli
Per-endpoint event filtreleriBiri zapVahşi kart veya kesin alt set, per URL
Otomatik yeniden tarihler + tarihiSınırlı / ücretli tierİlk deneme + beş planlanan yenidenleme
Güvenli tekrarlamaOnu inşa ediyorsunStable teslimat ID + zamantampampamp imzaladı
Sağ temasa geçtiBir akışta topraklar, bir CRM değilİletişim süresine Haritalar
Onlar koşmadan önce kapı AI eylemleriHiçbir kavramRisk-aware Onay politikası
Denetimli Eylem infazıHayırParametreler kırmızıacted + sonuç ve süre giriş
Kapsama API anahtarları + oranı limitleriHesap çapında tokenTüm / Oku- Sadece / Kısıt + CIDR
SSR-Ziyaretsiz teslimatVaries VarPrivate / metadata IPs bloke, yeniden çözümlendi
Per-run metre / görev kapaklarıEvet, görev başına ödersinizYerli: per-event toll
chat / CRM / biletleriUygulamalar arasında CopiedBir gerçek kaynağı
Tüm özellikler listesi

Her şey her şey Web Hooks & Etkinlikleri.

Her yetenek, gruplandırılmış. ★ bir stand-out işaret eder.

ÖzellikNedir?
Olay aboneliği
Outbound Event Catalog (52) ★Ticaret, faturalama, destek, CRM, güvenlik ve analitik arasındaki türk olaylar.
Vahşi Kart Etkinliği Aboneliği (*)Tek bir son nokta ile her şeye abone ol *.
Per-Bitki Olay Filtreleri ★Bir URL fatura alır, başka bir destek, bu yüzden buna ihtiyaç duymayan alıcılara gürültü yok.
Güvenlik ve imza imzalama
HMAC-SHA256 ★Her ödeme yükü, per-endpoint sırrı ile imzalanmış X-OpsIQ-Signature.
Ham-Beden İmzasıİntevazlar, yeniden düzenlenmiş bir nesne değil, bu yüzden gönderici ve alıcı arasında hiçbir şey sürüklenmez.
Sürekli Zaman Doğrulama ★hash_equals() Bu yüzden saldırganlar, bir imzaya yollarını zamanlayamazlar.
Rotatable Sırları İmzalamak ★Bir per-endpoint sırrı herhangi bir zamanda yeniden üret, sonra da verifier.
X-OpsIQ-Signature BaşlığıHMAC, doğrulama için her tek teslimatta taşınır.
X-OpsIQ-Timestamp BaşlığıHer teslimatta Unix dönemi, böylece alıcılar stale olayları reddedebilirler.
Endpoint SSR Koruma ★ YeniBloklar özel, döngü ve bulut-metadata IPs teslimat hedefleri olarak, tasarruf edin ve zamanında gönder.
Alıcı Replay Controls ★İmzalanmış bir Unix zamanıtamp ve istikrarlı teslimat ID, alıcılara sabit talepleri reddetmeleri ve deduplicate girişimleri reddetmektedir.
Güvenilirlik ve yenidenleme
Stabil Teslimat Identifier ★X-OpsIQ-Delivery Yeniden yapılanlar boyunca istikrarlı kalır, böylece bir alıcı idempotent yazabilir.
Exponential Backoff Retry Merdiveni ★1m → 5m → 30m → 2h → 12h: İlk denemeden sonra beş planlı yeniden yapılanma.
Teslimat Tarihi ★HTTP durumu, yanıt parçaları, sayı ve bir sonraki yeniden deneme zamanı, renkli kodlanmış yeşil / amber / kırmızı.
Per-Bitki Teslimi RailBir bakışta durum ile gösterilen son teslimatlar, uç nokta başına.
Teslimat metadata
X-OpsIQ- Event HeaderCarries olayı türü böylece alıcılar vücutları parsing olmadan yollayabilirler.
X-OpsIQ-Delivery BaşlığıHer girişimi takip etmek ve korelasyon için teslimat ID.
Test ve doğrulama
Test Teslimatı Yaşama gitmeden önce ★Bir örnek ödeme yükü ateş ve tam JSON, imza ve HTTP yanıtını inceler.
Test Signatures (kuru_run)İmzalanmamış imza zarfı geri döndürür, böylece önce yerel olarak doğrulayabilirsiniz.
Giriş Test TeslimatıBir haritalama e-postayı çıkarır ve doğru aktivite yaratır.
Son nokta yönetimi
Aktif / Inaktif ToggleOnu bozmadan bir uç noktası kullanın.
İptal Edilmesi ile DeletionDeleting, girişleri tutmak için yeniden tarihler süregeldi.
Giriş webhooks
Gelen Son Noktalar ★eşsiz bir eşsiz URL Bir sistem veya röle için kaynağın başına bir sır, HMAC'nin hamilini yapabilen JSON Vücut.
Gelen İmza Doğrulama ★Vererek X-OpsIQ-Inbound-Signature Başka bir şey gerçekleşmeden önce.
JSON Yolu Haritalama ★E-posta, etkinlik türü ve değeri $.path Herhangi bir ödeme şeklinden.
İletişim Name Ekstraksiyon Yeniİletişimin adını çek contact_name_path Bu yüzden zaman çizelgesi temiz bir şekilde okur.
Değer Alan Ekstraksiyon YeniHarita para veya sayısal değeri ile value_path Puanlama ve raporlama için.
Özet Şablonlar ★ Yeniİnsan özetini bir insan özeti oluşturun summary_path veya ${path} token şablon.
Gelen Ön Ayarlama Haritaları ★Bir tıkırlık Stripe, Calendly ve Zapier, tamamlanmadan önce haritalar.
Gelen İdempotency ★Ne zaman? idempotency_key_path Bir etkinlik ID'sini çöz, tekrar makbuzlar başka bir aktivite yaratmadan başarı döndürür.
İletişim Timeline ★Kabul edilen olaylar temasta uygulanabilir, tetiklenebilir aktiviteler haline gelir.
Geçen AlıntılarTamam / hata / tekrar / debugging için ham para yükü ile karşı karşıya kaldı.
API & erişim kontrolü
API Keys: 3 İzin Modus ★Güvenilir araçlar için, sadece panolar için okuyun veya belirli eylemleri engellemek için yorum yapın.
API Anahtar Hızı Kısıtlama ★Canlı bir kullanım barı ile anahtar başına saat ara.
API Key IP İzin Listesi (CIDR) ★Pin, ofis veya veri odaklı IPs ile CIDR aralıkları ile bir anahtar.
Canlı Eylem Kataloğu (meta. actions) ★Tam aksiyon menüsünü temel olarak keşfedin; Liste için gerekli olan hiçbir anahtar yoktur.
İş alanına kilitlenen API tuşları ★ YeniHer anahtar, iş alanı oluşturmak için kilitlenir, bu yüzden çok katmanlı izolasyon otomatikdir.
API Key Revo (Instant) ★Bir sızıntı anahtarı uyandırdı ve çağrıları hemen başarısız oldu.
Otomasyon kuralları
Webhook Step ile İş AkışlarıPOST to a URL as one step inside a multi-step otomasyon.
Görsel Kural Builder ★Drag-drop koşulları ve eylemler: X olduğunda, Y, kodu yapmayın.
Etkinlik son noktaları
Eylem Sözleşmeleri ★Her işlem parametreleri, teslimat türü, doğrulama ve yanıt işleme ilan eder.
İzinli Execution ★Eylemler bir operatör izni gerektirebilir; API aramaları ayrıca kayıtlı en az kardigi kapsamını da uyguluyor.
Risk-Aware Onaylama ★Yüksek riskli ve yıkıcı Gateway eylemleri onay gerektirir; AI oto-run yıkıcı bir çalışma yapamaz.
Action Log ★Denetim etkinleştirildiği zaman, OpsIQ kayıtları kırmızıacted parametreler, durum, sonuç, süresi ve dağıtım kanıtları.
Güvenilebilir HTTP Kimlik Doğrulaması ★Uzak eylemler Ayıer, API-key, Temel veya HMAC kimlik doğrulamasını kullanabilir; yönlendirmeler ve güvenli olmayan hedefler bloke edilir.
Çok fazla bebek
Son Nokta Kapsamı Yalıtımı ★ Yeniscope_kind/scope_key Her uç noktası, anahtar ve log satırını iş alanına aktarıyoruz.
SSS

Webhook soruları, Cevap verdi.

Her takım daha önce soruyor OpsIQ Geri kalanına: imza, geri dönüşler, inbound ve eylemler.

paylaşılan sırrınızı kullanarak ham istek gövdesi üzerinde HMAC-SHA256; X-OpsIQ-Signature Hex, ekle sindirmemektedir. Sürekli zamanlı bir kontrol ile karşılaştırıldığında, hash_equals()Örnek kod geliştiricileri sayfasında ve yukarıdaki imza bölümünde.
İlk istekten sonra,OpsIQBeş retries'e kadar programlar: 1m→5m→30m→ 2h → 12h6 başarısız olursa, teslimatın işaretli bir şekilde başarısız oldu. Tarih statüsünü koruyor, yanıt veriyor ve tanı için sayılıyor.
Evet. Her uç noktasının herhangi bir zamanda yeniden üretebileceğiniz kendi sırrı vardır: döndürmek, sonra yeni sırda verifier işaret edin.
Evet. Görsel kural oluşturucu ("X olduğunda, Y") müşteri tier, öncelik veya anahtar kelime koşulları ile en iş akışlarını kapsar. Kod-sadece REST API aracılığıyla yollar karmaşık durumlar için mevcuttur.
52 canonical events span commerce, billing, support, CRM, security and analytics, for example order.created, payment.completed, invoice.paid, subscription.renewed, ticket.created, crm.deal.won ve analytics.anomalyHer uç noktası abone olabilir * veya kesin bir alt kümesi.
Evet. eşsiz bir uç noktası oluşturmak için oluşturun URL ve gizli imzalayın, seçin a Stripe, Calendly veya jenerik alan açma öncesi, sonra gönderme sistemi veya röleğe sahip olun HMAC- hamilini yap JSON. OpsIQ İmzayı doğrulayın, iletişim e-postasını çıkarın ve bu temasa kabul edilen aktiviteyi ekler.
Uzak bir eylem arka uçunuz için açık bir işlem sözleşmesidir. Parametreleri, doğrulamayı, izinleri ve onay politikasını ve yanıt almayı ilan eder. Yüksek riskli Gateway eylemleri onay gerektirir, AI otomatik olarak yıkıcı eylemler yapamaz ve uygulama oturumunu koruyabilir.
REST API için sorun anahtarları ve anahtar başına bir izin modu seçin: Hepsi, Sadece okuyun, or Kısıtlı ( Vahşi kartpostaları da dahil olmak üzere belirli eylemler crm.contacts.*). per-hour rate limit ve bir Seçmeli IP izin listesi ekleyin. Her anahtar, içinde yaratılmış olan çalışma alanına kilitlenir.
Outbound webhooks kullanımı en küçük teslimiyette kullanılır. Kaç imzasını teyit edin, eski bir imzayı reddeder, eski olmayan bir imza reddeder X-OpsIQ-TimestampSonra devam et X-OpsIQ-Delivery Bir yazı uygulamadan önce. Bu teslimat ID zaten işlendiyse, işlemi tekrarlamadan 2xx yanıt geri dön.