Find answers to your questions

WhatsApp

WhatsApp Integration

Overview

WhatsApp integration with FlowGent allows your custom AI agent chatbot to communicate directly with customers through WhatsApp. This powerful integration enables seamless customer interactions, automated responses, and efficient inquiry handling—all through one of the world's most popular messaging platforms.

Before You Begin

Important: The phone number you integrate with FlowGent cannot be simultaneously used on WhatsApp or WhatsApp Business apps. If you're currently using this number with WhatsApp, you must delete your account from the app first.

To Delete Your WhatsApp Account:

  1. Open WhatsApp or WhatsApp Business app
  2. Go to Settings > Account
  3. Select Delete my account
  4. Follow the prompts to complete deletion

Note: The deletion process may take several minutes. Once completed, the number will become available for integration.

If You Previously Used the Number Through Meta Developer:

You must disable two-step verification:

  1. Log in to your WhatsApp Business Account
  2. Select the phone number you want to integrate
  3. Navigate to Settings > Two-step verification
  4. Select Turn off two-step verification

If You'd Like to Use A New Phone Number for Your AI Agent:

There are several providers that allow you to buy a new (online) phone number, such as OpenPhone. The most important thing is that you are able to receive a phone call or text message on your number, because when connecting with WhatsApp your number will be verified.

You Need to Have a Verified Facebook Business Portfolio:

You should have a verified Facebook Business Portfolio. If you don't have one, here's a guide.

Important: you need to have a privacy policy and terms of service on your website, or Facebook will reject your verification process!

Step-by-Step Integration Process

  1. Navigate to the FlowGent dashboard and go to agent overview. alt text

  2. Select the agent you want to integrate with WhatsApp and click on edit.

alt text

  1. Go to Trigger > WhatsApp

alt text

  1. If you haven't set up a WhatsApp connection yet, you can click on "add a connection". alt text

  2. Click on "connect with Facebook" (make sure to read the yellow text first)

alt text

  1. Click Get started alt text

  2. Select the business portfolio that you'd like to connect with alt text

  3. Create a new WhatsApp business account and profile or select an existing ones alt text

  4. Complete the WhatsApp business profile information fields Important: make sure that you're display name is very similar to your legal business name / trade name or it might be rejected by Facebook!

alt text

  1. Add your phone number (make sure the phone number you use isn't already connected to WhatsApp) alt text

  2. Click Next

  3. Wait for verification to complete

  4. Click Finish (or add payment details if you want to start conversations)

How to Change Your Profile Picture & Display Name

  1. Go to Facebook Business --> Settings

alt text

  1. Go to WhatsApp Accounts --> WhatsApp Manager alt text

  2. Go to your phone number settings. alt text

  3. Go to profile. Here you can change your profile picture and display name. Please be aware that your display name will need to be approved again if you change it. alt text

Troubleshooting

If you encounter issues during integration, here are the most common problems:

Business Porfolio Verification Rejected

The most common reasons for this are:

  • Missing phone number or address on your verification documents
  • Missing Privacy Policy and/or Terms of Service on your website

Check if your Business Porfolio is properly verified.

  1. Go to Facebook Business --> Settings

alt text

  1. Then go Business Portfolio Info and look if you're business is properly verified. If not, make the proper adjustments and try it again. alt text

Display Name Rejected

One of the common reasons for rejection of your WhatsApp account is your display name. To see if this is the problem, you can take the following steps.

  1. Go to Facebook Business --> Settings

alt text

  1. Go to WhatsApp Accounts --> WhatsApp Manager alt text

  2. If it says "pending" instead of approved, then display name rejection is probably the problem. Go to your phone number settings. alt text

  3. Go to profile and take a look to see if your display name got rejected. If so, you can edit it. Please make sure it's close to your legal name / trade name. alt text

Previous WhatsApp accounts using this number have not been properly deleted.

Make sure your phone number isn't connected to the Personal WhatsApp app or the Business WhatsApp app. If you connected it to another software before, make sure to disconnect it here:

  1. Go to Facebook Business --> Settings

alt text

  1. Go to WhatsApp Accounts --> Click on the "remove" button alt text

Try to reconnect again with FlowGent.

Congratulations! Your FlowGent AI agent is now connected to WhatsApp and ready to communicate with your customers through this popular messaging platform.

Did this answer your question?