Skip to main content

Measurement Partners | Developer Documentation

Measurement Partners

Updated: Dec 12, 2025
A Measurement Partner is a third-party company that helps businesses measure the effectiveness of their marketing campaigns on our platform.
Measurement Partners gain read-only access to WhatsApp Business Account (WABA) analytics data and webhooks. Specifically, they can view phone numbers, message templates, and incoming messages, and can access WABA analytics data.
For a business to share their analytics data with a Measurement Partner, they must already have a WABA. Measurement Partners cannot create WABAs or send messages on behalf of their clients.

Onboarding flow overview

Follow these steps to onboard as a Measurement Partner:
    Complete Tech Provider onboarding.Create your Facebook Login Button using the Measurement Partner ES template instructions belowEmbed the Facebook Login Button on your website

    How to create Facebook Login button using the Measurement Partner ES template

    Follow the steps below to create your Facebook Login button that will show the Measurement Partner ES flow to your customers.

    Step 1: Load the Facebook JavaScript SDK

    See Basic Setup for instructions on loading the basic version of the Facebook JavaScript SDK with the options set to their most common defaults.
    The fbAsyncInit function must be attached to the window object before the line of code loading the JavaScript SDK as the SDK calls this function to set up the Facebook Login information.
    This setup uses the following parameters:
      appId — The Meta app IDcookie — Enables cookies to allow the server to access this sessionxfbml— Parses social plugins on the pageversion — The Graph API version to use
      Example
      <script>
        window.fbAsyncInit =function(){// JavaScript SDK configuration and setup
          FB.init({
            appId:'<i>facebook-app-id</i>',// Meta App ID
            cookie:true,// enable cookies
            xfbml:true,// parse social plugins on this page
            version:'v25.0'//Graph API version});};</script>

      Step 2: Create Facebook Login for Business Configuration

      Prerequisites

        You should have created an app in the App Dashboard on https://developers.facebook.com/Add the Facebook Login for Business product to your appFollow best practices on how to set up Client OAuth settings, specifically settings like Valid OAuth Redirect URIs and Allowed Domains for the JavaScript SDK

        Process

          In the App Dashboard, under Facebook Login for Business, click TemplatesClick the Use template button for the WhatsApp Measurement Partner template.Since all the template configuration details have been set, simply click Create from templateCopy and retain the Configuration ID and set this value in the Facebook Login Button script in the next step.

          Step 3: Set up Facebook Login

          Facebook Login allows you to place a button on your website or portal to initiate a connection to Facebook. Businesses can use this login flow to associate their Facebook profiles with their business presence (i.e., Business Manager) in order to streamline onboarding.
          The Facebook Login button should be implemented in a location of your choice (platform portal, landing page, etc.) using the instructions below to trigger the Embedded Signup oAuth flow.
          After loading the JavaScript SDK and initializing it with the proper information, set up the FB.login() function to trigger the Embedded Signup flow.
          Make sure the following are included:
            The response callback functionThe config_id parameterThe extras object with:
              The setup parameter for any prefilled form data
              Example
              <script>
                window.fbAsyncInit =function(){// JavaScript SDK configuration and setup
                  FB.init({
                    appId:'<i>your-facebook-app-id</i>',// Facebook App ID
                    cookie:true,// enable cookies
                    xfbml:true,// parse social plugins on this page
                    version:'v25.0'//Graph API version});};// Load the JavaScript SDK asynchronously(function(d, s, id){var js, fjs = d.getElementsByTagName(s)[0];if(d.getElementById(id))return;
                  js = d.createElement(s); js.id = id;
                  js.src ="https://connect.facebook.net/en_US/sdk.js";
                  fjs.parentNode.insertBefore(js, fjs);}(document,'script','facebook-jssdk'));// Facebook Login with JavaScript SDKfunction launchWhatsAppSignup(){// Conversion tracking code
                  fbq && fbq('trackCustom','WhatsAppOnboardingStart',{appId:'<i>your-facebook-app-id</i>', feature:'whatsapp_embedded_signup'});// Launch Facebook login
                  FB.login(function(response){if(response.authResponse){const code = response.authResponse.code;// The returned code must be transmitted to your backend,// which will perform a server-to-server call from there to our servers for an access token}else{
                      console.log('User cancelled login or did not fully authorize.');}},{
                    config_id:'<CONFIG_ID>',// configuration ID goes here
                    response_type:'code',// must be set to 'code' for System User access token
                    override_default_response_type:true,// when true, any response types passed in the "response_type" will take precedence over the default types
                    extras:{
                      setup:{...// Prefilled data can go here}}});}</script>

              Step 4: Create a login button

              Create a button or link on your website to launch the Embedded Signup flow. Use the onClick function to call the launchWhatsAppSignup() function set up in Step 3 above.
              Example
              <buttononclick="launchWhatsAppSignup()"style="background-color:#1877f2; border: 0; border-radius: 4px; color: #fff; cursor: pointer; font-family: Helvetica, Arial, sans-serif; font-size: 16px; font-weight: bold; height: 40px; padding: 0 24px;">Login with Facebook</button>

              Embed your new Facebook Login button

              Copy the button code to the desired location on your site.

              Testing the Embedded Signup flow for Measurement Partners

                On the sidebar under WhatsApp, click ES Integrations and then scroll down to Embedded sign-up launch.Under Embedded sign-up dialog, choose your Measurement Partner config and click Login with Facebook.Follow the prompts to test the sign-up flow.