Peristiwa Outbound
Langgan setiap titik akhir HTTPS untuk canonical OpsIQ events, dengan filter per destinasi.
🪝 Otomasi Webhooks &
Memicu apa saja, Di mana saja.
Langgankan URL HTTPS kepada peristiwa OpsIQ yang diperlukannya. Setiap penghantaran ditandatangani dengan HMAC-SHA256, berskop ruang kerja dan dijejaki melalui kitaran hayat cubaan semula enam kali. Bina peraturan secara visual, terima peristiwa yang dipetakan, atau panggil tindakan terkawal melalui General API.
53 peristiwa kanonikHMAC-SHA256 pada setiap penghantaranCubaan awal + lima cubaan semulaID penghantaran yang stabil merentas cubaan semula
Signed di sumber
Akan kembali ke tanah
Aras
53Peristiwa kanonikal untuk dilanggani
OOB HMACditandatangani pada setiap penghantaran
5×cubaan semula berjadual selepas percubaan awal
SkopLog dan titik akhir fined dan log terkunci ke satu ruang kerja
Router peristiwa
Acara keluar. Tindakan kedua arah.
Bilik kawalan integrasi yang ditadbir untuk tiga laluan berbeza: penghantaran keluar bertandatangan, penerimaan masuk yang disahkan, dan kontrak tindakan bahagian belakang yang jelas.
Penerimaan Inbound
Kepastian pengesahan ditandatangani JSON, petakan bidangnya dan lampirkan aktivitas yang diterima ke kontak yang tepat.
Tindakan yang diambil oleh pemerintah
Parameter deklare, autentikasi, perizinan dan persyaratan konfirmasi per operasi.
OpsIQ Bas acara trafik bertandatangan
Satu bus, tiga arah
Ke Luar Kejam
webhook
webhook
Kemudi
acara
acara
Tandatangani
bus acara vin
bus acara vin
Aksi
POST
POST
invoice.paidyour-crm.com/hook200stripe.payment_intentGaris waktu kontak frekuensimapdenai.action.approved/api/provisionDitandatangani oleh Sony_TandatanganHANZO HMAC-SHA256
Setiap penghantaran membawa pengepala yang boleh disahkan oleh penerima dengan perbandingan masa malar.
KorelasiID Stabil
X-OpsIQ-Delivery mengenal pasti penghantaran yang sama merentas setiap percubaan semula.
SejarahDapat disejahjahkan
Lihat status, bilangan percubaan, petikan respons dan masa cubaan semula bagi setiap penghantaran keluar.
Keandalan Divinai · retries
Titik akhir jatuh. Penghantaran terus dicuba.
Penghantaran yang gagal bergerak melalui tangga yang ditetapkan (1m → 5m → 30m → 2h → 12h). Ini memberi setiap peristiwa satu percubaan awal serta lima cubaan semula berjadual. Sejarah penghantaran menyimpan status HTTP, petikan respons, bilangan percubaan, masa cubaan semula seterusnya dan ID penghantaran yang stabil yang boleh digunakan oleh penerima anda untuk penyahduaan.
Ditakrifkan backoff: lima cubaan semula berjadual (1m → 5m → 30m → 2h → 12h) selepas permintaan awal, kemudian penghantaran ditandakan sebagai gagal.
Landasan penghantaran bagi setiap titik akhir: penghantaran terkini hijau / ambar / merah sepintas lalu, dengan kod status dan masa.
Pada-timur-sekali, dibuat eksplisit: Verifikasi tanda tangan, tolak waktu basi dan deduplikasi stabil
X-OpsIQ-Delivery Nilainya di penerimamu.14h 36mMelalui upaya terakhir
6upaya maksimum maksimum total
Mengeluarkan1m → 5m → 30m → 2h → 12h
KorelasiID penghantaran yang stabil merentas percubaan
Penerima jaminan keselamatansemakan cap masa + penyahduaan ID penghantaran
Otomasi dua arah
Requieved events, dan membiarkan AI bertindak dengan selamat.
Titik akhir masuk dan titik akhir tindakan ialah permukaan yang berbeza, jadi kini ia kelihatan berbeza: satu memetakan peristiwa luar kepada kenalan, yang satu lagi mengawal tindakan AI sebelum bahagian belakang anda dipanggil.
Peristiwa luaran mendarat di garis waktu yang tepat.
Cipta sebuah unik URL Dan menandatangani rahasia, memetakan JSON Kalau begitu biarkan saja. OpsIQ Pada setiap acara yang diterima untuk kontak yang cocok.
https://opsiq.example/api/v1/inbound.php?t=wh_7c91...
contact_email_path
$.customer.email
event_type_path $.type
idempotency_key_path $.id
AI dapat meminta kerja tanpa melarikan diri kontrak.
Parameter declare, autentikasi dan perizinan; memerlukan konfirmasi untuk penulisan berisiko tinggi sebelum eksekusi.
billing.issue_creditCadangkanKonfirmasiLaksanakan
Kunci ke-kunci dengan izin, batas dan daftar izin.
Takeed issue kunci ruang kerja untuk alat dan mitra tanpa memberikan setiap integrasi kekuatan penuh.
BARIS BI dashboard Hanya Baca-baca
Aplikasi rakan kongsi Dilarang
Alat Internal Ufuk Semua
Jalur kode tetap bersih.
Untuk alur kerja kompleks, hubungi REST API langsung dengan model terskop yang sama.
POST /api/v1.php
Otorisasi: Xherine Bearer opq_workspace_key
{ "action": "crm.conversions.record" }
Otorisasi: Xherine Bearer opq_workspace_key
{ "action": "crm.conversions.record" }
Kepencilan yang diperkeras
Setiap titik akhir dan kunci adalah Ke ruang kerja.
Keselamatan mempunyai sistem visualnya sendiri di sini: URL penghantaran dilindungi daripada SSRF, kunci dihadkan kepada satu ruang kerja, dan permintaan merentas penyewa ditolak sebelum sebarang data dibaca.
0Token global
403tidak sepadan skop
URL penghantaran tidak boleh menghala ke dalam.
OpsIQ menyekat sasaran peribadi, gelung balik, pautan setempat dan metadata awan semasa menyimpan dan sekali lagi semasa menghantar.
your-crm.com**Diizinkan **
127.0.0.1block
10.0.0.5block
169.254.169.254block
Batas-batas penting adalah bagian dari kunci.
Titik akhir, resit masuk, log penghantaran dan kunci API semuanya membawa cap ruang kerja yang menciptanya.
Ruang Kerja Ruang Kerja AKunci oq_a1...
Titik akhir /hook-a_
Skop_kunci skop ws_a
Titik akhir /hook-a_
Skop_kunci skop ws_a
Ruang Kerja Ruang Kerja BKunci opq_b7...
Titik akhir /hook-b_
Skop_kunci skop ws_b
Titik akhir /hook-b_
Skop_kunci skop ws_b
Kunci dari ruang kerja Sebuah ruang kerja panggilan B mengembalikan 403 sebelum akses data.
Setiap permintaan melintasi gerbang yang sama.
Signature, skop ruang kerja, mode izin, batas tarif dan opsional IP l membolehkan daftar diperiksa sebelum permintaan mencapai data bisnis.
Semua benda di dalam kotak
Satu permukaan integrasi, sepenuhnya berwayar.
Peristiwa Outbound
Subscribe any HTTPS URL to 53 canonical events, filtered per endpoint and signed with HMAC-SHA256.
Titik akhir yang tidak terbatas
A unik URL + rahasia per sumber; signature-verified dan dipetakan ke garis waktu kontak yang tepat.
Kontrak aksi
Isytiharkan parameter, pengesahan identiti, kebenaran, dasar pengesahan dan tingkah laku audit untuk operasi bahagian belakang.
⚖️ _Di mana cocok
Bukan alat lem yang kau sewa. Sebuah lapisan integrasi asli.
Zapier dan Make sangat bagus untuk merekam aplikasi bersama-sama, tetapi mereka duduk di luar platform Anda, tidak dapat gerbang tindakan AI, dan meter setiap run. OpsIQ's acara, tanda tangan dan tindakan adalah asli, berbagi data yang sama seperti chatting, CRM dan tiket.
| Apa yang anda perlukan | Raw Zapier / Buat | OpsIQ Aksi Webhooks & |
|---|---|---|
| Katalog peristiwa terdokumentasi dan Typed | Per-app, tidak konsisten | 53 peristiwa kanonik OpsIQ |
| Transmisi ditandatangani oleh HMAC-SHA256 | Rare / DIY by zap | Setiap penghantaran ditandatangani, rahsia bagi setiap titik akhir |
| Filter peristiwa Per-endpoint | Satu pemicu tikaman. | Kad liar atau subset tepat, per URL_ |
| Cubaan semula automatik + sejarah | Ukur terbatas / dibayar | Percobaan awal ugugutan + lima jadwal ulangan |
| Penanganan duplikat yang dibuat dengan selamat | Kau yang membangunnya. | ID penghantaran yang stabil + cap masa bertandatangan |
| Kemasukkan ke kontak yang tepat | Tanah di aliran, bukan CRM | Peta ke garis masa kenalan |
| Tindakan Gate AI sebelum mereka lari | Tak ada konsep | Dasar pengesahan yang peka risiko |
| Eksekusi tindakan Audited | Tidak | Parameter codeacted + hasil dan durasi log |
| Skop API kunci + batas kadar | Token seluruh akaun | ** Semua / Baca-saja / Terhad + CIDR * |
| Penghantaran yang diperkukuh terhadap SSRF | Varian | Private / data meta IPs diblokir, dipecahkan kembali |
| Per-larikan meteran / topi tugas | Ya, kau membayar setiap tugas | Penduduk Asli: tidak ada per-event tol |
| Data yang sama dengan chatting / CRM / tiket | Ketersalin antara aplikasi | Sumber kebenaran |
Senarai ciri penuh
Semua yang ada di dalam Webhook & Tindakan.
Setiap keupayaan, dikumpulkan. ★ menandakan berdiri-out.
| Ciri | Apa yang dilakukannya |
|---|---|
| Acara berlangganan | |
| Katalog peristiwa keluar (53) ★ | Peristiwa kanonik bertaip merentas perdagangan, pengebilan, sokongan, CRM, keselamatan dan analitik. |
| Langganan Peristiwa Liar Kartu Liar (*) | Langgankan sebuah titik akhir untuk segala sesuatu dengan satu *. |
| Tapisan Acara Per-Titik Akhir ★ | Satu URL menerima pengebilan, satu lagi sokongan, jadi tiada gangguan pada penerima yang tidak memerlukannya. |
| Keselamatan & tandatangan | |
| Tandatangan HMAC-SHA256 ★ | Setiap muatan ditandatangani dengan rahasia per-endpoint melalui X-OpsIQ-Signature. |
| Tandatangan Raw-Body | Tanda-tanda di bita, bukan objek yang diserialkan kembali, jadi tidak ada drift antara pengirim dan penerima. |
| Resepi Pengesahan Masa-Tetap ★ | hash_equals() panduan supaya penyerang tidak dapat menggunakan pemasaan untuk sampai kepada tandatangan palsu. |
| Rahsia Tandatangan Putar ★ | Apobia regenerasi rahasia per-endpoint setiap saat, kemudian update penerang Anda. |
| Pengepala Tandatangan X-OpsIQ | HMAC dibawa pada setiap penghantaran untuk pengesahan. |
| Pengepala X-OpsIQ-Timestamp | Epoch Unix pada setiap penghantaran supaya penerima boleh menolak peristiwa yang lapuk. |
| Mantection SSRF Titik akhir ★_ BARU | Menyekat IP persendirian, loopback dan metadata awan sebagai sasaran penghantaran, semasa menyimpan dan semasa menghantar. |
| Penerima Replay Controls ★_ | Cap masa Unix bertandatangan dan ID penghantaran yang stabil memberi penerima input untuk menolak permintaan lapuk dan menyahduakan percubaan. |
| Reliabilitasi dan retries | |
| Pengirim Dapat Diselenggarakan Pengenalpasti ★_ | X-OpsIQ-Delivery Dia tetap stabil di seluruh retries sehingga penerima dapat membuat menulis idempoten. |
| Tangga Cuba Semula Kembali Eksponensial ★ | 1m → 5m → 30m → 2h → 12h: lima cubaan semula berjadual selepas cubaan awal. |
| Sejarah Penghantaran ★ | Status HTTP, petikan respons, kiraan cubaan dan masa cubaan semula seterusnya, berkod warna hijau / kuning jingga / merah. |
| Kereta Antar-Jalan Antar-Titik-Per-Akhir | Penghantaran terakhir dipaparkan dengan status sepintas lalu, bagi setiap titik akhir. |
| Metadata penghantaran | |
| X-OpsIQ-Kepala Peristiwa | Cogories tipe event sehingga penerima dapat melakukan route tanpa mengontrol tubuh. |
| X-OpsIQ-Delivery Header | ID penghantaran untuk menjejak dan mengaitkan setiap percubaan. |
| Pengujian & validasi | |
| Uji Penghantaran Sebelum Disiarkan ★ | Dia menembakkan muatan sampel dan memeriksa persis JSON, tanda tangan dan respon HTTP. |
| Tandatangan Uji-tangan (dry_run) | Mengembalikan sampul yang ditandatangani tanpa menghantarnya, supaya anda boleh mengesahkannya secara setempat dahulu. |
| Penghantaran Ujian Masuk | Memastikan pemetaan mengekstrak email dan menciptakan aktivitas yang tepat. |
| Manajemen titik akhir mujar | |
| Jungkit Aktif / Tidak Aktif | Membatalkan titik akhir tanpa menghapusnya. |
| Penghapusan Keguguran dengan Pembatalan Tertangguh | Memadam mayat berhenti menunggu untuk kembali saat menyimpan catatan. |
| Bidik web yang tidak terjamah | |
| Titik Akhir Masuk ★ | A unik URL Dan ditambah rahasia per sumber untuk sistem atau relay yang dapat HMAC-tanda mentah JSON Tubuh tubuh. |
| Verifikasi ★Tandatangan Keanehan Tidak Keterlaluan | Dipastikan X-OpsIQ-Inbound-Signature Dia pernah terjadi sebelum hal lain terjadi. |
| ★ Pemetaan Laluan JSON | Ekstrak e-mel, jenis kejadian dan nilai melalui $.path Dari bentuk muatan apapun. |
| Pengekstrakan Nama Kenalan BARU | Tarik nama kontak dengan contact_name_path Jadi garis waktu berbunyi bersih. |
| Pengekstrakan Medan Nilai BARU | Politeknik Map nilai moneter atau numerik dengan value_path untuk pemarkahan dan pelaporan. |
| Ringkasan Templat ★_ BARU | Mengbina ringkasan manusia dari summary_path OR atau a ${path} Templat token . |
| Peta Praset Masuk ★ | \"Coffliff One-klik Stripe, Calendly dan Zapier\" telah siap. |
| Idempotency masuk ★ | Bila idempotency_key_path Pemecah menyelesaikan sebuah tanda pengenal acara, penerimaan duplikat kembali sukses tanpa menciptakan aktivitas lain. |
| Aktiviti masuk pada garis masa kenalan ★ | Acara yang diterima menjadi sangat mudah, memicu kegiatan pada kontak. |
| Log Penerimaan Masuk Kemuliaan | ore ok / error / duplikasi / unmapped dengan muatan mentah untuk debugging. |
| API Pengendalian akses | |
| Kekunci API: Mod Keizinan 3 ★ | Semua untuk alat-alat yang dapat dipercaya, Read-only untuk dashboard, atau dibatasi untuk memblokir tindakan tertentu. |
| API Pembatasan Kadar Kekunci ★ | ¡Calls-per-jam per kunci dengan batang penggunaan langsung. |
| API Kekunci IP Senarai Dibenarkan (CIDR) ★ | Kencan kunci ke kantor atau pusat data IPs dengan jangkauan CIDR. |
| Katalog Tindakan Segera (meta. actions) ★ | Discover menu aksi penuh sebuah kunci dapat memanggil; tidak ada kunci yang diperlukan untuk mendaftar. |
| Kekunci API Terkunci Ruangkerja ★ BARU | Setiap kunci dikunci pada ruang kerja yang menciptanya, jadi pengasingan berbilang penyewa adalah automatik. |
| API Pengisytiharan Kekunci (Segera) ★ | Membatalkan kunci bocor dan panggilannya segera gagal. |
| Aturan Otomasi | |
| Aliran Kerja dengan Langkah Webhook | ORANG POST ke URL Sebagai satu langkah di dalam otomasi multi-langkah. |
| Whats Visual Rule Builder ★ | Kondisi dan tindakan drag-drop: ketika X terjadi, lakukan Y, tanpa kode. |
| Titik akhir aksi Ukur | |
| Kontrak Aksi ★_ | Setiap operasi mengisytiharkan parameter, jenis penghantaran, pengesahan dan pengendalian respons. |
| Izin-Diizinkan Eksekusi ★_ | Aksi-aksi morfosis dapat memerlukan izin operator; API panggilan juga memberlakukan skop mereka yang tidak terdaftar. |
| Kepastian Risiko-Aware ★_ | Tindakan Gateway berisiko tinggi dan yang memusnahkan memerlukan pengesahan; AI tidak boleh menjalankan kerja yang memusnahkan secara automatik. |
| Log Aksi Eksekusi ★_ | Ketika auditing diaktifkan, OpsIQ Catatan rekor redacted parameter, status, hasil, durasi dan bukti penyebaran. |
| Autentifikasi HTTP ★_ yang dapat dikonfigurasi | Tindakan remote uglin dapat menggunakan Bearer, API-key, Basic atau HMAC autentikasi; pengalihan dan target yang tidak aman diblokir. |
| Multi-tenansi | |
| Lingkup akhir mata mata manifest ★_ BARU | scope_kind/scope_key Dan ada di setiap titik akhir, kunci dan baris log ke ruang kerja. |
Soalan Lazim
Soalan tentang webhook, Dijawab oleh Meka.
Semua yang ditanya oleh pasukan sebelum mereka menyambungkan OpsIQ dengan sistem mereka yang lain: tandatangan, cubaan semula, masuk dan tindakan.
Mengkomput HMAC-SHA256 atas tubuh permintaan mentah menggunakan rahasia bersama Anda;
X-OpsIQ-Signature ialah ringkasan heks itu tanpa awalan. Bandingkan dengan semakan masa malar seperti hash_equals()Kode sampel ada di halaman pengembang dan di bagian penandatanganan di atas.Selepas permintaan awal, OpsIQ menjadualkan sehingga lima percubaan semula: 1m → 5m → 30m → 2h → 12h. Jika percubaan keenam gagal, penghantaran ditandakan gagal. Sejarah menyimpan status, petikan respons dan bilangan percubaan untuk diagnosis.
Setiap titik akhir memiliki rahasianya sendiri yang dapat Anda hasilkan setiap saat: memutarnya, lalu mengarahkan pengverifikasi Anda pada rahasia baru.
Ya. Pembina peraturan visual ("bila X berlaku, lakukan Y") meliputi kebanyakan aliran kerja, dengan syarat pada peringkat pelanggan, keutamaan atau kata kunci. Laluan kod-hanya melalui REST API tersedia untuk kes kompleks.
53 peristiwa kanonik merangkumi perdagangan, pengebilan, sokongan, CRM, keselamatan dan analitik, contohnya
order.created, payment.completed, invoice.paid, subscription.renewed, ticket.created, crm.deal.won dan analytics.anomaly. Setiap titik akhir boleh melanggan * atau subset yang tepat.Ya. Cipta titik akhir masuk untuk mendapatkan URL unik dan rahsia tandatangan, pilih pratetap pemetaan medan Stripe, Calendly atau generik, kemudian minta sistem penghantar atau geganti menandatangani JSON mentahnya dengan HMAC. OpsIQ mengesahkan tandatangan, mengekstrak e-mel kenalan dan menambah aktiviti yang diterima kepada kenalan tersebut.
Tindakan jauh ialah kontrak operasi yang eksplisit untuk bahagian belakang anda. Ia mengisytiharkan parameter, pengesahan, kebenaran, dasar pengesahan dan pengendalian respons. Tindakan Gateway berisiko tinggi memerlukan pengesahan, AI tidak boleh menjalankan tindakan yang memusnahkan secara automatik, dan pengelogan pelaksanaan boleh menyimpan bukti yang telah disunting.
Keluarkan kunci untuk REST API dan memilih sebuah mode izin per kunci: Semua, Hanya Baca-baca, or Dilarang (Bahan tindakan spesifik, termasuk wildcard seperti
crm.contacts.*Tambah batas kadar per jam dan opsional IP Setiap kunci terkunci ke ruang kerja itu diciptakan.Webhook keluar menggunakan penghantaran sekurang-kurangnya sekali. Sahkan tandatangan badan mentah, tolak nilai lama
X-OpsIQ-Timestamp, kemudian terus X-OpsIQ-Delivery sebelum menggunakan sesuatu penulisan. Jika ID penghantaran itu sudah pun dilakukan, pulangkan respons 2xx tanpa mengulangi operasi tersebut.