BYON Overview

BYON (Bring Your Own Number) lets you connect your own WhatsApp Business number to Pipes.bot. Instead of using shared pool numbers, your customers and contacts message your number directly, and all conversations route to your application.

BYON is available on Pro and Pro+ plans as an add-on at $5/number/month.

Pool vs BYON

How it works

BYON is built around the App model. Each App is an application endpoint that owns one or more BYON numbers. All messages on those numbers route to the App owner.

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Customer A  │────►│              │     │              │
└──────────────┘     │  Your BYON   │────►│   Your App   │
┌──────────────┐     │   Number     │     │  (webhook +  │
│  Customer B  │────►│              │     │   WebSocket) │
└──────────────┘     └──────────────┘     └──────────────┘

1. Create an App — Choose a slug, get an ak_ API key
2. Onboard a number — Use Meta's Embedded Signup to connect your WhatsApp Business number
3. Configure delivery — Set a webhook URL for your App (WebSocket also available)
4. Receive messages — All messages from any sender on your BYON number are delivered to your App
5. Reply — Use the REST API with your ak_ key to send responses

Next steps

• BYON Quickstart — Run the demo app end-to-end
• Creating an App — Set up your first BYON App
• Embedded Signup — Onboard WhatsApp Business numbers
• Webhook Delivery — Configure message delivery
• Number Management — Monitor and manage BYON numbers