LogoLogo
Become a PartnerStatus Page
  • get started
    • Welcome to 360Dialog
    • Quickstarts
      • Register as a Meta Tech Provider
      • Add a WhatsApp Number
      • Set up Integrated Onboarding
      • Create a Message Template
      • Send a Message
      • (temp title) Getting started as a partner
    • Pricing & Billing
      • Payment Methods for BR: Pix & Boleto
      • Month Closing Invoice (MCI)
    • Get API Access
    • Tech Provider Program
      • Understanding the Meta Tech Provider Program
      • Becoming a Meta Tech Provider: A Step-by-Step Guide
  • MM Lite Beta Program
    • Onboarding
    • Sending Messages
    • Expected Errors & Programming Languages
    • MM Lite Sandbox Testing
      • Sending Messages using MM Lite Sandbox
      • Expected Erros & Programming Languages
  • Partner & Account Management
    • Solutions for Partners
      • Benefits for Partners
      • Partner Hub
      • WABA Management
    • Account Setup & Management
      • Prerequisites and best practices for account creation
      • Account Structure
      • Account Creation
  • Integrations & API Development
    • Webhook Events & Setup
      • Webhook Events (Partner & Messaging API)
      • Webhook Configuration & Management
    • Integration Best Practices
      • Architecture and Security
      • Best Practices for Designing Integrations
        • Design a Stable Webhook Receiving Endpoint
      • Sizing Your Environment Based on Expected Throughput
      • Design a Resilient Message Sending Service
      • Integrated Onboarding
        • Basic Integrated Onboarding
        • Custom Integrated Onboarding
        • Host Your Own Embedded Signup
      • API Key Authentication for the Partner API
  • API Reference
    • Messaging API
    • Messaging Health Status
    • Sandbox (Test API Key)
    • Differences Between Cloud API and On-Premise API for Partners
      • [will be deprecated] Messaging with On-Premise API
    • Partner API
  • WABA Management
    • Managing WABA Accounts
      • Using the Partner Hub to manage Clients and Channels
      • Using the Partner API to manage Clients and Channels
      • Partner Permission to Generate API Key
      • Checking Usage & Statistics
    • Phone Number & Hosting
      • Migrating a Phone Number
        • Migrate number from Meta or alternate BSP to 360Dialog
        • Migrate a phone number to a new WABA
        • Migrate a phone number to a new WABA to change messaging Currency
      • WhatsApp Coexistence
        • Coexistence Onboarding
        • Coexistence Webhooks
      • Hosting type Change (On-premise API to Cloud API)
    • WABA Profile & Compliance
      • Display Name Guidelines
      • WABA Profile Info
      • WABA Policy Enforcement
      • Business Account Verification
    • Partner change (between 360Dialog Partners)
    • WhatsApp Flows
    • Accelerated Onboarding
    • Business Account Verification
  • Messaging
    • Sending & Receiving Messages
      • Conversations
      • Receiving messages
      • Before sending a message
    • Message Types
      • Conversational Components
      • Checklist for Message Broadcasts and Campaigns
      • Text messages
      • Interactive messages
        • Single and Multi Product Messages
        • Location Request Messages
        • Address Messages (India and Singapore only)
      • Contacts & Location Messages
    • Template Messages
      • Template Library
      • Template Elements
      • Sending Template Messages
      • Authentication Templates
        • Zero-Tap Authentication Templates
        • One-Tap Autofill Authentication Templates
        • Copy Code Authentication Templates
      • Catalog Templates
      • Product Card Carousel Templates
      • Single-Product Message Templates
      • Coupon Code Templates
      • Limited-Time Offer Templates
      • Multi-Product Templates
    • Media Messages
      • Upload, retrieve or delete media
    • Messaging Health & Troubleshooting
      • Messaging Limits & Quality Rating
      • Errors While Messaging
      • Messages statuses
  • Commerce & Payments
    • Payments (India Only)
      • Receive WhatsApp Payments via Payments Gateway
      • Receive WhatsApp Payments via Payment Links
      • Order Details Template Message
    • Payments (Singapore Only)
      • Receive WhatsApp Payments via Stripe
    • Products and Catalogs
      • India Businesses: Compliance for Commerce
  • Support & Updates
    • Help & Troubleshooting
      • FAQ
      • Error Code Reference
      • User Support Documentation
        • Tutorials
          • Page How to Troubleshoot Login Issues in the 360dialog Hub
          • How to Report an Issue
          • How to Contact Support
        • How-To Guides
          • Raise a support request
          • Requesting a Status Update for Business Verification
        • Reference
          • Troubleshooting Embedded Signup Issues
          • Commerce Policy Checks for WhatsApp API Access
          • Support Availability & SLAs
          • Incident Issue Prioritization
          • Case Types Table
        • Explanation
          • Why Business Verification Takes Time
          • Why Some Issues Are Not Emergencies
          • Understanding the Support Process
      • Support with Meta
    • Imprint & Data Privacy
    • Product Updates & News
      • How to ensure your Template Messages will be received
      • Integrated Onboarding new look and Campaigns Best Practices
Powered by GitBook
On this page
  • Basic Integrated Onboarding
  • Custom Integrated Onboarding
  • Host your own Embedded Signup
  • Standard components
  • URL/Query Parameters
  • Embedded Signup
  • Webhook Events
  • Permission Screen (direct payment only)

