From d7d87f793c58664dd12c354c527b17d2d2655780 Mon Sep 17 00:00:00 2001 From: August Date: Thu, 3 Sep 2026 02:40:00 +0000 Subject: [PATCH 1/4] docs(whatsapp): remove early-access alpha language --- .../pages/messaging/whatsapp/onboarding.mdx | 29 ++++++++----------- .../pages/messaging/whatsapp/overview.mdx | 29 +++++-------------- .../messaging/whatsapp/receive-messages.mdx | 5 ---- .../messaging/whatsapp/send-messages.mdx | 5 ++-- 4 files changed, 21 insertions(+), 47 deletions(-) diff --git a/fern/products/platform/pages/messaging/whatsapp/onboarding.mdx b/fern/products/platform/pages/messaging/whatsapp/onboarding.mdx index 0efeb89daf..e1ae24c19b 100644 --- a/fern/products/platform/pages/messaging/whatsapp/onboarding.mdx +++ b/fern/products/platform/pages/messaging/whatsapp/onboarding.mdx @@ -2,7 +2,7 @@ title: Connect a WhatsApp business number slug: /messaging/whatsapp/onboarding sidebar-title: Onboarding -description: Connect a Meta-verified WhatsApp business number to your SignalWire Space during the early-access alpha. +description: Connect a Meta-verified WhatsApp business number to your SignalWire Space from the Dashboard. max-toc-depth: 3 --- @@ -10,16 +10,9 @@ Your SignalWire account connects to WhatsApp through your existing Facebook/Meta Once connected, your WhatsApp business numbers appear in your Space and can be used as the `from` address in the [Messaging API](/docs/platform/messaging/whatsapp/send-messages). - -WhatsApp on SignalWire is in **early-access alpha** and is enabled per Space. The steps below are -coordinated with your SignalWire representative. Number provisioning is not yet self-serve. See the -[overview](/docs/platform/messaging/whatsapp) for what's included in the alpha. - - ## Prerequisites - A **Meta Business Account** (Facebook/Meta Business). -- A **SignalWire Space** with WhatsApp alpha access enabled. - SignalWire **project credentials**: your Project ID and an API key with the `numbers` scope. You'll find these in your [SignalWire Dashboard](https://my.signalwire.com). @@ -27,11 +20,10 @@ coordinated with your SignalWire representative. Number provisioning is not yet -### Request alpha access +### Add a WhatsApp connection -WhatsApp access is gated at the Space level. [Request early access through this -form](https://signalwire.typeform.com/to/EyPVZ1St) to have the feature enabled for your Space and -begin onboarding. +In your [SignalWire Dashboard](https://my.signalwire.com), open **Integrations** and select the +**WhatsApp** tile to start Meta's embedded signup. ### Complete Meta embedded signup @@ -41,15 +33,18 @@ business phone number(s) to register. ### Confirm your numbers -After signup completes, your registered WhatsApp numbers appear in your Space, associated with your -WhatsApp Business Account. Confirm they're present before sending messages. +Your WhatsApp Business Account appears under **Connected Integrations** on the Integrations page. +Open it and check the **WhatsApp Numbers** tab: each number shows a status of +**Registered**, **Pending**, or **Unregistered**. A number must be **Registered** before you can +send from it. -During the alpha, adding or removing WhatsApp numbers is handled on request by the SignalWire team, -or directly via the Meta Business dashboard. It cannot be done programmatically through the API or the -customer-facing SignalWire Dashboard at this time. +You choose which numbers to register during embedded signup. To add or remove numbers afterward, make +the change in the Meta Business dashboard, then open the connection in your SignalWire Dashboard and +select **Sync with Meta** to pull the current numbers and templates into your Space. Adding and +removing WhatsApp numbers is not available through the SignalWire API. ## Verify the connection diff --git a/fern/products/platform/pages/messaging/whatsapp/overview.mdx b/fern/products/platform/pages/messaging/whatsapp/overview.mdx index d746268a50..ca48132f47 100644 --- a/fern/products/platform/pages/messaging/whatsapp/overview.mdx +++ b/fern/products/platform/pages/messaging/whatsapp/overview.mdx @@ -3,8 +3,8 @@ title: WhatsApp messaging slug: /messaging/whatsapp sidebar-title: Overview position: 0 -subtitle: Send and receive WhatsApp messages through the SignalWire platform, currently in early-access alpha. -description: Send and receive WhatsApp messages from a Meta-verified business number through SignalWire, in early-access alpha. +subtitle: Send and receive WhatsApp messages through the SignalWire platform. +description: Send and receive WhatsApp messages from a Meta-verified business number through SignalWire. max-toc-depth: 3 --- @@ -14,20 +14,9 @@ SMS, MMS, and voice. Inbound and outbound messages are handled through the same [Messaging API](/docs/platform/messaging), so WhatsApp becomes one more channel alongside the ones you already run, with no third-party middleware required. - -WhatsApp on SignalWire is in **early-access alpha**, enabled per Space. Request access below to join the alpha. - - - - - WhatsApp access is gated at the Space level. Request access and the SignalWire team will enable the - feature for your Space. - - - ## What's available today -During the alpha, the following is supported: +WhatsApp is enabled on every SignalWire Space. The integration supports: - **Inbound and outbound messaging** through the SignalWire Messaging API. - **Messaging from a Meta-verified business number** that you connect through Meta's embedded @@ -36,11 +25,7 @@ During the alpha, the following is supported: ## Coming soon -The following capabilities are planned and are **not yet available**: - -- Inbound and outbound WhatsApp **voice calls**, including routing to [AI Agents](/docs/platform/ai). -- **Messaging fallback** to SMS/MMS when WhatsApp delivery fails. -- **Message template management** from the SignalWire Dashboard. +Messaging fallback to SMS/MMS when WhatsApp delivery fails is planned, but not yet available. ## How it works @@ -51,11 +36,11 @@ messages are handled programmatically like any other channel, with the ## Prerequisites -To use WhatsApp messaging during the alpha, you need: +To use WhatsApp messaging, you need: 1. A **Meta Business Account**. -2. A **SignalWire Space** enabled for WhatsApp alpha access. -3. To **authorize the connection** between Meta and SignalWire through the embedded signup flow. +2. To **authorize the connection** between Meta and SignalWire through the embedded signup flow, + which you start from the **Integrations** tab of your Dashboard. Once connected, your registered business number can be used for inbound and outbound messaging and programmatic routing. diff --git a/fern/products/platform/pages/messaging/whatsapp/receive-messages.mdx b/fern/products/platform/pages/messaging/whatsapp/receive-messages.mdx index 4584e75dbb..0ab28cf766 100644 --- a/fern/products/platform/pages/messaging/whatsapp/receive-messages.mdx +++ b/fern/products/platform/pages/messaging/whatsapp/receive-messages.mdx @@ -10,11 +10,6 @@ Inbound messages sent to your WhatsApp business number are automatically receive SignalWire. You can view them in your Dashboard or retrieve them through the Messaging API, alongside the delivery status of the messages you send. - -WhatsApp on SignalWire is in **early-access alpha**. Inbound messages from customers are -automatically received and logged by SignalWire. - - ## Message logs Inbound messages and the delivery status of the messages you send are available through the message diff --git a/fern/products/platform/pages/messaging/whatsapp/send-messages.mdx b/fern/products/platform/pages/messaging/whatsapp/send-messages.mdx index d8e0194791..d0414693ca 100644 --- a/fern/products/platform/pages/messaging/whatsapp/send-messages.mdx +++ b/fern/products/platform/pages/messaging/whatsapp/send-messages.mdx @@ -14,9 +14,8 @@ message over WhatsApp instead of SMS/MMS: - You set a `message_type` (for content messages) or a `template_id` (for template messages). -WhatsApp on SignalWire is in **early-access alpha**. You must -[connect a WhatsApp business number](/docs/platform/messaging/whatsapp/onboarding) before you can send -messages. +[Connect a WhatsApp business number](/docs/platform/messaging/whatsapp/onboarding) before you send +your first message. For the full request schema (every field, every message type's `body` shape, and authentication), From 8bd8b394b496f4c80bbb9d22fe69b9bd35448f18 Mon Sep 17 00:00:00 2001 From: August Date: Thu, 3 Sep 2026 02:40:08 +0000 Subject: [PATCH 2/4] docs(whatsapp): correct template management and roadmap claims --- .../platform/pages/messaging/whatsapp/message-templates.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/fern/products/platform/pages/messaging/whatsapp/message-templates.mdx b/fern/products/platform/pages/messaging/whatsapp/message-templates.mdx index eec14267c1..ad9accba0c 100644 --- a/fern/products/platform/pages/messaging/whatsapp/message-templates.mdx +++ b/fern/products/platform/pages/messaging/whatsapp/message-templates.mdx @@ -13,9 +13,9 @@ Once approved, you can send them to any customer at any time. See deliver one. -WhatsApp on SignalWire is in **early-access alpha**. Template management through the SignalWire -Dashboard is planned; today, templates are managed via the API or directly in the Meta Business -dashboard. +Your SignalWire Dashboard lists the templates on a WhatsApp Business Account under +**Integrations → WhatsApp Templates**. Creating and editing templates is done through the API or +directly in the Meta Business dashboard. ## Template components From 00fc02a0649ec0173e429f3de066d06c5374ee06 Mon Sep 17 00:00:00 2001 From: August Date: Tue, 8 Sep 2026 17:40:17 +0000 Subject: [PATCH 3/4] fix(docs): remove more alpha framing --- .../pages/messaging/whatsapp/overview.mdx | 16 ---------------- 1 file changed, 16 deletions(-) diff --git a/fern/products/platform/pages/messaging/whatsapp/overview.mdx b/fern/products/platform/pages/messaging/whatsapp/overview.mdx index ca48132f47..c99ebff297 100644 --- a/fern/products/platform/pages/messaging/whatsapp/overview.mdx +++ b/fern/products/platform/pages/messaging/whatsapp/overview.mdx @@ -14,19 +14,6 @@ SMS, MMS, and voice. Inbound and outbound messages are handled through the same [Messaging API](/docs/platform/messaging), so WhatsApp becomes one more channel alongside the ones you already run, with no third-party middleware required. -## What's available today - -WhatsApp is enabled on every SignalWire Space. The integration supports: - -- **Inbound and outbound messaging** through the SignalWire Messaging API. -- **Messaging from a Meta-verified business number** that you connect through Meta's embedded - signup flow. -- **Programmatic routing** of inbound messages to your application, just like SMS and MMS. - -## Coming soon - -Messaging fallback to SMS/MMS when WhatsApp delivery fails is planned, but not yet available. - ## How it works Customers reach your business through WhatsApp Ads or a Facebook call-to-action button, which @@ -42,9 +29,6 @@ To use WhatsApp messaging, you need: 2. To **authorize the connection** between Meta and SignalWire through the embedded signup flow, which you start from the **Integrations** tab of your Dashboard. -Once connected, your registered business number can be used for inbound and outbound messaging -and programmatic routing. - ## Next steps From f0b6b9d100300f47418dc48afd8e06c6163c19b0 Mon Sep 17 00:00:00 2001 From: August Date: Tue, 8 Sep 2026 20:38:03 +0000 Subject: [PATCH 4/4] docs(whatsapp): address review feedback on onboarding and templates --- .../messaging/whatsapp/message-templates.mdx | 7 +++--- .../pages/messaging/whatsapp/onboarding.mdx | 22 ++++++++++--------- .../pages/messaging/whatsapp/overview.mdx | 6 +---- .../messaging/whatsapp/send-messages.mdx | 5 ----- 4 files changed, 17 insertions(+), 23 deletions(-) diff --git a/fern/products/platform/pages/messaging/whatsapp/message-templates.mdx b/fern/products/platform/pages/messaging/whatsapp/message-templates.mdx index ad9accba0c..f2ed5c788e 100644 --- a/fern/products/platform/pages/messaging/whatsapp/message-templates.mdx +++ b/fern/products/platform/pages/messaging/whatsapp/message-templates.mdx @@ -13,9 +13,10 @@ Once approved, you can send them to any customer at any time. See deliver one. -Your SignalWire Dashboard lists the templates on a WhatsApp Business Account under -**Integrations → WhatsApp Templates**. Creating and editing templates is done through the API or -directly in the Meta Business dashboard. +Your SignalWire Dashboard lists a connection's templates on its **WhatsApp Templates** tab, under +**Integrations**. Creating and editing templates is done through the API or directly in the Meta +Business dashboard. A template you create in Meta appears in your Space only after you open the +connection and select **Sync with Meta**. ## Template components diff --git a/fern/products/platform/pages/messaging/whatsapp/onboarding.mdx b/fern/products/platform/pages/messaging/whatsapp/onboarding.mdx index e1ae24c19b..9d5fe6f089 100644 --- a/fern/products/platform/pages/messaging/whatsapp/onboarding.mdx +++ b/fern/products/platform/pages/messaging/whatsapp/onboarding.mdx @@ -12,9 +12,7 @@ Once connected, your WhatsApp business numbers appear in your Space and can be u ## Prerequisites -- A **Meta Business Account** (Facebook/Meta Business). -- SignalWire **project credentials**: your Project ID and an API key with the `numbers` scope. You'll - find these in your [SignalWire Dashboard](https://my.signalwire.com). +You need a **Meta Business Account** (Facebook/Meta Business). ## Connect your account @@ -34,21 +32,25 @@ business phone number(s) to register. ### Confirm your numbers Your WhatsApp Business Account appears under **Connected Integrations** on the Integrations page. -Open it and check the **WhatsApp Numbers** tab: each number shows a status of -**Registered**, **Pending**, or **Unregistered**. A number must be **Registered** before you can -send from it. +Open it and check the **WhatsApp Numbers** tab. A number must show **Registered** before you can send +from it. **Pending** means it hasn't finished registering with Meta: complete its setup in the Meta +Business dashboard, then select **Sync with Meta** to refresh the status. -You choose which numbers to register during embedded signup. To add or remove numbers afterward, make -the change in the Meta Business dashboard, then open the connection in your SignalWire Dashboard and -select **Sync with Meta** to pull the current numbers and templates into your Space. Adding and -removing WhatsApp numbers is not available through the SignalWire API. +To add or remove numbers, make the change in the Meta Business dashboard, then open the connection in +your SignalWire Dashboard and select **Sync with Meta** to pull the current numbers and templates into +your Space. A number you remove in Meta is removed from your Space on the next sync, along with any +routing configured for it. Adding and removing WhatsApp numbers is not available through the +SignalWire API. ## Verify the connection +These calls need your SignalWire **project credentials**: your Project ID and an API key with the +`numbers` scope, both found in your [SignalWire Dashboard](https://my.signalwire.com). + List the WhatsApp Business Accounts connected to your Space: diff --git a/fern/products/platform/pages/messaging/whatsapp/overview.mdx b/fern/products/platform/pages/messaging/whatsapp/overview.mdx index c99ebff297..7b380b813c 100644 --- a/fern/products/platform/pages/messaging/whatsapp/overview.mdx +++ b/fern/products/platform/pages/messaging/whatsapp/overview.mdx @@ -23,11 +23,7 @@ messages are handled programmatically like any other channel, with the ## Prerequisites -To use WhatsApp messaging, you need: - -1. A **Meta Business Account**. -2. To **authorize the connection** between Meta and SignalWire through the embedded signup flow, - which you start from the **Integrations** tab of your Dashboard. +To use WhatsApp messaging, you need a **Meta Business Account**. ## Next steps diff --git a/fern/products/platform/pages/messaging/whatsapp/send-messages.mdx b/fern/products/platform/pages/messaging/whatsapp/send-messages.mdx index d0414693ca..319ced1cf2 100644 --- a/fern/products/platform/pages/messaging/whatsapp/send-messages.mdx +++ b/fern/products/platform/pages/messaging/whatsapp/send-messages.mdx @@ -13,11 +13,6 @@ message over WhatsApp instead of SMS/MMS: - The `from` number is a `whatsapp:`-prefixed [WhatsApp number](/docs/platform/messaging/whatsapp/onboarding) (e.g. `whatsapp:+15557654321`). - You set a `message_type` (for content messages) or a `template_id` (for template messages). - -[Connect a WhatsApp business number](/docs/platform/messaging/whatsapp/onboarding) before you send -your first message. - - For the full request schema (every field, every message type's `body` shape, and authentication), see the [Send a message](/docs/apis/rest/messages/create-message) API reference.