Peristiwa Outbound
Langgan setiap titik akhir HTTPS untuk canonical OpsIQ events, dengan filter per destinasi.
🪝 Otomasi Webhooks &
Memicu apa saja, Di mana saja.
Langgan HTTPS URL Ke OpsIQ Setiap pengiriman adalah HMAC-SHA256 yang ditandatangani, di ruang kerja terskop dan dilacak melalui enam attempt retry lifecycle. Membangun aturan secara visual, menerima acara yang dipetakan, atau panggilan diatur tindakan melalui Umum API.
52 canonical events\"HMAC-SHA256\" pada setiap pengirimanInitial attempt + five retriesID pengiriman yang dapat diseberang retrie
Signed di sumber
Akan kembali ke tanah
Aras
52Peristiwa kanonikal untuk dilanggani
OOB HMACDitandatangani pada setiap pengiriman
5×Jadwal ulangan dijadwalkan setelah percobaan awal
SkopLog dan titik akhir fined dan log terkunci ke satu ruang kerja
Router peristiwa
Acara keluar. Tindakan kedua arah.
Ruang kontrol integrasi yang diatur untuk tiga jalur berbeda: pengiriman outbound ditandatangani, penerimaan inbound diverifikasi, dan kontrak aksi backend eksplisit.
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.
OpsIQBas acara Lalu lintas ditandatangani oleh perusahaan
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 pengiriman membawa penerima header dapat memverifikasi dengan perbandingan konstan-waktu.
KorelasiID Stabil
X-OpsIQ-Delivery Keheron mengidentifikasi pengiriman yang sama di setiap percobaan coba lagi.
SejarahDapat disejahjahkan
Lihat status, jumlah percobaan, snippet respon dan coba lagi waktu untuk setiap pengiriman outbound.
Keandalan Divinai · retries
Titik akhir jatuh. Pengiriman terus berusaha.
Sebuah pengiriman gagal yang gagal bergerak melalui tangga didefinisikan (1m → 5m → 30m → 2h → 12h). Yang memberikan setiap acara satu percobaan awal ditambah lima retries terjadwal. Sejarah pengiriman menyimpan status HTTP, snippet response, trib count, waktu coba ulang berikutnya dan ID pengiriman stabil penerima Anda dapat digunakan untuk deduktasi.
Ditakrifkan backoff: Pesta ulangan terjadwal kelima → 5 m → 30m →2h → 12h) setelah permintaan awal, maka pengiriman ditandai gagal.
Jalur pengiriman per-endpoint: Terakhir pengiriman hijau / ambar / merah sekilas, dengan kode status dan waktu.
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 pengiriman stabilis melintasi upaya
Penerima jaminan keselamatanPemeriksaan setem waktu estamp dan pengiriman-ID dedupe
Otomasi dua arah
Requieved events, dan membiarkan AI - Kau harus bertindak dengan aman.
Titik akhir dan titik akhir aksi yang tidak terjamah adalah permukaan yang berbeda, sehingga sekarang mereka terlihat berbeda: satu peta di luar peristiwa ke kontak, gerbang AI tindakan lain sebelum backend Anda disebut.
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_creditCadangkanKonfirmasiAYAH
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 mitra kerja OFN 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.
Keamanan memiliki sistem visual sendiri di sini: pengiriman URLs yang dijaga terhadap SSRF, kunci-kunci terskop ke satu ruang kerja, dan permintaan lintas-tenan bouncing sebelum data apapun dibaca.
0Token global
403tidak sepadan skop
Pengiriman URLs Jangan menyerah.
OpsIQ \"Antar data meta lokal dan lokal dan awan\" pada waktu simpan dan waktu kirim.
your-crm.com**Diizinkan **
127.0.0.1blok KAN
10.0.0.5blok KAN
169.254.169.254blok KAN
Batas-batas penting adalah bagian dari kunci.
Titik akhir, penerimaan masuk, catatan pengiriman dan API Kunci kunci semua membawa stempel ruang kerja yang menciptakannya.
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 52 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
Parameter declare, autentikasi, perizinan, kebijakan konfirmasi dan perilaku audit untuk operasi backend.
⚖️ _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 kau butuhkan | / Membuat | OpsIQ Aksi Webhooks & |
|---|---|---|
| Katalog peristiwa terdokumentasi dan Typed | Per-app, tidak konsisten | 52 canonical OpsIQ events |
| Transmisi ditandatangani oleh HMAC-SHA256 | Rare / DIY by zap | Ditandatangani setiap pengiriman, rahasia per titik akhir |
| Filter peristiwa Per-endpoint | Satu pemicu tikaman. | Kad liar atau subset tepat, per URL_ |
| Coba ulang otomatis _mantra + sejarah | Ukur terbatas / dibayar | Percobaan awal ugugutan + lima jadwal ulangan |
| Penanganan duplikat yang dibuat dengan selamat | Kau yang membangunnya. | ID pengiriman STAble + timestamp ditandatangani |
| Kemasukkan ke kontak yang tepat | Tanah di aliran, bukan CRM | Peta ke garis masa kenalan |
| Tindakan Gate AI sebelum mereka lari | Tak ada konsep | Kebijakan konfirmasi yang sadar risiko |
| Eksekusi tindakan Audited | Tidak | Parameter codeacted + hasil dan durasi log |
| Skop API kunci + batas kadar | Token di seluruh akun | ** Semua / Baca-saja / Terhad + CIDR * |
| Pengiriman SSRF-keras | 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 |
Daftar fitur penuh
Semua yang ada di dalam Aksi Webhooks &.
Setiap keupayaan, dikumpulkan. ★ menandakan berdiri-out.
| Fitur Keupayaan | Apa yang dilakukannya |
|---|---|
| Acara berlangganan | |
| Outbound Event Catalog (52) ★ | Peristiwa kanonik yang diketikkan melintasi perdagangan, penagihan, dukungan, CRM, keamanan dan analitik. |
| Langganan Peristiwa Liar Kartu Liar (*) | Langgankan sebuah titik akhir untuk segala sesuatu dengan satu *. |
| Tapisan Acara Per-Titik Akhir ★ | one URL Dia mendapat tagihan, dukungan lain, jadi tidak ada suara pada penerima yang tidak membutuhkannya. |
| Penandatanganan & Keamanan | |
| 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() Pemandu agar penyerang tidak bisa waktu mereka untuk tanda tangan palsu. |
| Rahsia Tandatangan Putar ★ | Apobia regenerasi rahasia per-endpoint setiap saat, kemudian update penerang Anda. |
| X-OpsIQ-Signature Header | HMAC FOVE meneruskan setiap pengiriman untuk verifikasi. |
| X-OpsIQ-Timestamp Header | Epok Unix pada setiap pengiriman sehingga penerima dapat menolak acara basi. |
| Mantection SSRF Titik akhir ★_ BARU | Blokasi swasta, loopback dan cloud-metadata IPs sebagai target pengiriman, pada waktu simpan dan pada waktu kirim. |
| Penerima Replay Controls ★_ | A signed Unix timestamp dan ID pengiriman stabil memberikan penerima input untuk menolak permintaan basi dan upaya deduplicate. |
| 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 → 12hLima jadwal ulang setelah percobaan awal. |
| Sejarah Penghantaran ★ | Status HTTP, snippet response, hitung percobaan dan waktu coba lagi berikutnya, warna-kode hijau / amber / merah. |
| Kereta Antar-Jalan Antar-Titik-Per-Akhir | Pengiriman terakhir ditunjukkan dengan status sekilas, per titik akhir. |
| Data meta Pengiriman Data meta | |
| X-OpsIQ-Event Header | Cogories tipe event sehingga penerima dapat melakukan route tanpa mengontrol tubuh. |
| X-OpsIQ-Delivery Header | ID pengiriman untuk pelacakan dan korelasi setiap upaya. |
| Pengujian & validasi | |
| Pengiriman Uji sebelum Pergi ★_ | Dia menembakkan muatan sampel dan memeriksa persis JSON, tanda tangan dan respon HTTP. |
| Tandatangan Uji-tangan (dry_run) | Kemuliaan mengembalikan amplop yang ditandatangani tanpa mengirim surat, sehingga Anda dapat memverifikasi terlebih dahulu secara lokal. |
| Pengiriman Ujian yang Keanehan | 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 Aku ingin mencetak gol dan melaporkan. |
| 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 ★ | ORANG YANG 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 terkunci untuk menciptakan ruang kerja, sehingga isolasi multi-tenan otomatis. |
| 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 operasinya menyatakan parameter, jenis pengiriman, otentikasi dan penanganan respon. |
| Izin-Diizinkan Eksekusi ★_ | Aksi-aksi morfosis dapat memerlukan izin operator; API panggilan juga memberlakukan skop mereka yang tidak terdaftar. |
| Kepastian Risiko-Aware ★_ | Tindakan hematik dan destructure Gateway membutuhkan konfirmasi; AI tidak dapat auto-run pekerjaan destruktif. |
| 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
Pertanyaan Webhook, Dijawab oleh Meka.
Semua tim meminta sebelum mereka kawat OpsIQ ke sisa tumpukan mereka: menandatangani, mengulang, masuk dan bertindak.
Mengkomput HMAC-SHA256 atas tubuh permintaan mentah menggunakan rahasia bersama Anda;
X-OpsIQ-Signature Ini adalah bahwa digest heks tanpa awalan. hash_equals()Kode sampel ada di halaman pengembang dan di bagian penandatanganan di atas.After the initial request, OpsIQ schedules up to five retries: 1m → 5m → 30m → 2h → 12h. If attempt six fails, the delivery is marked failed. The history retains its status, response snippet and attempt count for 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.
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 BAHWA DAN analytics.anomalySetiap titik akhir dapat berlangganan * - Ya atau subset yang tepat.Membuat titik akhir yang masuk untuk mendapatkan unik URL Dan menandatangani rahasia, pilih sebuah Stripe, Calendly atau praset pemetaan lapangan generik, lalu memiliki sistem pengiriman atau relay HMAC-tanda mentah JSON. OpsIQ Memverifikasi tanda tangan, mengekstrak email kontak dan menambahkan kegiatan yang diterima ke kontak itu.
Tindakan remote adalah kontrak operasi eksplisit untuk backend Anda. Ini menyatakan parameter, otentikasi, izin, kebijakan konfirmasi dan penanganan respon. Tindakan High-risk Gateway membutuhkan konfirmasi, AI tidak dapat menjalankan auto-run tindakan destruktif, dan eksekusi logging dapat mempertahankan bukti yang dicadangkan.
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.Outbound webhooks menggunakan pengiriman paling tidak sekali. Verifikasi tanda tangan tubuh mentah, tolak yang lama
X-OpsIQ-Timestamp, kemudian terus X-OpsIQ-Delivery Jika ID pengiriman sudah dilakukan, kembalikan respon 2xx tanpa mengulang operasi.