Embedded Signup

  1. Home
  2. Embedded Signup

WhatsApp Business Embedded Signup

This page allows other businesses to login and give your app permission to send WhatsApp messages on their behalf.

Embedded Signup Flow

Tech Provider Status Required

IMPORTANT: To use WhatsApp Business Embedded Signup, you must have Tech Provider status with Meta.

Instructions:
  1. Tech Provider Status: Ensure you have Tech Provider status with Meta before proceeding.
  2. The configuration below is loaded from your appsettings.json
  3. The Base URL is automatically detected if not configured in appsettings.json
  4. Critical Meta App Configuration: In your Meta/Facebook app settings, you must configure THREE essential settings:
    • App Domains: Add your domain WITHOUT protocol (e.g., yourdomain.com or localhost) in Settings > Basic > App Domains. This is CRITICAL - the domain must match exactly without https:// or www.
    • Valid OAuth Redirect URIs: Add your base domain (e.g., https://whatsapp.yourdomain.com or http://localhost:5000) in Facebook Login > Settings > Valid OAuth Redirect URIs. Do not include paths - Facebook will add its own paths during the OAuth flow. Note: Meta will automatically add a trailing slash to your domain.
    • JavaScript SDK Domains: Add the base URL (e.g., https://whatsapp.yourdomain.com) to Allowed Domains in Facebook Login for Business > Settings. Note: Meta will automatically add a trailing slash making it https://whatsapp.yourdomain.com/.
  5. OAuth Flow Options: This page now supports two OAuth flows:
    • Manual OAuth Flow (Recommended): Uses direct URL redirection following Facebook's manual flow documentation. This avoids redirect URI mismatch issues that are common with the JavaScript SDK.
    • SDK-based Flow (Fallback): Uses Facebook's JavaScript SDK. May encounter redirect URI validation issues on some configurations.
  6. OAuth Redirect URI Important Note: The redirect URI must match your domain exactly. For Facebook Embedded Signup, you need to add https://whatsapp.yourdomain.com (just the base domain, no path) to Valid OAuth Redirect URIs in your Meta app settings. Note: Meta will automatically add a trailing slash making it https://whatsapp.yourdomain.com/ - this is normal. Facebook will automatically append its own paths during the OAuth flow. Missing this configuration will cause OAuth error 191.
  7. App Domains Configuration: In Meta app Settings > Basic > App Domains, add yourdomain.com (your root domain without subdomain, protocol, or paths). This must match the base_domain shown in console logs.
  8. App Mode: Your Meta app should be in Live mode for token exchange to work properly. Development mode has restrictions that may cause token exchange failures.
  9. Click the "Login with Facebook (Manual OAuth)" button to start the embedded signup flow with the recommended manual flow
  10. Complete the WhatsApp Business signup process
  11. The system will automatically exchange the authorization code for an access token
Configuration
Auto-detected if empty in appsettings.json
This is the redirect URI that will be used for OAuth
Configured in appsettings.json
Configured in appsettings.json (hidden for security)
Configured in appsettings.json
Signup Flow
Manual OAuth (Recommended): Uses direct URL redirection to avoid redirect URI mismatch issues.
SDK Flow (Fallback): Uses Facebook SDK - try if manual flow doesn't work.
Status:
Ready to start signup process
Session Info Response:
Waiting for response...
SDK Response:
Waiting for response...
Token Exchange Request:
No token exchange performed yet...
Token Exchange Response:
No token exchange performed yet...
;