Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,9 @@ Once approved, you can send them to any customer at any time. See
deliver one.

<Info>
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.
</Info>

## Template components
Expand Down
29 changes: 12 additions & 17 deletions fern/products/platform/pages/messaging/whatsapp/onboarding.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,36 +2,28 @@
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
---

Your SignalWire account connects to WhatsApp through your existing Facebook/Meta Business account.
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).

<Info>
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.
</Info>

## 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).

## Connect your account

<Steps>

### 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

Expand All @@ -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.

</Steps>

<Note>
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.
</Note>

## Verify the connection
Expand Down
29 changes: 7 additions & 22 deletions fern/products/platform/pages/messaging/whatsapp/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand All @@ -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.

<Info>
WhatsApp on SignalWire is in **early-access alpha**, enabled per Space. Request access below to join the alpha.
</Info>

<CardGroup>
<Card title="Request early access" href="https://signalwire.typeform.com/to/EyPVZ1St">
WhatsApp access is gated at the Space level. Request access and the SignalWire team will enable the
feature for your Space.
</Card>
</CardGroup>

## 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
Expand All @@ -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

Expand All @@ -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.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<Info>
WhatsApp on SignalWire is in **early-access alpha**. Inbound messages from customers are
automatically received and logged by SignalWire.
</Info>

## Message logs

Inbound messages and the delivery status of the messages you send are available through the message
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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).

<Info>
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.
</Info>

For the full request schema (every field, every message type's `body` shape, and authentication),
Expand Down
Loading