Connect WhatsApp Business app to Kommo

March 5, 2026

What you’ll need:

  • A Kommo account (any plan or 14-day trial).
  • WhatsApp Business app (version 2.24.17 or newer).
  • A Facebook Business Portfolio (or create one during setup). See Meta’s guide for instructions.
  • A phone number with a supported country code.

Keep in mind:

  • Not supported in: Australia, India, Japan, Nigeria, Philippines, Russia, South Korea, South Africa, Turkey, the EEA, the EU, and the UK.
  • New WhatsApp Business app accounts are not immediately eligible for. This feature is designed for businesses already actively using the app and looking to scale with new tools. We recommend using the WhatsApp Business app for a while before onboarding, as eligibility depends on tenure and messaging quality.
  • Only chats that were active within the last 30 days will be imported. Each chat will include messages that are no older than 30 days.

To connect WhatsApp Business app to Kommo, follow these steps:

  1. Go to WhatsApp Business.

  1. Click +Install.

  1. Click Link WhatsApp Number → Click Next.

  1. Choose WhatsApp Business app and click Continue with Facebook.

  1. Click Continue with Facebook.

  1. Log in with your personal Facebook account and click Get Started.

  1. Select an existing or create a new Facebook Business Portfolio. Select Connect WhatsApp Business app.

  1. Enter your phone number → Click Next.

If you see an eligibility error during onboarding, it means your account doesn’t meet Meta’s active account criteria yet. Keep using the WhatsApp Business app actively for a while to become eligible or contact Meta support. Kommo support can also reach out to Meta, but the eligibility is solely their decision.

  1. Confirm your WhatsApp Business account → Click Next. Open WhatsApp Business App, then:
  • Receive a QR Code message.

  • Tap Scan QR Code in the app.

  1. Choose whether to share chat history with WhatsApp Business. If you choose Share chats your chat history and contacts will be imported into Kommo and can be viewed there.

  1. Scan the QR code and review the access request in Kommo, then click Continue.

  1. Ensure WhatsApp Business App is successfully connected.

  1. Click Finish.

  1. A data import message will appear in your WhatsApp Business widget. After about 10–15 minutes, once the import is complete, the message will disappear and your phone number status will update to Connected.

Connecting from WhatsApp Lite

  1. Go to WhatsApp Business.

  1. Click +Install.

  1. You’ll see the phone number previously used in your WhatsApp Lite. If multiple numbers are connected, select the one you want to migrate. Then click Migrate.

  1. Click Continue with Facebook.

  1. Log in with your Facebook account and click Get started.

  1. Choose your existing Business portfolio or create a new one, then click Next.

Continue with steps 4–12 from the WhatsApp Business App connection section. Once you're back in Kommo, the setup continues with one of two paths:

A. If you don’t have templates to transfer

A final setup window appears. Click Finish to complete the process.

A data import message will appear in your WhatsApp Business widget. Once the import is complete, the message will disappear and the phone number status will change to Connected.

B. If you have templates previously used in Kommo

You’ll see a window to select templates to submit to Meta for approval. Click the blue template counter to open the selection modal.

After selecting your templates, click Confirm.

Click Continue.

Wait for Meta to review your templates. Keep in mind:

  • Templates keep their original content and structure.
  • A Wa prefix is added to their names.
  • Approval usually takes from a few minutes to several hours.
  • Rejected templates must be edited or recreated to meet Meta’s guidelines.

To check the status, go to WhatsApp Business > Connect > Templates.

Approved merged templates will show the Approved status.

Learn more about how templates work.

What happens with chat import?

  • If merging is NOT selected, but Share chats is selected (Step 10 above): chat history and contacts from the WhatsApp Business app are imported into Kommo.
  • If merging is selected AND Share chats is also selected: If you are using WhatsApp Lite, all existing chats and leads are already there, so Source merging takes priority over chat import. To prevent duplicate chats, Kommo does not initiate the import.

Learn more about source merging and the transition from WhatsApp Lite to WhatsApp Business.

Import contacts

You can enable and disable contact importing for WhatsApp Business app. Currently, it is enabled by default. To find the enable/disable setting:

  1. Go to Integration marketplace> WhatsApp Business.

  1. Click Accounts.

  1. Click the settings symbol next to the number needed.

The profile will open, and the next steps will vary depending on whether you're a new WhatsApp Business app user or have previously used the app:

  • New users can freely enable/disable contact syncing by clicking Import contacts:

  • Existing users will need to reconnect their numbers to use this functionality. During this reconnection, leads may not arrive, and automations will be paused:

If you need more help with setup or troubleshooting, feel free to reach out to our support chat or contact us via WhatsApp. You can also hire a Kommo partner to do all the hard work for you.

Not a user yet? Sign up for our 14-day free trial or book a free live demo.

Try Kommo free

Discover how Kommo can transform your client management now