🪝Mtandao wa Webhooks na automatisering

Kwa vyovyote vile, mahali popote.

Kujiandikisha kwa HTTPS URL Kwa upande wa OpsIQ Kila utoaji ni HMAC-SHA256 saini, workspace-scoped na kufuatiwa kwa njia ya sita-attempt retry lifecycle. Kujenga sheria Visually, kupokea matukio mapped, au wito unaoendeshwa vitendo kupitia General API.

52 canonical eventsHMAC-SHA256 kwa kila utoajiJaribio la kwanza + 5 retKuwasilisha kwa retries
Imewekwa kwenye chanzo
Kusubiri mpaka nchi zipate uhuru
Maisha ya kuishi One event. Signed. Tracked through delivery. Matukio ya Kwa hivyo invoice.paid HMAC 256 yahoo your-crm.com /hook 200 OK Mwisho wa Point Jaribio la jaribio 2/6 · Kugeuka nyuma Maisha ya upendo your-crm.com/hook200 · Kutolewa slack.com/services200 · Kutolewa
52Matukio ya kimichezo ya kujiunga
HMAC yaKujiandikisha kwa kila utoaji
Kurejea kwa utaratibu baada ya jaribio la kwanza
KuonekanaVifaa na vifaa vya kufungwa kwa nafasi moja ya kazi
Tukio la router

Matukio ya matukio. hatua kwa njia zote mbili.

Chumba cha udhibiti wa ushirikiano unaosimamiwa kwa njia tatu tofauti: saini ya kujifungua, risiti zilizothibitishwa, na mikataba ya hatua za kurudi nyuma wazi.

Kutoka nje

Matukio ya nje

Jisajili mwisho wa HTTPS kwa matukio ya kawaida ya OpsIQ, na filters kwa kila marudio.

Ndani ya

Mapato ya ndani

Thibitisha saini ya JSON, ramani ya mashamba yake na kuunganisha shughuli zinazokubaliwa kwa mawasiliano sahihi.

KAZI

Vitendo vya rushwa

Kutangaza vigezo, uthibitishaji, ruhusa na mahitaji ya uthibitisho kwa kila operesheni.

OpsIQ Tukio la ajali ya basi Trafiki iliyosainiwa

Moja ya njia, tatu

Kutoka
Mtandao wa Yahoo
Inbound ya ndani
Matukio ya matukio
Saini
Tukio la ajali ya basi
Hatua ya hatua
POST
invoice.paidyour-crm.com/hook200
stripe.payment_intentMawasiliano ya MudaMawa
ai.action.approved/api/provisionMkataba wa
Ishara yaHMAC 256 yahoo

Kila mteja ana uwezo wa kuthibitisha na wakati wa malipo.

Uhusiano waUtambuzi wa

X-OpsIQ-Delivery Inafafanua utoaji sawa katika kila jaribio la retry.

Historia ya historiaKutokuwa na uhakika

Angalia hali, hesabu ya jaribio, jibu la snippet na muda wa kurejesha kwa kila utoaji ulio nje.

Kuaminika · Retries

Mwisho wa pointi ni chini. Watoa huduma wakiendelea kujaribu.

Kuondolewa kwa njia ya mkojo (kupitia njia iliyoelezwa)1m → 5m → 30m → 2h → 12hHiyo inatoa kila tukio jaribio moja la kwanza pamoja na retries tano zilizopangwa. Historia ya utoaji inaweka hali ya HTTP, snippet ya majibu, hesabu ya jaribio, wakati wa kurejesha tena na kitambulisho cha uwasilishaji thabiti ambacho mpokeaji wako anaweza kutumia kwa deduplication.

Kuondolewa kwa backoff: Mipango ya 5 (Mipangilio)→5 m→30 m2 wa→ 2h → 12h) Baada ya maombi ya awali, utoaji wa ishara umeshindwa.
Usafiri wa Reli ya Mwisho: Mwisho wa kujifungua kijani / amber / nyekundu kwa mtazamo, na msimbo wa hali na wakati.
Kwa mara ya kwanza, alijitokeza wazi: kuthibitisha saini, kukataa stale timestamps na deduplicate imara X-OpsIQ-Delivery Thamani ya mpokeaji.
14h 36 m2 waKwa njia ya majaribio ya mwisho
6Majaribio ya jumla
Resume ladder & Uwasilishaji wa logi 1 m 1 m 5 m m m 30 m m 2h 12h Maisha ya upendo your-crm.com/hook · order.created 200 · Kutolewa slack.com/services · invoice.paid200 · Kutolewa Malipo ya mwisho · Malipo ya mwishoJaribio la jaribio 2/6 Msaada wa @ Tiketi. Imetengenezwa200 · Kutolewa Kujiandikisha kwa ajili ya usajili. renewed502 • Kushindwa Majibu yatolewa
Backoff ya nyuma1 m→5 m→30 m2 wa→ 2h → 12h
Uhusiano waKuthibitisha kwa majaribio
Usalama wa kupokeaTimetamp check + delivery-ID dedupe
2 Njia ya automatisering

