Skip to content

What is a webhook

2 min read

A webhook is the opposite direction of the API: instead of your server calling Kirisan to send, Kirisan calls your server when something happens — most often an incoming message on a linked device or email address.

You register an HTTPS URL in the dashboard. When an event fires, Kirisan POSTs a JSON body plus headers (event name, optional signature). Your app should respond with 2xx quickly, then process the payload asynchronously if work is heavy.

Typical jobs: sync chats into a CRM, run a custom bot, download inbound files from message.file.url, or trigger Zapier / Make / n8n (those tools give you the public URL).

Webhook endpoints

Dashboard vs your server

Dashboard inbox / autoreplyYour webhook
SetupNo codePublic HTTPS endpoint
LogicKeyword rules, Flow, UI replyAnything your code can do
Delivery proofWebhook logs in KirisanYour own application logs

You can use both: Kirisan can still store inbox rows and run autoreply while also notifying your URL.

Next

  1. Public URL
  2. Payload & reply
  3. Webhook playground

Reference: Webhook overview · Dashboard webhooks · Webhooks