Multi-Solution Conversations allows businesses to use multiple partners and solutions on the same phone number, creating a seamless chat thread experience for their customers.
Requirements
This feature is currently in a closed beta. Please reach out to your partner manager for more details.
Businesses with banned or restricted WhatsApp Business accounts (WABA) are not eligible. Use the Business Support Home to address restrictions.
Features
Simple end-business onboarding via Embedded Sign-up: Partners can onboard businesses easily through Embedded Signup.
Payment and template isolation per partner: Each partner has their own WhatsApp Business Account, their own templates, and their own billing and metrics.
Limitations
Since this feature is still in beta, some functionality may not work as expected. See Beta Product Testing Terms.
How Multi-Solution Conversations work
The chart above illustrates a new WABA shared with each integrated partner, and assets separated per WABA.
The business shares all phone numbers associated with their WhatsApp Business Account (WABA) to a partner through the Embedded Signup flow.
The system creates and shares a new WABA with the partner the business onboards with.
The partner now has messaging or calling access to the business phone numbers shared with them and can message or manage calls on behalf of the business.
Supported APIs and usage
Businesses can use a single phone number across one or multiple partners across the following APIs and uses:
Conversation routing and management: currently, all parties the phone number is shared with receive incoming webhooks. Businesses must work with partners to manage response handling.
Coexistence phone numbers
Phone numbers using the Groups API
WABA created through Embedded Signup which are used on Ads Manager for Marketing Messages
Only 5 partners or solutions can be enabled per each end-business WhatsApp Business Account (WABA).
Only 1 partner can attach a catalog to the shared phone number(s) between partners.
Phone number sharing limitations
The business cannot share a phone number with the same partner more than once via different WABAs.
For example, the business has a phone number linked to WABA 1 and then shares WABA 1 with Partner 1. If you have the same phone number linked to WABA 2, you cannot also share WABA 2 with Partner 1. If you try to share the phone number, you may receive an error.
How messaging, calling, and account management works when using MSC
Use the following table to understand how different features and APIs work when using MSC as a partner or business.
Onboarding
Value: Use an existing phone number across multiple partners and solutions.
Business Experience
Partner Experience
The business onboards an existing phone with more than one partner via Embedded Signup.
Partners can see the new WABA shared with them within Meta Business Suite settings.
Account management
Value: Account management as usual
Business Experience
Partner Experience
You can perform account management operations via the usual pathways (WhatsApp Manager, API, and so on) based on permissions granted.
API usage
Value: Enable messaging and calling functions across multiple partners on a single phone number
Feature
Business Experience
Partner Experience
Cloud API Messaging
Marketing Messages API for WhatsApp
Not applicable
Send messages: All partners can send messages via API on the shared phone number(s).
Receive messages: All partners will receive all incoming webhooks on the shared phone number(s).
Value: Simplified, siloed asset management per WABA
Feature
Business Experience
Partner Experience
Templates
The business can create and see templates on all WABAs shared with partners.
Partners can only create templates on the WABAs that are shared with them.
Partners are not able to see other Partners’ templates
Phone numbers
Phone numbers are a shared resource.
Whether the end business or partner adds the phone number, it will be visible to all in WhatsApp Manager. Any new phone numbers added to WABAs using MSC are shared with all partners with access to these MSC WABAs.
Offboarding
Value: The business has full control of what partners, assets, and accounts they retain.
Role/Asset
Business Experience
Partner Experience
Partner Experience
WABA
The business can delete the WABA.
Partners cannot delete the WABA shared with them.
Phone number
Both the business and partner can delete a phone number.
Partner
The business can remove the partner.
Not applicable.
How violations and bans work with MSC
Phone number violations
Phone number violations will ban all WABAs across all partners, associated with the phone number.
Template violations
Template violations will only apply to the violating WABA.
Business portfolio violations
Any bans on the business portfolio will ban all WABAs associated with the phone number.
Only available to businesses with a messaging limit of at least 1,000 business-initiated conversations in a rolling 24 hour period.
Once a business meets the eligibility requirements, the MSC flow for Embedded Signup is automatically displayed in the Embedded Signup flow (v2 and above). Partners don’t need to configure anything in Embedded Signup for this to work.
When businesses sign up to a partner through Embedded Signup, they see the flow below and can choose to share their existing business phone numbers. This onboards them to MSC. Embedded Signup has two experiences, and a given business may see either one randomly. Both experiences are described below.
Once the business completes the Embedded Signup flow, the partner does not need to re-register with the business.
Embedded Signup flow for businesses (experience 1)
The Notes column calls out any MSC-specific notes for each screen.
Select ‘Use a new or existing WhatsApp number’, then click on the dropdown ‘Add a new WhatsApp number’, then select existing WhatsApp Business Account you want to share with current partner
Step 3: The business selects the WABA with the phone number(s) they would like to share. Note that these numbers are only selectable if they have not been shared already with this partner.
Step 4: Create a name for the new WhatsApp Business Account being created.
Step 5: Verify permission information.
Step 6: Verify signup information and finish.
Troubleshooting
The “Share existing WhatsApp phone numbers” option is greyed out
This can happen for several reasons:
The business already has a solution with the partner they are trying to share the number with.
The business has exceeded the 5 partner maximum for the number.
The phone number is not eligible to send 1k messages yet.
The phone number has not been registered.
What can I do if the business phone number goes offline?
Rarely, a phone number can go offline. To solve this issue, try the following:
Register the phone number again: The business should search each of their WABA activity logs to find which partner registered the phone number first. Then, that partner can register the phone number again.
Turn off 2-factor authentication (optional): If the business cannot obtain which partner originally registered the phone number, they can shut off two-factor authentication and have another partner register the number again. Learn how to disable 2FA on a phone number.
Frequently asked questions
How do I get support?
For support concerning Multi-Solutions Conversations, choose the WABiz: Onboarding topic when opening a Direct Support ticket.
How can I offboard from MSC?
To offboard from MSC:
Migrate templates (Optional): If there are newly created templates on an MSC-created WABA, please migrate them before offboarding. [Learn how to migrate templates here.]
Submit a WhatsApp support ticket: Use the request type “Embedded Signup - MSC Offboarding” and include the WABA you would like to retain.
Is MSC supported for Tech Providers, Tech Partners, and Multi-Partner Solutions?
Yes.
Will a partner be able to see how many partners a client is using and the specific services/capabilities each partner provides?
No.
Does every partner need to register a given business phone number to onboard it to MSC?
No, only one partner needs to register it. Once the number has been registered, it is ready to be used with new partners without the need to re-register it.
What happens if a business tries to onboard without having previously registered their phone number(s)?
An error will be displayed in Embedded Signup, prompting the business to register their number(s).
If multiple partners respond to messages within the same conversation window, who will be charged?