Bypassing the phone number addition screen

Updated: Jun 26, 2026

Embedded signup v2 will be deprecated on October 15, 2026. Migrate your integration to v4 before that date to avoid disruption. See Versions for the full upgrade path.

This document describes how to customize Embedded Signup to bypass the phone number addition screen (shown below). The same customization also bypasses the phone number verification screen.

You might not want your business customers to enter or choose a business phone number in the phone number addition screen. You can customize Embedded Signup to skip the screen entirely. However, after a customer successfully completes the customized flow, you must register a phone number for them. To do this, you can programmatically create and register their business phone number. Alternatively, you can build a UI in your app that lets them register a phone number.

Enabling the feature

The phone number screen bypass is controlled by the featureType parameter. To enable it, set featureType to only_waba_sharing in the launch method and callback registration portion of the Embedded Signup code:

// Launch method and callback registration
const launchWhatsAppSignup = () => {
  FB.login(fbLoginCallback, {
    config_id: '<CONFIGURATION_ID>', // your configuration ID goes here
    response_type: 'code',
    override_default_response_type: true,
    extras: {
      setup: {},
      featureType: 'only_waba_sharing', // set to only_waba_sharing
      sessionInfoVersion: '3',
    }
  });
}

When a business customer successfully completes the bypass (only_waba_sharing) flow, the session logging message event will have event set to FINISH_ONLY_WABA:

{  
  data: {  
    phone_number_id: "<CUSTOMER_BUSINESS_PHONE_NUMBER_ID>",  
    waba_id: "<CUSTOMER_WABA_ID>"  
  },  
  type: "WA_EMBEDDED_SIGNUP",  
  event: "FINISH_ONLY_WABA",  
  version: 3  
}