Outbound webhook
An advanced setting that sends every AI and team reply to your own URL, so your own messaging gateway can deliver it.
This is an advanced setting that most agencies don't need. For every reply from the AI agent or your team, Flyby sends a POST request with the reply to a URL you choose, and your gateway delivers the message to the customer.
Do you need it?
| Your setup | What to do |
|---|---|
| You connected WhatsApp, Messenger or Instagram in Flyby | Leave it off. Replies are delivered automatically |
| You only use the public chat | Leave it off |
| You run your own messaging gateway (like n8n, or a non-Meta WhatsApp provider) and want replies sent there | This is for you |
Sending only, not receiving
This webhook only sends replies out. Bringing customer messages from your gateway into Flyby isn't self-serve yet. Before you build on it, contact support@flyby.world.
Turn it on
Open Channels
Settings → Channels & integrations, and scroll to Advanced.
Enter the Outbound URL and click Save
It must start with https:// and be publicly reachable, like https://gateway.example.com/flyby. Once saved, the badge shows Connected.
The payload we send
With every reply, Flyby sends a POST with Content-Type: application/json:
{
"agency_id": "…",
"conversation_id": "6f1c…",
"channel": "whatsapp",
"contact_phone": "+201001234567",
"sender": "ai",
"text": "Hi Ahmed! …"
}| Field | Meaning |
|---|---|
agency_id | Your agency's ID in Flyby |
conversation_id | The conversation's ID; use it to group replies |
channel | The channel the conversation came from, like whatsapp or web |
contact_phone | The customer's phone if known (can be null) |
contact_instagram | Team replies only: the customer's Instagram handle if known |
sender | ai for AI agent replies, agent for replies from your team |
text | The reply text |
When is it sent?
- AI replies: in any conversation that is not on a Meta channel connected in Flyby, including public chat conversations.
- Team replies: in conversations that aren't from the public chat, when the reply couldn't be sent through a connected Meta channel.
So if WhatsApp is connected in Flyby, its replies go straight to Meta and never pass through the webhook.
Tips for your gateway
- Respond quickly: Flyby waits 8 seconds at most.
- Each reply is sent once, with no retries. If your gateway was down, that reply won't reach it.
- Requests aren't signed, so make the URL hard to guess (for example, end it with a long secret code).
Turn it off
Switch off Send replies to your gateway. The URL is cleared and sending stops right away; you'll see "Outbound webhook turned off".