Skip to main content
With a custom channel, your app (web, mobile, or backend) can run flows published in Brain Studio without relying on WhatsApp or Meta. Your system sends interactions to Jelou, the agent processes the flow asynchronously, and Jelou delivers replies to a webhookUrl you control. Some builder nodes and tools are not available on this channel. See channel limitations.

​
Integration process

1

Enable the channel in the builder

Turn on custom, set the webhook, its authentication, and the required HMAC signing key from the UI.Activation guide →
2

Sign requests

Sign each inbound request body (interaction and status check) and verify each outbound delivery.HMAC signature →
3

Send interactions

Send user messages or actions to POST /v1/custom-channel/:botId. Jelou replies immediately with an executionId and processes the flow in the background.Send interaction →
4

Receive replies

Jelou POSTs to your webhook with the bot message. Review formats per bubble type.Response format →
5

Check status

Use POST /v1/custom-channel/:botId/status with an HMAC signature to learn whether the session is running, waiting for input, or idle.Check status →
Outbound delivery gets up to 3 attempts in total, inside a 20s budget for fast failures (5xx, 429, connection refused/reset). Retries carry the same messageId, so your endpoint must deduplicate by it and respond idempotently. A timeout is never retried. Your endpoint must respond quickly and reliably.Delivery and retries →