Malalawak na pangyayari
Isulat ang anumang HTTPS endpoint na kanonikal OpsIQ mga pangyayari, na may mga panala sa bawat patutunguhan.
🪝Webhooks & automition
Kahit ano, saan man.
Isulat ang MGA HTTP URL sa OpsIQ mga pangyayaring kailangan nito. Ang bawat paghahatid ay HMAC-SHA256 na nilagdaan, workspace-scopted at sinusubaybayan sa pamamagitan ng isang anim-attemp na retry lifecycle. Magtayo ng mga patakarang visual, tumanggap ng mga kaganapang pangguhit, o tumawag ng mga independiyenteng aksiyon sa pamamagitan ni Heneral API.
52 canonical eventsHMAC-SHA256 sa bawat paghahatidUnang pagtatangka + limang retriageMaayos na paghahatid ID sa ibayo ng mga retriya
Nilagdaan sa pinagmumulan
Mga retrition hanggang sa ito'y lumapag
Mabuhay
52kanonikal na mga pangyayari na isuskribe
HMACNilalagdaan sa bawat paghahatid
5×nakaiskedyul na mga retries pagkatapos ng unang pagtatangka
NakopyaMga staint at troso na naka-track sa isang workspace
Pangyayari
Mga pangyayaring magaganap. Ang pagkilos ay kapuwa nangangahulugang sa atin.
Isang pinamamahalaang silid para sa pagkontrol ng pagsasama - sama ng mga tao ang may tatlong magkaibang landas: nakapirma nang walang bayad na paghahatid, nagpapatunay sa di - matarok na mga resibo, at maliwanag na mga kontrata sa pagkilos sa likod.
Mga Pagtanggap na Walang Paa
Binirmahan ang Veroy JSON, i - map ang mga field nito at idikit sa tamang contact ang tinatanggap na gawain.
May - katusuhang pagkilos
Ipahayag ang mga parameter, annitation, permit at mga kahilingan ng kumpil kada operasyon.
OpsIQ climber bus Nilalagdaang trapiko
Isang bus, tatlong direksiyon
Nakalabas
Mga webhook
Mga webhook
Nananagana
pangyayari
pangyayari
Nilagdaan
nuong bus
nuong bus
Pagkilos
POST
POST
invoice.paidyour-crm.com/hook200stripe.payment_intentPag - uusapMapaai.action.approved/api/provisionpumirmaTandaHMAC-SHA256
Ang bawat paghahatid ay nagdadala ng mga tagatanggap na pang-ulo ay maaaring kumpirmahin sa isang patuloy-panahong paghahambing.
KorreksiyonMatatag na ID
X-OpsIQ-Delivery ay nagpapakilala sa gayunding paghahatid sa bawat pagtatangkang muling pag - isipan.
KasaysayanHindi Mahalaga
Tingnan ang katayuan, subukang bilangin, tugon sa pag-sippeto at retry stack para sa bawat outbound admission.
Relibilidad · retries
Bumababa ang mga limitasyon. Patuloy na nagsisikap ang mga tagapagligtas.
Ang bigong paghahatid ay kumikilos sa isang espesipikong hagdan (natapos ang paghahatid)1m → 5m → 30m → 2h → 12h). Na nagbibigay ng isang panimulang pagtatangka at limang nakatakdang retries ang mga pangyayari. Ang kasaysayang pang-importasyon ay nagpapanatili sa katayuang HTTP, tugon na snippet, tangkang pagbilang, susunod na oras ng muling pag-eensayo at isang matatag na paghahatid na ID na magagamit ng iyong receiver para sa deduksyon.
Binigyang - katuturan ang pagbaligtad ng likod: limang nakaiskedyul na retries (1m→5m→30m→ 2h → 12h) pagkatapos ng unang kahilingan, kung gayon ang paghahatid ay minarkahang bigo.
Per-endpoint na pang-radyo: ang huling hatid ng berde / amber / pula sa isang sulyap, na may status code at panahon.
At-least-chon, ay gumawa ng maliwanag: Tiyakin ang lagda, tanggihan ang mga lumang timestamp at alisin ang mga kuwadra
X-OpsIQ-Delivery halaga sa iyong receiver.14h36msa pamamagitan ng pangwakas na pagtatangka
6pinakamaraming kabuuang pagtatangka
Nagsibalik1m → 5m → 30m →2h → 12h
KorreksiyonMatatag na paghahatid ID sa kabila ng mga pagtatangka
Kaligtasan ng pagtanggappasses na suriin + paghahatid-ID dedupe
Pagmamamasa ng dalawang-way
Tanggapin ang mga pangyayari, at hayaan ang AI kumilos nang ligtas.
Iba't iba ang mga endpoint at adviction endpoint, kaya iba na ngayon ang hitsura: isang mapa sa labas ng mga pangyayari sa mga contact, ang ibang tarangkahan AI na kumikilos bago pa man matawag ang iyong backend.
Ang mga pangyayari sa labas ay nasa tamang timeline.
Gumawa ng kakaibang katangian URL at paglagda ng lihim, mapa ang JSON mga bukid, saka hayaang OpsIQ Ikabit ang bawat tinatanggap na pangyayari sa katugmang contact.
https://opsiq.example/api/v1/inbound.php?t=wh_7c91...
contact_email_path
$.customer.email
event_type_path $.type
idempotency_key_path $.id
Maaaring humiling ang AI ng trabaho nang hindi natatakasan ang kontrata.
Ipahayag ang mga parameter, mapagkakatiwalaan at pinapayagan; nangangailangan ng kumpil para sa high-risk na sulat bago ang pagbitay.
billing.issue_creditIlagayKumpilPERO
Mga susi na may pahintulot, limitasyon at pinahihintulutan ang mga list.
Ang mga key ng isyu ay ginagamit ng mga kasangkapan at kapareha nang hindi binibigyan ng buong lakas ang bawat pagsasama.
HI dashboard Magbasa lamang
Pag - aapura ng mag - asawa Nahigpit
panloob na kagamitan Lahat
Ang mga landas ng kasunduan ay nananatiling malinis.
Para sa masalimuot na mga daloy ng trabaho, tawagin ang REST API direktang may parehong saklaw na modelo.
POST /api/v1.php
Pagkakasundo: Tagapagdala opq_workspace_key
{ "action": "crm.conversions.record" }
Pagkakasundo: Tagapagdala opq_workspace_key
{ "action": "crm.conversions.record" }
Matinding pagkabukod
Ang bawat staint at key ay Maglakip ng workspace.
Ang seguridad ay may sarili nitong sistema ng paningin dito: ang paghahatid URLs ay binabantayan laban sa SSRF, ang mga key ay sakop sa isang workspace, at cross-tenant request bago ang anumang datos ay basahin.
0Mga palatandaan sa buong daigdig
403di - sinasadyang saklaw
Pagpapalaya URLs ay hindi makabaling sa loob.
OpsIQ blocks pribado, loopback, link-local at ulap metadata targets sa ligtas oras at ulit sa pagpapadala ng oras.
your-crm.compinapayagan
127.0.0.1bloke
10.0.0.5bloke
169.254.169.254bloke
Ang mga hangganan ng komputa ay bahagi ng susi.
Mga Endpoint, inbound resibo, mga trosong panghatid at API Ang lahat ng susi ay may tatak ng workspace na lumikha nito.
Lugar ng Trabaho Asusi opq_a1...
dulo ng estasyon /hook-a
saklaw_key ws_a
dulo ng estasyon /hook-a
saklaw_key ws_a
Lugar ng Trabaho Bsusi opq_b7...
dulo ng estasyon /hook-b
saklaw_key ws_b
dulo ng estasyon /hook-b
saklaw_key ws_b
Isang susi mula sa workspace A na tinatawag na workspace B return 403 bago mag-akses ng datos.
Ang bawat kahilingan ay tumatawid sa iisang pintuang - daan.
Tandaat, lawak ng workspace, pinahihintulutang mode, hangganan ng rate at opsyonal IP Ang entlist ay sinusuri bago ang kahilingan ay umabot sa datos ng negosyo.
Lahat ng nasa kahon
Isang pagsasama - sama, na kayo'y nakasuksok.
Malalawak na pangyayari
Subscribe any HTTPS URL to 52 canonical events, filtered per endpoint and signed with HMAC-SHA256.
Mga Daang Walang Paa
Isang Pambihirang Bagay URL + Maglihim sa bawat source; kumpirmahin-verified at iguhit sa tamang contact timeline.
Mga kontrata sa Pagkilos
Ipahayag ang mga parameter, realation, pinahihintulutan, patakarang kumpil at audit na pag-uugali para sa mga operasyon ng backend.
⚖️ Kung saan ito ay angkop
Walang kagamitan sa kola ang iyong inarkila. Isang katutubong saping pangkasarian.
Ang Zapier at Make ay mahusay para sa pag-scop ng mga apps nang magkasama, ngunit sila ay nauupo sa labas ng inyong platform, hindi maaaring mag-rap AI access, at metro bawat pagtakbo. OpsIQ Ang mga pangyayari, lagda at kilos ay katutubo, ibinabahagi ang parehong datos ng iyong chat, CRM at mga tiket.
| Kung ano ang kailangan mo | Raw Zapier / Gawa | OpsIQ Webhook at mga Aksiyon |
|---|---|---|
| Ikinintsahe, dokumentadong katalogo ng pangyayari | Per-ap, pabagu-bago | 52 canonical OpsIQ events |
| HMAC-SHA256 na nilagdaang pang-agham | Pambihira / DIY per phurse | Nilagdaan ang bawat pahayag, lihim sa bawat endpoint |
| Per-endpoint na mga filter | Isang siklab sa bawat tikón | Ligáw o eksaktong subset, bawat isa URL |
| Awtomatikong mga retriya + kasaysayan | Limitado / may bayad na mga baytang | Unang pagtatangka + limang nakaiskedyul na retriya |
| Ligtas na paggaya sa pangangasiwa | Iyong itinatayo ito | Maayos na paghahatid ID + signing timestamp |
| Itali sa tamang pagdikit | Mga lupaing dumadaloy, hindi isang CRM | Mga mapa sa timeline |
| Gate AI ay kumikilos bago sila tumakbo | Walang ideya | patakarang pang-ekonomiyang Risk-acre |
| Iniutosg pagpatay | Hindi | Ang mga parameter ay nagreresulta sa resultang + at ang tagal ng logo ay na-publish |
| Nakopya API keys + hangganan ng bilis | Bulwagang tagapagsalaysay-sa buong-batas | Ang Lahat / Basahin-lamang / Nahigpit + CIDR |
| SSRF-hardened admission | Mga Varyo | Pribado / metadata IPs naharangan at muling nalutas |
| Per-run pagsukat / gawain caps | Oo, binabayaran mo ang bawat gawain | Katutubo: walang per-event na bilang |
| Iisang datos bilang chat / CRM / mga tiket | Pinagsamang mga app | Isang pinagmumulan ng katotohanan |
Buong listahan ng mga tampok
Lahat ng bagay sa Webhook at mga Aksiyon.
Ang bawat kakayahan, pinagsama-sama. ★ marka ng isang stand-out.
| Katangian | Kung ano ang ginagawa nito |
|---|---|
| Pangyayaring suskrisyon | |
| Outbound Event Catalog (52) ★ | Ikinuri ang kanonikal na mga pangyayari sa ibayo ng komersiyo, pagdodokumento, suporta, CRM, seguridad at analytics. |
| Mga Subscripsyon ng Ligaw na Parong Bakal (*) | Isulat ang isang endpoint sa lahat ng bagay nang may nag - iisa *. |
| Per-Endpoint Kaganapan Filter ★ | Isa URL ay tumatanggap ng billing, isa pang suporta, kaya walang ingay sa mga receiver na hindi nangangailangan nito. |
| Seguridad & Paglagda | |
| HMAC-SHA256 Tandag★ | Ang bawat payload ay pumirma na may isang per-endpoint lihim sa pamamagitan ng X-OpsIQ-Signature. |
| Hilaw-Body Signature | Tanda ang byte, hindi re-serialed na bagay, kaya walang anumang pinaanod sa pagitan ng nagpadala at receiver. |
| Tapat-Time Verification Recipe ★ | hash_equals() Ang patnubay upang ang mga sumasalakay ay hindi makakapag - iskedyul ng kanilang panahon tungo sa isang palsipikadong lagda. |
| ★ Naka-rotate Pag-sign Lihim | Regenerate a per-endpoint lihim sa anumang oras, pagkatapos ay updated ang iyong verifier. |
| X-OpsIQ_-Signature Header | Ginanap ng HMAC ang bawat isahang paghahatid para sa beripikasyon. |
| X-OpsIQ_-Timestamp Header | Ang hindi-ix na epoch sa bawat paghahatid upang ang mga receiver ay maaaring tumanggi sa mga lumang pangyayari. |
| Proteksyon ng Endpoint SSRF ★ BAGO | Blocks pribado, loopback at ulap-metadata IPs bilang mga target ng paghahatid, sa pag - iingat at sa panahon ng pagpapadala. |
| Muling Pagkontrol ng Pagtanggap★ | Isang nilagdaang Unix timestamp at matatag na paghahatid ng ID ang nagbibigay sa mga receiver ng mga input upang tanggihan ang mga lumang kahilingan at i-deduplicate na pagtatangka. |
| Muling Pag - asa at Muling Pag - aayos | |
| Di - nagbabagong Tagahatid★ | X-OpsIQ-Delivery ay nananatiling matatag sa ibayo ng mga retrie upang ang isang receiver ay makagawa ng idempotenteng sulat. |
| Isinisiwalat na Likod na Retry Crack★ | 1m → 5m → 30m → 2h → 12h: limang nakaiskedyul na retries pagkatapos ng panimulang pagtatangka. |
| Nakapagliligtas na Kasaysayan★ | HTTP status, tugon sa snippet, pagtatangka bilangin at susunod na retry time, color-coded green / amber / red. |
| Pagbibigay ng Per-Endpoint | Ang huling transaksyon na ipinakita na may katayuan sa isang sulyap, bawat endpoint. |
| Matipid na metadata | |
| X-OpsIQ_-Matter Header | Ang mga transaksyon ng celevent type kaya ang mga receiver ay maaaring ma-trade nang hindi parporsiyon ang katawan. |
| X-OpsIQ_-Heaty Header | Isang paghahatid na ID para sa pagsubaybay at pag - uugnay sa bawat pagtatangka. |
| Pagsubok & Epektasyon | |
| Pagsubok ng Paghahatid Bago Pumunta Buhay ★ | Apoyan ang isang sampol na binayaran at tingnan ang eksaktong JSON, lagda at tugon ng HTTP. |
| Mga Pinaka - signature (dry_run) | Ibalik ang napirmang sobre nang hindi nagpo - post, upang matiyak mo muna sa inyong lugar ang mga bagay na nangyari. |
| Naglalaman ng mga Sagot sa Pagsubok | Tiyaking ang isang mapa ay kumukuha ng email at lumilikha ng tamang gawain. |
| Pamamahala ng Endpoint | |
| Aktibo / Hindi Aktibong Togle | Pahiran ng totalpo ang isang endpoint nang hindi ito inaalis. |
| Pag - aalisan ng Imburnal na Katayuan | Ang pag - aalis ng mga pantanggal ay humihinto habang inihihinto ang mga troso. |
| Nakahabing mga webhook | |
| Mga Hangganan na Walang Hanggan★ | Isang Pambihirang Bagay URL At saka ilihim ang bawat source para sa isang sistema o relay na maaaring mag-sign ng HMAC-sign sa hilaw JSON katawan. |
| Inbound Lagda Verification ★ | Mga Verifies X-OpsIQ-Inbound-Signature bago mangyari ang anumang bagay. |
| JSON Pag-aaral ng mga Patlang ★ | Kumuha ng email, uri ng laro at halaga sa pamamagitan ng $.path mula sa anumang hugis ng sahod. |
| Pag - aalis ng Pangalan sa Iba't Ibang Bansa BAGO | Pilitin ang pangalan ng kontak contact_name_path Kaya ang timeline ay nagbabasa nang malinis. |
| Mahalagang Paglikom sa Larangan BAGO | Maglagay ng pera o numero na may halaga value_path para sa pag - iiskor at pag - uulat. |
| Buod ng Template ★ BAGO | Gumawa ng buod mula sa tao summary_path o a ${path} si template. |
| Mga preset mapping ng papasok na data ★ | Ang isa-click Stripe, Calendly at Zapier pes ay nagreresulta sa prefille. |
| Labis na Kawalang - Kakayahan★ | Kailan idempotency_key_path ang isang pangyayari na ID, ang mga kopyang resibo ay nagbabalik ng tagumpay nang hindi lumilikha ng ibang gawain. |
| Inbound na aktibidad sa Timeline ng Contact ★ | Ang tinatanggap na mga pangyayari ay nagiging hindi kanais - nais, madaling pagmulang mga gawain sa pakikipag - ugnayan. |
| Nakasusuyang Log | ok / error / dipt / di-makulayan ng hilaw na sahod na dala para sa pag-iimbestiga. |
| API& access control | |
| APIMga Susi:3Mga Mode ng Pagpapahintulot★ | Lahat ng mga pinagkakatiwalaang kasangkapan, Read-lamang para sa mga dashboard, o nilimitahan upang harangan ang espesipikong mga kilos. |
| APIPangunahing Bilang na Limitado★ | Tawag-per-oras kada susi na may live na gamit na bar. |
| API Key IP Listahan ng mga pinapayagan (CIDR) ★ | Maglagay ng susi sa opisina o data-centre IPs kasama ang CIDR ranges. |
| Buong Aklat ng mga Aksyon (meta. actions) ★ | Alamin ang isang susing maaaring tawagin ng buong menu ng aksiyon; walang susi na kailangan upang itala. |
| Naka-track ang Workspace-LockAPIMga Susi★ BAGO | Bawat key ay naka-lock sa kanyang paglikha ng workspace, kaya ang multi-tenant na pagbubukod ay awtomatiko. |
| API Pag-alis ng Key (Instant) ★ | Bugpuin ang isang tumutulong susi at ang mga tawag nito ay agad na nawawala. |
| Mga tuntunin sa paggamit ng mga makina | |
| Mga Bukál na May Webhook Hakbang | POST to a URL _) bilang isang hakbang sa loob ng isang multi-sect automation. |
| ★ Visual Panuntunan Tagabuo | Kalagayan at kilos ng Drag-drop: kapag nangyari ang X, gawin ang Y, walang code. |
| Ang mga Katayuan sa Pagkilos | |
| Mga Kontrata sa Pagkilos★ | Ang bawat operasyon ay nagpapahayag ng mga parameter, uri ng paghahatid, awtentasyon at pagtugon na humahawak. |
| Pagpapahintulot-Gulang na Pagbitay★ | Ang mga pagkilos ay maaaring mangailangan ng pahintulot ng operator; API Ipinatutupad din ng mga tawag ang kanilang nakarehistrong minimum-pribilege curcations. |
| Panganib-Aware Kumpil ★_ | Ang mga aksiyong high-risk at mapanirang Gateway ay nangangailangan ng kumpil; ang AI ay hindi maaaring magpatakbo ng auto-run na nakasisirang gawa. |
| Ang Pagpatay sa Gawa ay Hindi Totoo★ | Kapag ang audition ay nagawa, OpsIQ ay nag - uulat ng muling isinagawang mga parameter, katayuan, resulta, tagal at katibayan ng paglalagay. |
| Kapani - paniwalang HTTP Registation ★_ | Maaring gumamit ng Bearer, API-key, Basic or HMAC realityation; ang mga redirect at hindi ligtas na target ay hinahadlangan. |
| Multi-tenant | |
| Wakas na Pagbukod ng mga Eskope★ BAGO | scope_kind/scope_key Ibinitin ang bawat staint, key at log row sa workspace nito. |
KABAITAN
Mga tanong sa Webhook, ang sagot.
Lahat ng hingin ng mga koponan sa harap nila ay alambre OpsIQ sa natitirang bahagi ng kanilang salansan: paglagda, retries, inbound at mga kilos.
Commute HMAC-SHA256 sa hilaw na request body gamit ang iyong kabahaging lihim;
X-OpsIQ-Signature ay na ang hex ay natutunaw nang walang panlapi. Ihambing sa isang content-time check tulad ng unlapi hash_equals(). Sample code ay nasa developers page at sa signing section sa itaas.Pagkatapos ng unang kahilingan,OpsIQmga iskedyul na umaabot sa limang retries: 1m→5m→30m→ 2h → 12h. Kung mabigo ang pagtatangka ng anime, ang paghahatid ay minarkahang nabigo.Ang kasaysayan ay nagpapanatili sa katayuan nito, tugon snippet at tangkang pagbilang para sa diyagnosis.
Oo, ang bawat endpoint ay may sarili nitong sekreto na maaari mong baguhin sa anumang oras: iikot ito, pagkatapos ay ituro ang iyong virifier sa bagong sekreto.
Oo, ang tagapagtayo ng tuntunin sa paningin ("kapag nangyari ang X, do Y") ay sumasaklaw sa karamihan ng mga daloy ng trabaho, na may mga kondisyon sa mga customer pain, prior o keyword. Code-lamang mga landas sa pamamagitan ng REST API ay makukuha para sa masalimuot na mga kaso.
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 at analytics.anomaly. Ang bawat endpoint ay maaaring magskriba * o isang eksaktong subset.Gumawa ng isang inbound endpoint para magkaroon ng kakaibang tool URL at paglagda ng lihim, pumili ng isang Stripe, Calendly o generic field-mapping preset, pagkatapos ay magkaroon ng sistemang pagpapadala o relay HMAC-sign ang hilaw nito JSON. OpsIQ Ang lagda ay inilakip, kinukuha ang contact email at dinaragdagan ang tinatanggap na gawain sa pakikipag - ugnayang iyon.
Ang isang malayong aksiyon ay isang maliwanag na kontrata sa operasyon para sa iyong backend. Ito ay nagpapahayag ng mga parameter, realation, pahintulot, patakarang kumpil at tugon na humahawak. Ang mga aksiyong High-risk Gateway ay nangangailangan ng pagpapatunay, AI hindi maaaring gawin ang auto-run mapanirang pagkilos, at ang paglalapat ng pagtotroso ay maaaring mapanatili ang redacted na katibayan.
Mga susing Isyu Para sa REST API at pumili ng paraan ng pahintulot sa bawat susi: Lahat, Magbasa lamang, or Nahigpit ( Barahan ang espesipikong mga pagkilos, pati na ang mga ligaw na baka
crm.contacts.*). Magdagdag ng limitasyon sa per-hour rate at isang opsyonal IP Bawat key ay naka-lock sa workspace na nilikha nito.Ang mga outbound webhook ay gumagamit ng sa-least-conced na paghahatid. Verify the want-body lagda, tanggihan ang isang lumang-pook na lagda
X-OpsIQ-Timestamp, pagkatapos ay magpatuloy X-OpsIQ-Delivery Kung ang paghahatid na iyon ng ID ay nagawa na, ibalik ang 2xx na tugon nang hindi inuulit ang operasyon.