Sale alerts and webhooks

Sorai can tell you about each paid order as it happens, and send order events to tools you run yourself. Both live in Store settings, then Integrations:

• Notifications: where sale alerts go.
• Webhooks: order events sent to your own server.

Notification channels and webhook endpoints belong to your organization and are shared by every store. Each store picks which channels hear about its sales.

Sale alertsCopy Anchor Link

Until you add a channel, sale alerts go by email to your organization's owners and admins.

Add an email channelCopy Anchor Link

1. Open the Notifications tab and choose Add channel.
2. Under Channel, pick Email and enter the Notify address.
3. Choose Add channel.

Sorai emails that address a link to confirm it. Nothing is sent there until the link is opened, and the channel shows Waiting for confirmation until then. If the link expired, use the resend button on the row to send a new one.

Add a Telegram channelCopy Anchor Link

1. Choose Add channel, pick Telegram, then Add channel.
2. Sorai shows a one-time pairing link. Open it in Telegram and press Start.

The channel turns active once paired. The link can't be shown again: if you lose it, remove the channel and add it back.

A channel's destination can't be edited. To change it, remove the channel and add a new one. Use the switch on a row to turn a channel off or back on.

Choose which channels hear about this storeCopy Anchor Link

Under Where this store's sales go, tick the channels for this store, or Every channel, including ones added later. Then choose Save.

If nothing is ticked, no one is told about sales in this store. Orders still appear in Orders.

WebhooksCopy Anchor Link

A webhook sends order events to an address you own, signed with a secret only you hold. Use it to connect Sorai to your own systems. Webhooks depend on your plan.

1. Open the Webhooks tab and choose Add endpoint.
2. Enter the URL that should receive events.
3. Under Events, pick at least one, such as Order paid or Order refunded.
4. Choose Add endpoint.
5. Copy the Signing secret now. It is shown only once.

From an endpoint's menu you can Send a test, View deliveries to see each attempt and what your server answered, or Remove endpoint. A failed delivery can be replayed from the deliveries list.

For the payload, signatures and retries, see the developer guide to webhooks.