WhatsApp Embedded Signup, hosted for you: the connect link
A connect link is a hosted page that lets one of your customers connect their own WhatsApp Business number to your product, through Meta's Embedded Signup. You create it with one API call and send it; Nodium runs the signup, registers the number and tells you when it is ready.
How it works
- You add your customer as a client and ask for a link: two calls.
- Your customer opens the link: which app the number is on, a short Your business form, then Meta's signup window, already filled from that form.
- They land back on your
redirectUrlwithstatus=connected&channel_id=…, and you receive thechannel.connectedwebhook.
# 1. Add your customer as a clientcurl https://nodium.io/api/v1/tenants \ -H "Authorization: Bearer $NODIUM_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Optique Martin", "externalId": "cust_1042" }'# 2. A hosted connect link, to send to that customercurl https://nodium.io/api/v1/tenants/cust_1042/connect-links \ -H "Authorization: Bearer $NODIUM_KEY" \ -H "Content-Type: application/json" \ -d '{ "redirectUrl": "https://app.example.com/settings/whatsapp" }'# → data.url: send it. Your customer comes back to# https://app.example.com/settings/whatsapp?status=connected&channel_id=…What the link handles for you
- Meta's Embedded Signup, without your own Meta app, app review or Tech Provider status: Nodium holds them.
- Coexistence: a customer who keeps the WhatsApp Business app on their phone is asked first, and connected the right way.
- Prefilled fields (
prefill): business name, website, country, category. Your customer only checks what you already know. - One number only when you name it (
phoneNumber): any other number is refused and the link can be used again. - A link that works once and expires after 7 days by default, 30 at most. A pending link can be extended or revoked.
What it costs
A client costs nothing; a plan is priced on the numbers connected. Meta bills its message fees to your customer's own WhatsApp Business account. See pricing.
Frequently asked questions
Do I need to become a Meta Tech Provider to onboard my customers?
No. Nodium is the Tech Provider: your customers connect through Nodium's Meta app, and you drive everything with your API key.
Does my customer need a Nodium account?
No. They open the link, fill the form and go through Meta's window. They never create a Nodium account.
What happens if my customer gives up halfway?
They come back to your redirectUrl with status=cancelled, or status=failed&code=… when Meta refused. A new link replaces one that can no longer be used.