Mga Developer

Mga Webhook

Ang bawat notification na ginagawa ng iyong account ay maaaring direktang ipadala sa sarili mong mga system bilang isang nilagdaang JSON POST — kaya ang nangyayari sa iyong hosting ay maaaring magsimula ng isang workflow saanman.

Lahat ng dokumentasyon ng developer →

Kung saan mo ito maaaring ikonekta

Ang webhook ay isang karaniwang HTTPS request, kaya ang anumang makakatanggap nito ay maaaring kumilos batay dito. Hindi mo kailangan na kami ang gumawa ng integration para sa iyong tool.

Mga platform ng automation

Ituro ang isang webhook sa isang workflow sa n8n, Make, Zapier, Pipedream, Activepieces at ang bawat kaganapan ay magiging isang trigger — mag-post sa isang channel, magbukas ng ticket, mag-update ng spreadsheet, tumawag ng isa pang API. Gumagana ang mga self-hosted na platform sa eksaktong parehong paraan, basta't naaabot ang endpoint sa pamamagitan ng HTTPS.

Mga CRM at helpdesk

Ipadala ang mga kaganapan sa pagsingil at account sa HubSpot, Pipedrive, Salesforce, o sa anumang helpdesk o CRM na may papasok na webhook, upang maipakita sa talaan ng customer ang nangyayari sa kanilang hosting nang hindi kailangang manu-manong kopyahin ninuman.

Anumang iba pang nakikinig

Slack, Discord, Google Sheets, Airtable, Notion, ang sarili mong pagsubaybay, isang data warehouse, o isang maliit na script na isinulat mo. Kung kaya nitong tumanggap ng HTTPS POST at magbasa ng JSON, maaari nitong matanggap ang mga ito.

Ang ipinapadala

Kayo ang pumipili kung aling mga kategorya ang mapupunta sa aling destinasyon — at maaari kayong magkonekta ng marami, upang ang pagsingil ay mapunta sa isang lugar at ang mga alerto sa site sa iba naman. Naka-on ang lahat bilang default.

Pagsingil at mga pagbabayad

Mga naibigay at nabayarang invoice, mga nabigong pagbabayad, mga card na malapit nang mag-expire, mga pag-renew, at mga pagkansela.

Mga site at seguridad

Tapos na ang pag-provision, nasuspinde ang isang site, may nakitang malware, mga backup at mga pagbabago sa sertipiko.

Suporta at mga domain

Mga binuksan at ini-escalate na ticket, paglilipat ng domain, mga pag-renew at pagbabago sa DNS.

Pagpapatunay na nagmula sa amin ang isang kahilingan

Ang bawat kahilingan ay nilagdaan ng isang lihim na kayo at kami lamang ang may hawak. Suriin ang lagda bago kayo kumilos sa body — dumarating ang mga header na ito sa bawat paghahatid:

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paid

Ang timestamp ay nilagdaan kasama ang mismong body sa halip na ipadala sa tabi nito, upang ang isang kahilingang naharang ay hindi na maaaring muling gamitin laban sa inyo sa ibang pagkakataon. Tanggihan ang anumang mas luma pa sa ilang minuto.

Ipinapakita ang iyong signing secret nang isang beses lang, kapag idinagdag mo ang webhook. Hindi na namin ito maipapakitang muli — kung mawala mo ito, alisin ang destinasyon at idagdag itong muli.

Nagsasaayos ng isa

Sa iyong dashboard, buksan ang Mga Notification at magdagdag ng patutunguhan na may uring Webhook.
Ibigay ang iyong HTTPS endpoint at kopyahin ang signing secret na ipinapakita namin sa iyo.
Pindutin ang Test. Nagpapadala kami ng totoong kahilingan na may kaparehong anyo ng isang live na kahilingan, upang makapagbuo kayo batay dito bago pa man may mangyaring totoo.
Pumili kung aling mga kategorya ang dapat matanggap ng destinasyong iyon. Awtomatikong ino-on ang mga bagong uri ng notification.

Maaari kayong magdagdag ng kahit gaano karaming destinasyon na gusto ninyo, pagsamahin ang mga webhook sa email, Slack at Telegram, at bigyan ang bawat isa ng ibang hanay ng mga kategorya.

Mas gusto mo bang tawagan kami sa halip?

Ipinapaalam sa inyo ng mga webhook kung kailan may nangyaring isang bagay. Ang API ang paraan kung paano kayo magpapakilos ng isang bagay — bawat operasyong isinasagawa ng dashboard ay magagamit ninyo.

I-browse ang sanggunian sa API