Webhooks overview
RosettaChat webhooks are bidirectional:
- Outbound — subscribe to signed events at your endpoint. Message text is opt-in; when requested, a completed translation is used when it is already available, otherwise the original text is delivered.
- Inbound — post a message into a channel from your own systems; it’s translated for every reader.
This is a platform-wide capability: any channel — not only the support widget — can fan out to subscribed webhooks, and any system can post in.
Event catalog
Section titled “Event catalog”| Event | Fires when |
|---|---|
message.created | A message is created in a channel the webhook subscribes to. |
conversation.created | A support conversation starts. |
conversation.closed | A support conversation is closed. |
Every outbound delivery is signed with a Stripe-style header:
X-Rosetta-Signature: t=<unix>,v1=<hmac_sha256("<t>.<body>", secret)>See Outbound webhooks for how to verify it.