Kuruhusu matukio, na kuruhusu Fanya kazi kwa usalama.

Mwisho wa mwisho na hatua za mwisho ni nyuso tofauti, kwa hivyo sasa zinaonekana tofauti: ramani moja nje ya matukio kwenye anwani, hatua nyingine za AI kabla ya kurudi kwako huitwa.

Mwisho wa Maombi

Matukio ya nje ya nchi kwenye tarehe sahihi.

Kujenga kipekee URL na kutia saini siri, ramani ya mashamba JSON, kisha kuruhusu OpsIQ kuunganisha kila tukio lililokubaliwa kwa kuwasiliana.

https://opsiq.example/api/v1/inbound.php?t=wh_7c91...
contact_email_path $.customer.email event_type_path $.type idempotency_key_path $.id
Hatua za mwisho

Unaweza kuomba kazi bila ya kuvunja mkataba.

Vigezo vya kutangaza, uthibitishaji na ruhusa; zinahitaji uthibitisho wa hatari ya juu anaandika kabla ya utekelezaji.

billing.issue_credit
Prodigy yaUthibitisho wa kuthibitishaKutosha
ya ya API funguo za

Vifungu vyenye ruhusa, mipaka na ruhusa.

Funguo za nafasi ya kazi kwa zana na washirika bila kutoa kila nguvu kamili ya ushirikiano.

Akaunti ya Dashibodi Soma tu
Programu ya Washirika Kikomo
Vifaa vya ndani Wote
API hatua wito

Njia za kuhifadhi ni safi.

Kwa kazi ngumu za kazi, piga simu REST API moja kwa moja na mfano huo uliopanuliwa.

POST /api/v1.php
Uidhinishaji: Uwezo wa opq_workspace_key
{ "action": "crm.conversions.record" }
Kutengwa kwa kiasi kikubwa

Kila kitu ni muhimu na kila kitu ni muhimu Alihamia kwenye nafasi yake ya kazi.

Usalama una mfumo wake wa kuona hapa: utoaji URLs umelindwa dhidi ya SSRF, funguo zinawekwa kwenye nafasi moja ya kazi, na maombi ya kuvuka mipaka kabla ya data yoyote kusomwa.

0Ishara za Kimataifa
403Kiwango cha mismatch
Usalama wa nje

Uwasilishaji wa URLs Hawezi kuingia ndani.

OpsIQ vitalu binafsi, loopback, kiungo-ndani na wingu metadata malengo wakati wa kuokoa mara kwa mara wakati wa kutuma.

your-crm.comkuruhusu
127.0.0.1kifungo
10.0.0.5kifungo
169.254.169.254kifungo
Nafasi ya Kazi ya Kuhamisha

Mipaka ya ndani ni sehemu ya ufunguo.

Mwisho, risiti za inbound, magogo ya utoaji na API Wote wanabeba muhuri wa nafasi ya kazi ambayo iliunda.

Nafasi ya Kazi AUmbo la Oq_A1...
Mwisho wa Mwisho /hook-a
scope_key ws_a
Kazi ya BUmbo la Oq_b7...
Mwisho wa Mwisho /hook-b
scope_key ws_b
Sehemu ya kazi ya wito wa workspace B inarudi 403 kabla ya upatikanaji wa taarifa.
Ufuatiliaji wa utekelezaji

Kila ombi linaingia kwenye mlango huo.

Saini, upeo wa nafasi ya kazi, hali ya ruhusa, kikomo cha kiwango na hiari ya IP ruhusu ya ukaguzi kabla ya ombi kufikia data ya biashara.

Kila kitu kwenye sanduku

Sehemu ya Ushirikiano, kikamilifu wired.

