Ainisa AI documentation

Appearance

💬 WhatsApp Integration ​

The WhatsApp Integration allows your AI Assistant to communicate with users directly through WhatsApp.
Ainisa uses the Meta Cloud API to securely connect your WhatsApp Business account.

⚠️ Before You Start ​

Before connecting WhatsApp, please make sure your number meets the following conditions:

  1. Your phone number must NOT be registered in the WhatsApp App or WhatsApp Business App.
    If it is registered, you must delete that WhatsApp account first:

    • Open WhatsApp or WhatsApp Business App.
    • Go to Settings → Account → Delete my account.
    • Confirm deletion using your phone number.

  2. If your WhatsApp number is already registered in Meta Business,
    make sure to disable Two-Factor Authentication (2FA) before connecting.
    You can do this from:

    • Meta Business Manager → WhatsApp Accounts → Phone Number → Two-step verification → Disable.

🔧 Create a WhatsApp Integration ​

  1. Go to your Business Dashboard → Integrations
    👉 https://ainisa.com/business/integrations

    Integrations list

  2. Click Create Integration

  3. Choose WhatsApp from the list.

  4. In the opened page, fill the following fields:

    FieldDescription
    Integration TitleA name for your integration (e.g., “Customer Support WhatsApp”).
    AssistantSelect your AI Assistant that will handle conversations.
    API KeySelect your API key for authorization.

    Create WhatsApp Integration

  5. Click Connect.
    This will open a new page hosted by Meta (Facebook) where you’ll complete the connection.

🔗 Meta Onboarding Flow ​

Once redirected to Meta, follow these steps carefully.

1. Connect your account to Ainisa ​

You’ll see a page like this. Click Continue to start onboarding.

Meta Connect Page

2. Select or create a Meta Business Account ​

If you already have a business account, select it.
Otherwise, create a new one.

Meta Select Business

3. Select or create a WhatsApp Business Account ​

In the next step, choose your existing WhatsApp Business Account.
If you don’t have one, create it.

Meta Select WhatsApp Account

4. Select or add your WhatsApp phone number ​

Choose the phone number you want to use.
If no number exists, create a new one and verify it via SMS or phone call.

Meta Add Phone Number

5. Review and confirm access ​

Finally, Meta will ask you to confirm the access Ainisa will have.
Click Confirm to continue.

Meta Confirm Access

6. Finish the setup ​

After you confirm, click Finish.
You’ll be redirected back to the Ainisa Integrations page, and the WhatsApp number will be automatically added to your account.

📱 Handling WhatsApp Numbers Already in Meta Business ​

If you selected a phone number that is already connected in your Meta WhatsApp Business Account or 2 step verification is enabled for your whatsapp business account, you may see one of two situations:

1. Number is in “Pending” status ​

  • The number must be verified using a 6-digit PIN code.
  • After Ainisa adds the number, you’ll be redirected to a page where you must:
    1. Enter the 6-digit PIN code
    2. Click Register Phone
  • After this, your number will show VERIFIED and CONNECTED status in your Meta Whatsapp Business Account.

đź“ť Note: Ainisa does not store your PIN code. Save it somewhere safe.

2. Number is “Verified” but not “Connected” (e.g., DISCONNECTED) ​

  • You’ll still be redirected to the Register Phone page.
  • Enter the same PIN code you used when registering this number in Meta Business.
  • If you don’t remember the PIN:
    1. Go to Meta Business → WhatsApp → Your Number → Two-step verification tab
    2. Either disable 2FA, or change the PIN.
    3. Then enter the new PIN on Ainisa and click Register Phone.

Once done, your WhatsApp integration will be connected.

✅ Connection Completed ​

After finishing all steps:

  • You’ll see your WhatsApp integration listed in Ainisa.
  • The Webhook and Enabled columns will show green check marks.
  • Your customers can now send messages to your WhatsApp Business number, and Ainisa will automatically reply through your AI Assistant.

🔒 Notes ​

  • Make sure you use a phone number not connected to any active WhatsApp App.
  • Disable 2FA before integration to avoid verification errors.
  • If you change your Meta account’s password or security settings later, you may need to reconnect the integration.
  • After your integration is active you can send 1000 free messages monthly. Make sure to add a payment method on your Meta billing settings to be able to send more than 1000 messages per month.

⏭️ Next Steps ​