Developers

Inbound webhook

File external events into the Inbox.

About 4 minutes

For systems without a native connection, the inbound webhook turns an external event into a Hub conversation your agents can triage.

Good uses

A form submission, a support request from a bespoke tool, an alert that a human should see. In short: anything that would otherwise become an email to yourself.

Steps

  1. Create a webhook channel in the Inbox and copy its endpoint.
  2. Configure the external system to POST to it.
  3. Send a test event.
  4. Add a routing rule so events land with the right owner.

You're done when a test event appears as a conversation and routes correctly.

Gotchas

  • Treat the URL as a secret. Anyone with it can create conversations.
  • Do not fire high-frequency machine noise at it. This is for things a person should see; monitoring alerts belong in a monitoring tool.

Checked against

  • endpoints/hub/webhook/inbound_POST.ts