Historia na historia ya Jaribio la awali pamoja na retries tano zilizopangwa, na hali, snippet ya majibu na wakati wa pili wa kurejesha katika historia ya utoaji.
Kuonekana API funguo za All, Read-only or Restricted modes, per-key rate limits and IP allowlists, locked to the workspace.
Uchunguzi kabla ya kuishi Tuma mtihani wa nje, fanya jaribio la ramani ya ndani, au utumie mtumaji kavu kukagua bahasha iliyosainiwa.
Uwiano wa usambazaji Thamani imara ya X-OpsIQ-Delivery inaruhusu wapokeaji kutambua na kuzuia majaribio ya mara kwa mara.
Visual wa Utawala Drag-drop "wakati X hutokea, kufanya Y": hali ya kiwango, kipaumbele au neno la msingi, hakuna msimbo unaohitajika.
Kuongoza kwa uongofu Tumia Unix iliyosainiwa ili kukataa maombi ya stale na uendelee ID ya utoaji kabla ya kufanya kuandika.
⚖️Ambapo ni ya kutosha

Sio chombo cha kuponda ambacho unatengeneza. Uunganisho wa asili.

Zapier na Make ni kubwa kwa ajili ya bomba programu pamoja, lakini wao kukaa nje ya jukwaa yako, hawawezi lango AI vitendo, na mita kila kukimbia. OpsIQ Matukio, saini na vitendo ni asili, kugawana data sawa na chat yako, CRM na tiketi.

Nini unahitajiRangi ya ngozi / kufanyaOpsIQ Mtandao wa Webhooks & Actions
Aina, kumbukumbu ya tukio catalogKwa kutumia App, ni kinyume cha52 canonical OpsIQ events
HMAC-SHA256 yawasilisha hati ya usajiliRangi ya kijani / DIY kwa ajili yaKila kitu kinafanywa kwa siri, kila kitu kinafanywa kwa siri.
filters za matukio ya mwishoMoja ya njia za mkato kwa ajili yaWildcard au subset sahihi, kwa URL
Historia ya Mapinduzi +Malipo ya chini / ya kulipwaJaribio la kwanza + 5 Retent iliyopangwa
Usimamizi wa DoubleMnajenga juu yaID ya utoaji wa Stable + saini timestamp
Kuingia kwenye mawasiliano sahihiKuingiza katika mzunguko, si CRMRamani kwa ajili ya mawasiliano ya wakati
Watangulizi wa kwanza kabla ya kukimbiaHakuna dhana yaSera ya kuthibitisha hatari
Uchunguzi wa utekelezajiHapanaParameters zilizobadilishwa + matokeo na muda uliotumiwa
Kuonekana API Viwango vya + KiwangoAkaunti ya jumlaWote / Kusoma tu / Imepunguzwa + CIDR
SSRF-harding utoajiInatofautianaKwa ujumla, metadata IPs Imefungwa, imefunguliwa tena
Kukimbia kwa mita / kazi ya capsKwa hiyo, ni wajibu wa kilaTag: Hakuna Matata
Kama vile data ya chat / CRM / tiketiKuunganishwa kati ya appsChanzo kimoja cha ukweli
Orodha kamili ya

Yote yaliyomo ndani Mtandao wa Webhooks & Actions.

Kila mtu, kila kikundi, ★ alama ya kusimama.