Was this helpful?

  1. Integrations & API Development
  2. Integration Best Practices

Integrated Onboarding

PreviousDesign a Resilient Message Sending ServiceNextBasic Integrated Onboarding

Last updated 22 days ago

Was this helpful?

The Integrated Onboarding solution offered by 360Dialog simplifies the process of creating and adding numbers in the WhatsApp Business Account, giving you flexibility to offer your clients the best experience possible.

Partners who do not want to use an integrated flow can signup accounts with the .

Choosing the right Integrated Onboarding type for your organization depends on several factors, including your technical capabilities, resources, and specific needs for integrating with the WhatsApp Business API.

Basic Integrated Onboarding

The Basic Integrated Onboarding solution built by 360dialog allows Partners to trigger Account Creation and Embedded Signup through intuitive pop-ups with a React.js button already built by us.

Ideal for: Partners who prefer a streamlined, no-hassle setup with standard technical involvement.

The basic Integrated Onboarding will show:

  1. A 360dialog-branded Signup Page, where the client will submit their information to create an account

  2. Embedded Signup, where the client will log in their Business Manager account and register their WABA and phone number

  3. Permission screen, where the client will give you permission to manage their channels (only required if using Direct Payment)

Custom Integrated Onboarding

You can also customize the Integrated Onboarding experience by building your own trigger.

Ideal for: Partners with the capability to manage more complex integrations and who prefer to have more control over the signup experience.

The custom Integrated Onboarding will show:

  1. A 360dialog-branded Signup Page, where the client will submit their information to create an account

  2. Embedded Signup, where the client will log in their Business Manager account and register their WABA and phone number

  3. Permission screen, where the client will give you permission to manage their channels (only required if using Direct Payment)

Host your own Embedded Signup

Partners who are approved by Meta as Tech Providers have the option to host their own Embedded Signup.

Refer to the following documentation to understand the details about this option:

Standard components

URL/Query Parameters

When triggering Integrated Onboarding, different URL parameters allow you to preselect different settings or customize the flow whenever you need.

Parameter name
Description
Values
Stored in database?
Returned in redirect?

email

User email to pre-fill the signup form

string

Yes, as part of the client setup

No

name

User name to pre-fill the signup form

string

Yes, as part of the client setup

No

number

A specific phone number to request permission for. The number has to match the existing number in the hub. It includes the country code without the leading 00/+.

number

No

No

state

Any string value that shall be passed through and returned with the redirect.

string

Yes

Yes

redirect_url

Will be used as individual redirect URL instead of the globally set one.

string (encoded)

No

Will be used as the new redirect URL

partner

Any string value that shall be stored on the client model. Can be retrieved via API as partner_payload.

string

No

No

next

Can be used to redirect clients directly to either the login form or the signup form, in case they are not yet logged in.

login / signup

No

No

lang

Can be used to set the default language of the Integrated Onboarding (not including Meta’s ES) Allowed values: de, en

string

No

No

plan_selection

Can be used to set the default pricing plan for the number to be added.

Will only work for partners enabled for tiered pricing. *If you are not sure of you billing plan, please reach out to our Support Team.

Clients on partners with client payment will be able to change the pre-selected plan.

Allowed values: basic, regular, premium

string

Yes, as part of the number setup

No

connect_client_user

true

string

Yes, as part of the number setup

No

Effective January 2024, 360dialog will not issue billing correction notes due the misuse of the plan_selection parameter and charges will be applied in accordance with the agreed-upon financial terms and the parameters used during onboarding.

Embedded Signup

The Embedded Signup allows customers to log in their Meta Business Account to create new WABAs and/or register new phone numbers.

The 360dialog Embedded Signup is triggered automatically throughout the Integrated Onboarding flow. Partners can host their own Embedded Signup if they wish to, after following specific requirements from Meta.

Webhook Events

When you have a Partner API Webhook URL set, we will send different webhook events that will allow you to understand a status of a signup.

Permission Screen (direct payment only)

The /permission screen is designed to allow the client (account owner) to share this permission while still in the Integrated Onboarding. Alternatively, the client can grant permissions in their Client Hub settings

To trigger the permission screen, this route needs to be called:

https://hub.360dialog.com/dashboard/app/<partner-id>/permissions
open(url, target, windowFeatures)

In the specific case this would result for example in the following method:

const windowFeatures = "toolbar=no, menubar=no, width=600, height=900, top=100, left=100"
open(https://hub.360dialog.com/dashboard/app/<partner-id>/permissions, "integratedOnboardingWindow", windowFeatures)

The permission screen is optimized to be opened in a popup without controls and a size of 600 px (width) by 900 px (height).

Default: regular basic value is only available to

If your Partner Hub is set to Partner Payment, you will receive permission to manage the numbers signed up by default. If the setting is Direct Payment, the client will have to give you permission to manage the numbers. See .

Independently of the development language you’re using, you should be able to use the browser’s open() method of the interface. It follows the syntax:

Custom Integrated Onboarding
If you are not approved by Meta as a Tech Provider
If you are already approved by Meta as a Tech Provider
Host Your Own Embedded Signup
Partner Permissions
Window
Basic Integrated Onboarding
Signup link
Premium Partners.
See Webhook events and notifications.