Documentation

Connecting WhatsApp

Connecting Quidget to WhatsApp allows your AI chatbot to communicate with users directly, automating responses and improving customer support. This guide will take you through the steps required to integrate Quidget with WhatsApp using Twilio.

Before You Start

  • The WhatsApp phone number used for integration can only be used by the chatbot and cannot be used simultaneously on a personal or business WhatsApp account. If you attempt to use the number in WhatsApp or WhatsApp Business, you will need to remove it from those applications first.
  • If you are already using the number on WhatsApp, you must delete your WhatsApp account first.

If You Previously Used WhatsApp with Meta Developer for Business

If your number was used with WhatsApp through Meta Developer, you need to disable two-step verification:

  1. Log into your WhatsApp Business Account on the Meta Developer platform.
  2. Select the phone number you want to integrate.
  3. Navigate to Settings > Two-step Verification.
  4. Turn off Two-step Verification

Step 1: Set Up a Twilio Account

  1. Go to twilio.com and sign up or log in.
  2. During setup, select WhatsApp as your main product.
  3. Follow the on-screen instructions to complete your account setup.

Step 2: Get a Twilio Phone Number

  1. In your Twilio console, navigate to the Phone Numbers section.
  2. You can Get a trial phone number or Use the default Twilio number you provided when you signed up.
  3. Select a number that supports WhatsApp.

Step 3: Register on WhatsApp using Self Sign-up

To ensure that you always have the latest information on how to register WhatsApp with Twilio correctly, follow their instructions:

Step 4: Connect Twilio to Quidget

  1. Log in to your Quidget account.
  2. Navigate to Settings > Channels.
  3. Click Connect on the WhatsApp integration card.
  4. Enter the following Twilio details:
    • Account SID
    • Auth Token
    • Twilio Phone Number
  5. Save your settings.

Step 5: Configure Webhooks for Incoming Messages

  1. Copy the Webhook URL from your WhatsApp integration in the Quidget interface.
  2. Go to your Twilio > WhatsApp Senders.
  3. Select the number with which the integration was created.
  4. Click Edit Sender.
  5. Scroll down to the Endpoint configuration settings.
  6. You don't have to choose anything in the Messaging service (you can leave None).
  7. Go to the Webhook URL for incoming messages option.
  8. Enter your Quidget Webhook URL (this allows Twilio to send incoming WhatsApp messages to Quidget).
  9. Set the Webhook method for incoming messages URL to POST.
  10. Save the changes.

Step 6: Verify the Connection & Test

  1. Go to Quidget App.
  2. Go to the Share page and click the Settings button on the top right.
  3. Activate the Show channels switch and Save.
  4. Tap on the WhatsApp channel > You will be taken to your app.
  5. To start a conversation with the bot, send /start.
  6. If the chatbot replies correctly, your integration is working!