Maonyesho yaNini cha kufanya
Matukio ya usajili
Outbound Event Catalog (52) ★Aina matukio ya canonical katika biashara, bili, msaada, CRM, usalama na uchambuzi.
Maelezo ya mchezo Wildcard (*)Kujiandikisha mwisho wa kila kitu na moja *.
Filters za Matukio ya Mwisho ★Moja ya moja URL Kupata billing, msaada mwingine, hivyo hakuna kelele juu ya wapokeaji kwamba hawana haja yake.
Usalama na Usajili
HMAC-SHA256 Kujiandikisha ★Kila malipo ya saini kwa siri ya mwisho kupitia X-OpsIQ-Signature.
Ishara ya Raw-BodyIshara za juu, na sio za chini, na hazijumuishi maelezo ya ziada.
Mapitio ya mara kwa mara ★hash_equals() Kwa hiyo, viongozi wa vyama vya upinzani hawawezi kwenda kwa wakati.
Siri ya Kusisimua ★Weka nyaraka zako zote za siri wakati wowote, kisha uziweke upya.
X-OpsIQ- ishara ya kichwaHMAC Na kila kitu kinafanywa kwa ajili ya ushuhuda.
X-X – ya OpsIQ Kichwa cha kichwaKila wakati, kila mtu anaweza kukataa matukio ya stale.
Ulinzi wa SSRF ★ JIOKuzuia binafsi, kitanzi na wingu-metadata IPs Kama malengo ya utoaji, wakati wa kuokoa na wakati wa kutuma.
Udhibiti wa Replay ★Unix iliyosainiwa na kitambulisho cha utoaji thabiti huwapa wapokeaji pembejeo za kukataa maombi ya stale na majaribio ya kuzuia.
Uhakikisho na uhakiki
Uwasilishaji wa Identifier★X-OpsIQ-Delivery Inabakia imara katika retries ili mpokeaji anaweza kufanya anaandika idempotent.
★ Retry ya Backoff ya Exponential1m → 5m → 30m → 2h → 12h: 5 ya vifaa vya ujenzi baada ya jaribio la kwanza.
Historia ya utoaji ★Hali ya HTTP, snippet ya majibu, hesabu ya jaribio na wakati wa pili wa retry, rangi-coded kijani / amber / nyekundu.
Usafiri wa Reli ya MwishoMwisho wa safari ya mwisho, kwa mtazamo wa mwisho.
Uwasilishaji wa metadata
X-X – ya OpsIQ Kichwa cha kichwaHufanya aina ya tukio ili wapokeaji waweze njia bila kupinda mwili.
X-X – ya OpsIQ-Kuondoa headerKitambulisho cha utoaji kwa kufuatilia na kudhibiti kila jaribio.
Uchunguzi & Uthibitisho
Uchunguzi wa kabla ya kwenda kuishi ★Moto mzigo wa sampuli na kukagua halisi ya JSON, saini na majibu ya HTTP.
Ishara za Mtihani (Dry_run)Inarudi bahasha iliyosainiwa bila kuchapisha, kwa hivyo unaweza kuthibitisha ndani ya nchi kwanza.
Uwasilishaji wa mtihanikuthibitisha ramani dondoo email na inajenga shughuli sahihi.
Usimamizi wa Mwisho
Kazi / Inactive ToggleTumia sehemu ya mwisho bila kuifungua.
Kuondolewa kwa Pending CancellationKuhamisha vituo kusubiri retries wakati kuweka magogo.
Mtandao wa Inbound
Mwisho wa Maombi ★Moja ya pekee URL pamoja na siri kwa chanzo cha mfumo au relay ambayo inaweza HMAC-sign ghafi JSON mwili.
Uthibitisho wa Kuingia ★Kuthibitisha X-OpsIQ-Inbound-Signature kabla ya kitu chochote kingine.
JSON Njia ya Kusonga ★Kuhamisha barua pepe, aina ya tukio na thamani kupitia $.path kutoka katika vyanzo vyote vya mapato.
Jina la mtumiaji Extraction JIOIngiza jina la mawasiliano yako contact_name_path Kwa hiyo, wakati wa kusoma ni wazi.
Thamani ya eneo la uchimbaji JIORamani ya thamani ya fedha au namba value_path kwa ajili ya kutoa taarifa na kutoa taarifa.
Maelezo ya jumla ★ JIOKukamilisha muhtasari wa kibinadamu kutoka kwa summary_path au a au a ${path} Template ya template.
Preset Mappings ya ndani★Bonyeza moja-click Stripe, Calendly na Zapier ramani pre kujazwa.
Kiwango cha chini cha malipo ★Wakati ambapo wakati idempotency_key_path Inatatua kitambulisho cha tukio, risiti za duplicate zinarudi mafanikio bila kuunda shughuli nyingine.
Shughuli za Inbound kwenye Mawasiliano Timeline ★Matukio yaliyokubaliwa kuwa shughuli za kusisimua, zinazoweza kusababisha kwenye mawasiliano.
Ingia kwa kuingiaok / makosa / duplicate / unmapped na mzigo wa malipo ghafi kwa ajili ya kufuta.
API Udhibiti wa Upatikanaji
API Mahitaji ya: 3 Njia ya Ruhusa ★Wote kwa zana za kuaminika, Soma tu kwa dashibodi, au Imezuiliwa kuzuia vitendo maalum.
API Kiwango cha chini cha kupunguza ★Piga simu kwa saa kwa ufunguo na bar ya matumizi ya kuishi.
API muhimu IP Orodha ya kuruhusu (CIDR) ★Pin ufunguo wa ofisi au data-centre IPs na safu za CIDR.
Orodha ya vitendo (meta. actions) ★Kugundua orodha kamili ya hatua muhimu inaweza kupiga simu; hakuna ufunguo unaohitajika kuorodhesha.
Nafasi ya KaziAPIMambo ya msingi★ JIOKila ufunguo umefungwa kwa nafasi yake ya kujenga, hivyo kutengwa kwa mara nyingi ni moja kwa moja.
API Uunganisho wa moja kwa moja (Instant) ★Kurejesha funguo zilizovuja na wito wake kushindwa mara moja.
Sheria za Automation
Kazi ya kazi na hatua ya WebhookUjumbe wa A URL Kama hatua moja ndani ya automatisering mbalimbali hatua.
Visual utawala wa wajenzi ★Drag-drop hali na vitendo: wakati X hutokea, kufanya Y, hakuna msimbo.
Hatua za mwisho
Mikataba ya kazi ★Kila operesheni inatangaza vigezo, aina ya utoaji, uthibitishaji na utunzaji wa majibu.
Utekelezaji wa amri ★Hatua zinaweza kuhitaji ruhusa ya operator; API wito pia unatekeleza mawanda yao yaliyosajiliwa.
Uthibitisho wa Hatari ★Vitendo vya hatari na uharibifu wa barabara zinahitaji uthibitisho; AI haiwezi kuendesha kazi ya uharibifu.
Utekelezaji wa hatua ★Wakati ukaguzi unawezeshwa, OpsIQ kumbukumbu za vigezo vilivyobadilishwa, hali, matokeo, muda na ushahidi wa kupelekwa.
Uthibitisho wa HTTP ★Vitendo vya mbali vinaweza kutumia uthibitisho wa Bearer, API-key, msingi au HMAC; kuelekeza tena na malengo yasiyo salama yamezuiwa.
Multi-tenancy ya
Mwisho wa Scope Isolation ★ JIOscope_kind/scope_key Alifunga kila mwisho, ufunguo na safu ya logi kwenye nafasi yake ya kazi.
Maswali Yanayoulizwa Mara kwa Mara

