whatsapp

sidebar_position: 3 title: WhatsApp slug: /integrations/whatsapp

WhatsApp Integration

Connect your Chatislav AI agent to WhatsApp so customers can chat with your assistant through a WhatsApp Business number.
The integration uses Meta’s official WhatsApp Business Cloud API via OAuth – nema ručnog podešavanja webhook‑ova ni tokena u panelu.

 

Before You Start (Requirements)

Before you start the integration, make sure you have:

• A WhatsApp phone number that will be connected to your agent
• A Facebook (Meta) Business Account
• Access to Meta Business / WhatsApp Business settings
• A Chatislav account with a configured AI agent

Important notes:

• The phone number you connect to Chatislav via the WhatsApp Business API cannot be used in the regular WhatsApp or WhatsApp Business apps anymore
• If the number is already in use in WhatsApp / WhatsApp Business:
  • Open the WhatsApp / WhatsApp Business app
  • Go to Settings → Account
  • Choose Delete my account and wait until Meta releases the number
• If you previously used this number with the WhatsApp Business API / Meta Developer:
  • In your WhatsApp Business account, turn off Two‑step verification
  • Go to Settings → Two-step verification and choose Turn off
• It’s recommended to have an approved display name for your WhatsApp Business profile before integrating (configured in Meta Business / WhatsApp Business)

 

Step 1: Select the Agent in Chatislav

1. Log in to your Chatislav account
2. Open the AI agent you want to connect with WhatsApp

 

Step 2: Open the WhatsApp Integration

1. In the left sidebar, go to "Integrations"
2. In the list of integrations, find the "WhatsApp" card

 

3. Click "Connect" on the WhatsApp card

 

Step 3: Sign in to Meta / Facebook

1. You will be redirected to the Meta / Facebook login screen
2. Log in with your personal Facebook account that has access to your Business account

 

3. Click "Get started" or "Continue" to proceed with the connection

 

Step 4: Choose or Create a Business Profile

1. In the Meta wizard, select an existing Business Account or create a new one

 

2. Then choose or create the WhatsApp Business profile you’ll use with Chatislav

 

3. Fill in the basic information for the Business profile (name, category, description)

 

Step 5: Add the WhatsApp Number

1. In the phone number step:
   • Enter the WhatsApp phone number you want to use with the agent
   • It’s recommended to use only one number in this profile (easier to manage and bill)

 

2. Choose a verification method (SMS or call) and enter the verification code

 

3. Click "Continue" and wait a few seconds for Meta to complete the verification

 

4. When everything is complete, click "Finish"

 

Step 6: Review and Manage WhatsApp in Chatislav

After a successful integration:

1. You’ll return to Chatislav, and the WhatsApp card will show status "Connected"
2. By clicking "Manage", you can:
   • See the connected WhatsApp number
   • See basic profile information
   • Remove the number or disable the integration for the current agent if needed

 

3. (Optional) If the Chatislav UI has a dedicated "Profile" / "Styling" screen for WhatsApp:
   • You can configure display name, description, greeting message, etc.
   • Click "Save" when you are done

 

Step 7: Test the WhatsApp Integration

1. From another phone or test number, add your WhatsApp Business number
2. Send a test message (for example “Hi” or a common customer question)

 

3. Your Chatislav AI agent should reply automatically within a few seconds

 

4. Make sure that:
   • Messages are delivered without errors
   • The responses are relevant and use the agent’s knowledge
   • The conversation feels natural in the WhatsApp format

 

Billing & Limits (Meta)

• Meta usually provides a free monthly tier (for example, 1000 messages) for the WhatsApp Business Cloud API
• To send more messages, you need to add a payment method in Meta billing settings
• Message billing is handled by Meta, not by Chatislav – Chatislav just uses your existing WhatsApp Business API account

 

Troubleshooting

Cannot connect the number (Meta errors)

Check:

• That the phone number is no longer active in the regular WhatsApp / WhatsApp Business app (you must delete the account first)
• That two‑step verification is turned off in the WhatsApp Business account
• That you are using the correct Business Account and have the necessary permissions

 

Messages are not arriving in Chatislav

Check:

• That the WhatsApp integration in Chatislav shows status "Connected"
• That the correct number is shown under Manage
• That you’re sending test messages to that exact number

 

Agent is not responding to messages

Check:

• That the integration is connected to the correct agent
• That the agent responds normally in the web widget / testing environment
• That the knowledge base is trained and enabled

 

Best Practices

1. Use a dedicated phone number for the WhatsApp Business API – not a personal number
2. Before integrating, clean up old Meta/WhatsApp Business settings (two‑step verification, old projects)
3. Monitor message usage in the Meta billing section
4. In your WhatsApp Business profile, clearly explain that an AI assistant is available (and how human support is provided if you have it via another channel)
5. Regularly review Chats & Analytics in Chatislav to see how users interact over WhatsApp

 

After finishing all the steps, your Chatislav agent is ready to respond to messages sent to the connected WhatsApp number.
Users can now talk to your AI assistant directly through WhatsApp.