Skip to main content
Embedded Signup allows you to quickly connect WhatsApp Business Accounts to Chirp through a streamlined OAuth-based flow powered by Meta.

​
Overview

The Embedded Signup flow enables you to:
  • Connect existing WhatsApp Business Accounts
  • Create new WhatsApp Business Accounts
  • Register phone numbers for WhatsApp messaging
  • Grant Chirp permission to send and receive messages on your behalf
  • Support coexistence mode (use WhatsApp Business App alongside Cloud API)
Embedded Signup requires Meta credentials that are configured by Chirp. Contact Chirp support to enable Embedded Signup for your organization.

​
Coexistence Mode

Coexistence mode allows businesses to use the WhatsApp Business App alongside the Cloud API. When a user completes signup through the WhatsApp Business App onboarding flow, their account is marked for coexistence, enabling:
  • Continued use of the WhatsApp Business App for direct conversations
  • Cloud API access for automated messaging through Chirp
  • Shared phone number between both platforms
Coexistence is automatically detected during signup. No additional configuration is required.

​
How It Works

  1. Initiate Connection - Click “Connect Account” in the Chirp dashboard
  2. Authenticate with Meta - Log in to your Meta/Facebook account
  3. Select Business - Choose or create a WhatsApp Business Account
  4. Grant Permissions - Authorize Chirp to access your WhatsApp Business Account
  5. Complete Setup - Chirp automatically syncs your phone numbers and templates

​
Prerequisites

Before connecting a WhatsApp Business Account:
  1. Meta Business Account - You need a verified Meta Business Account
  2. WhatsApp Business Account - Either existing or created during signup
  3. Phone Number - A phone number to register with WhatsApp (cannot already be registered with WhatsApp)
  4. Chirp Credentials - Contact Chirp support to enable Embedded Signup

​
Connecting an Account

​
Step 1: Navigate to WhatsApp Accounts

In the Chirp dashboard, go to WhatsApp > Accounts or Settings > WhatsApp Accounts and click Connect Account.

​
Step 2: Authenticate with Meta

You’ll be redirected to Meta’s login page. Sign in with the Facebook account that has access to your Meta Business Account.

​
Step 3: Select Your Business

Choose the Meta Business Account you want to use. If you don’t have one, you can create a new WhatsApp Business Account during this flow.

​
Step 4: Grant Permissions

Authorize Chirp to:
  • Manage your WhatsApp Business Account
  • Send and receive messages
  • Manage message templates
  • Access phone number information

​
Step 5: Complete Setup

After authorization, Chirp will:
  • Create a WhatsApp Business Profile in your organization
  • Sync your phone numbers
  • Sync your existing message templates
  • Set up webhook connections for real-time messaging

​
After Connecting

Once your account is connected, you can:

Send Messages

Start sending WhatsApp messages through the API

Manage Templates

Create and manage message templates

Configure Webhooks

Set up webhooks to receive incoming messages

Manage Numbers

View and configure your phone numbers

​
For Platform Developers

If you’re building a platform and want to allow your users to connect their WhatsApp Business Accounts directly within your application, Chirp provides two API-based flows:

Redirect Flow

Server-side redirect flow. Best for web applications where you control the backend.

Popup Flow

Client-side popup flow using Meta’s FB.login(). Best for seamless in-app experiences.

​
Token Management

The connection uses a long-lived token that Chirp manages automatically:
  • Token Duration - Tokens are valid for 60 days
  • Auto-Refresh - Chirp refreshes tokens before expiration when possible
  • Expiration Alerts - The dashboard shows token status and expiration warnings
If a token expires, you may need to reconnect the account. Monitor the “Token Status” in your WhatsApp Accounts list.

​
Troubleshooting

​
”Business verification required”

Meta requires business verification for some WhatsApp features. Complete verification in Meta Business Manager.

​
”Phone number already registered”

The phone number is already registered with WhatsApp (personal or another business account). Use a different number or migrate it through Meta’s phone number migration process.

​
”Permission denied”

Ensure you’re signing in with an account that has admin access to the Meta Business Account.

​
Token expired

If your token has expired:
  1. Go to WhatsApp > Accounts
  2. Find the account with the expired token
  3. Click Reconnect to re-authenticate

​
Getting Help

For assistance with Embedded Signup:
  • Enable Embedded Signup - Contact [email protected] to get Meta credentials configured
  • Connection Issues - Check Meta Business Manager for account status
  • API Questions - See the API Reference
For production deployments, ensure your Meta Business Account is verified to unlock higher messaging limits and additional features.