Maswali ya wavuti, Alijibu.

Kila mtu anajiuliza kabla ya kutumia waya OpsIQ Na kwa upande mwingine, wao ni wa kirafiki, wa kirafiki, wa kirafiki, na wa kirafiki.

Kulinganisha HMAC-SHA256 juu ya mwili wa ombi ghafi kwa kutumia siri yako iliyoshirikiwa; X-OpsIQ-Signature Je, si kuwa na muda wa kutosha wa kuangalia kama ni kweli? hash_equals()Msimbo wa sampuli ni kwenye ukurasa wa watengenezaji na katika sehemu ya kutia saini hapo juu.
Baada ya maombi ya awali,OpsIQIdadi ya tiketi za ndege hadi tano: 1m→5 m→30 m2 wa→ 2h → 12hIkiwa jaribio la sita litashindwa, uwasilishaji umefeli. Historia inashikilia hali yake, majibu na hesabu ya jaribio la utambuzi.
Kila mwisho una siri yake mwenyewe unaweza kuzaliwa upya wakati wowote: kuizunguka, kisha uonyeshe uthibitisho wako kwa siri mpya.
Ndiyo. mjenzi wa utawala wa kuona ("wakati X hutokea, fanya Y") inashughulikia kazi nyingi, na hali ya kiwango cha wateja, kipaumbele au neno la msingi. Njia za msimbo tu kupitia REST API zinapatikana kwa ajili ya kesi ngumu.
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 Na kwa kuwa analytics.anomalyKila ngazi ya mwisho inaweza kujiandikisha * au kwa kiwango cha chini kabisa.
Ndiyo, kuunda sehemu ya mwisho ili kupata pekee URL na saini siri, kuchagua Stripe, Calendly au generic shamba-mapping preset, kisha kuwa na mfumo wa kutuma au relay HMAC-sign yake ghafi JSON. OpsIQ Inathibitisha saini, huondoa barua pepe ya kuwasiliana na inaongeza shughuli iliyokubaliwa kwa mawasiliano hayo.
Hatua ya kijijini ni mkataba wa uendeshaji wazi kwa backend yako. Inatangaza vigezo, uthibitishaji, ruhusa, sera ya uthibitisho na utunzaji wa majibu. Vitendo vya Gateway hatari zinahitaji uthibitisho, AI haiwezi kuendesha vitendo vya uharibifu, na ukataji miti ya utekelezaji inaweza kuhifadhi ushahidi uliobadilishwa.
Maswali muhimu kwa ajili ya mtihani API Chagua njia ya kuhifadhi kwa ajili ya kuhifadhi: Wote, Soma tu, or Kikomo (Kuzuia vitendo maalum, ikiwa ni pamoja na mabango ya wilds kama vile crm.contacts.*Ongeza kikomo cha kiwango cha saa kwa saa na kiruhusu cha hiari cha IP. kila ufunguo umefungwa kwenye nafasi ya kazi ambayo iliundwa.
Webhooks zilizo nje hutumia utoaji wa mara moja. Thibitisha saini ya mbichi-mwili, kukataa zamani X-OpsIQ-TimestampKisha Endelea X-OpsIQ-Delivery Ikiwa kitambulisho hicho kimefanywa tayari, rudisha majibu ya 2xx bila kurudia operesheni.