Connect WhatsApp
Connecting a WhatsApp Business number lets you send WhatsApp campaigns and automations, and answer customers in the Conversations inbox. You connect once, through the provider that hosts your WhatsApp Business account, and manage everything else from the WhatsApp settings page.
الأدلة متوفرة باللغة الإنجليزية.
Before you start
- A WhatsApp Business account (WABA) with at least one phone number, hosted with one of the providers Contlo supports: WhatsApp Cloud (Meta's own API), MSG91, 360 Dialog or Gupshup.
- Access to that provider's dashboard, so you can copy credentials. For WhatsApp Cloud this is Meta Business Manager.
- A Contlo role that can open App Market.
- Customers who have opted in to WhatsApp. See Collect opt-ins.
Open App Market, find WhatsApp and install it. You also land on the same setup if you start a campaign and click Install Whatsapp on the WhatsApp card.
Choose your provider
The first screen is Choose your vendor. Select the provider that hosts your WhatsApp Business account and click Proceed.
| Provider | What happens next |
|---|---|
| WhatsApp Cloud | You enter your Meta access token and account IDs, and verify them. See the steps below. |
| MSG91 | You enter your MSG91 API key. All numbers on that MSG91 account are connected. |
| 360 Dialog | You are sent to 360 Dialog to authorize the connection, then returned to Contlo. |
| Gupshup | Gupshup accounts are connected by the Contlo team. Write to hello@contlo.com to get started. |
Connect with WhatsApp Cloud
- Paste your WhatsApp access token. Generate it in Meta Business Manager under Business Settings → Accounts → WhatsApp Business Accounts.
- Enter your WhatsApp Business Account ID. In the same place, click the account you want to use. A panel opens with the account details, including the ID.
- Enter your WhatsApp Business App ID.
- Click Verify. Contlo checks the token and account ID with Meta and shows Account Details verified successfully!
- Review Account details: the WhatsApp Business ID, the WhatsApp Business Name, and the Account quality of the selected number.
- Under Business number, pick the phone number to send from. An account can have several numbers.
- If everything is right, click Yes, proceed further. If not, correct the fields and verify again.
When you see Account Details updated successfully! the connection is complete and the WhatsApp settings tabs open.
Connect with MSG91
- Generate an API key in your MSG91 control panel.
- Paste it into MSG91 API key and click Verify.
- Check the Phone numbers list. All phone numbers associated with your MSG91 account are connected together.
- Click Yes, proceed further.
After setup you land on the General tab, where your connected numbers are listed.
Numbers, quality rating and your provider dashboard
For WhatsApp Cloud and MSG91 accounts, the General tab is your overview.
| On the General tab | What it tells you |
|---|---|
| Business number(s) | The number or numbers connected to Contlo. |
| Account quality | WhatsApp Cloud accounts only. Meta's rating of how your template messages were received by users in the last 24 hours: HIGH, MEDIUM or LOW. UNKNOWN means Meta has not reported a rating. |
| Go to Meta Dashboard / Go to Msg91 Dashboard | Opens your provider's dashboard, where you manage the display name, business profile and messaging limits. |
| Opt-in options | Guides for collecting WhatsApp consent at checkout and through forms. |
Collect opt-ins
WhatsApp campaigns are sent to your WhatsApp subscribers: contacts with a phone number who have agreed to hear from you on WhatsApp. The General tab lists two ways to collect that consent.
| Option | How it works |
|---|---|
| Checkout opt-in | A checkbox on your checkout page where customers sign up for order updates and regular updates on WhatsApp. |
| Form opt-in | Pop-up forms with a WhatsApp number field that collect the customer's consent. See Forms. |
You can also set a contact's WhatsApp subscription when you import contacts.
Change your number or credentials
WhatsApp Cloud accounts have a Settings tab for the connection itself.
- To send from a different number on the same account, choose it under Business number and click Update number.
- To replace an expired token, paste the new WhatsApp access token, confirm the WhatsApp Business Account ID and click Update info.
- If you click a button without changing anything, you see Nothing to update.
To disconnect WhatsApp from Contlo, open Actions at the top right of the page and choose Uninstall.
The WhatsApp settings tabs
Once connected, the WhatsApp page shows a set of tabs. Which ones you get depends on your provider and on what is enabled for your account.
| Tab | What it is for | Available to |
|---|---|---|
| General | Numbers, quality rating, provider dashboard link and opt-in guides. | WhatsApp Cloud and MSG91 |
| Templates | Create, sync, test and delete message templates. See WhatsApp templates. | Everyone |
| List Messages | Build WhatsApp lists: a menu of options, each with a Title of up to 24 characters and a Description of up to 72. Each option can be linked to a quick reply to create a guided, multi-step chat. | MSG91, 360 Dialog and Gupshup |
| Dynamic QR Buttons | Build sets of quick-reply buttons, each linked to a quick reply. | MSG91, 360 Dialog and Gupshup |
| Catalogues | Sync your Meta catalogs so agents can share products and carts in chat. Click Sync catalogue, log in with Facebook, then choose the business and the catalog. | Accounts with catalogs enabled |
| Quick Replies | Saved answers for the inbox. See Helpdesk settings. | Everyone |
| Settings | For WhatsApp Cloud: number and credentials. For other providers with WhatsApp payments enabled: the checkout and order tracking flows below. | Varies |
| AI Agent | Turn on AI agent responses and select an AI agent to handle all incoming customer messages. See AI agents. | Accounts with AI agents enabled |
| Onsite Widget | A floating WhatsApp chat launcher for your storefront. | Everyone |
Onsite Widget
Turn on Enable widget to show a WhatsApp chat launcher on your storefront. Set the Widget position (Bottom left or Bottom right), Widget size, the Horizontal offset and Vertical offset, and a Widget default message that is prefilled when a shopper starts a chat with your brand.
Checkout and order tracking flows
If WhatsApp payments are enabled for your account, the Settings tab offers two automated flows.
- Checkout flow for Catalogue starts whenever a customer sends catalog items to your business. It collects the customer's address and shares a payment link. You set Shipping rates (a price, with optional conditional pricing by minimum and maximum order price) and the payment method. It needs a completed payment gateway integration before it can be enabled.
- Track Order flow starts when a customer sends one of the Keywords to trigger flow. The customer receives a list of their order IDs, picks one, and gets the tracking link.
- Check Disable 'Keyword Actions' when this flow is active if you don't want keyword actions to respond at the same time.
After you connect
Common connection errors
| What you see | What to do |
|---|---|
| Something went wrong, please try again! after clicking Verify | Meta rejected the token or the account ID. Check that the token has not expired, that it belongs to the same business as the WhatsApp Business Account ID, and that you copied both without extra spaces. |
| Something went wrong, please try again! after Yes, proceed further | The details were verified but could not be saved. Confirm a Business number is selected and try again. |
| No phone numbers found or No phone numbers found for this API key | The account has no WhatsApp number yet. Add and verify a number in your provider's dashboard, then verify again in Contlo. |
| API Key is required | Paste your MSG91 API key before clicking Verify. |
| Couldn't load WhatsApp settings | Reload the page. If it keeps happening, write to hello@contlo.com. |
| Account quality shows LOW | Pause broad sends, review recent templates and audiences, and send only to opted-in customers until the rating recovers. |
| The WhatsApp card on a new campaign says Install Whatsapp | WhatsApp is not installed yet. Click it to start the setup on this page. |
| The WhatsApp option is missing when creating a campaign | The WhatsApp channel isn't enabled for your account. Ask your account manager or write to hello@contlo.com. |
أدلة ذات صلة
- WhatsApp templatesCreate WhatsApp message templates with headers, variables, media and buttons, submit them for Meta approval, and test, edit or delete them.
- WhatsApp campaignsSend a one-time WhatsApp message to your subscribers: pick an approved template, fill variables, add media and links, test, and launch.
- Conversations inboxReply to WhatsApp, Instagram, SMS and live chat messages in one inbox: filter, assign, tag, resolve, and share orders or carts with customers.
- Helpdesk settingsSet up your support inbox: away message, notification sounds, custom statuses, auto-assignment, quick replies, keyword actions and tags.
- App MarketBrowse, install, set up and uninstall apps in Contlo: channels, analytics, ad audiences and the third-party tools your store already uses.