# WhatsApp Integration (/docs/whatsapp)

> Connect your WhatsApp Business account to send and receive messages, automate responses with bots, and manage campaigns.



















Connect your WhatsApp Business account to send and receive messages,
automate responses with bots, and manage campaigns.

<Tabs items="[&#x22;Phone WhatsApp&#x22;, &#x22;WhatsApp Cloud&#x22;]">
  <Tab value="Phone WhatsApp">
    ## Connecting Phone WhatsApp [#connecting-phone-whatsapp]

    Follow these steps to connect your existing WhatsApp number using QR code
    authentication.

    <Steps>
      <Step>
        ### Initiate connection [#initiate-connection]

        Go to the **WhatsApp** tab in the sidebar. You will see two options: Phone
        WhatsApp and Cloud WhatsApp. Click on the **Phone WhatsApp** card to start
        the connection process.

                <img alt="Initiate WhatsApp Connection" src="__img0" />
      </Step>

      <Step>
        ### Scan QR code [#scan-qr-code]

        A QR code will be displayed on the screen. To scan it:

        1. Open **WhatsApp** on your mobile phone
        2. Go to **Settings** (or Menu on Android)
        3. Select **Linked Devices**
        4. Tap on **Link a Device** and point your camera at the screen

                <img alt="Scan WhatsApp QR Code" src="__img1" />

        <Callout type="warn">
          The QR code is valid for only **15 seconds**. If it expires, you will need
          to regenerate it.
        </Callout>
      </Step>

      <Step>
        ### Attach a bot [#attach-a-bot]

        Once the WhatsApp connection is successful, your number will appear in the
        list. You can now attach a bot to this number.

        * Locate your connected number card
        * Click on the **Select Agent** dropdown or **Attach Assistant** button
        * Choose an available bot from your account

                <img alt="Attaching a bot to the phone number" src="__img2" />
      </Step>

      <Step>
        ### Automated responses [#automated-responses]

        With the bot attached, any incoming message to this number will be
        automatically processed. The bot will respond based on its configuration and
        the user's query.

                <img alt="Bot responding to a message on WhatsApp" src="__img3" />
      </Step>
    </Steps>
  </Tab>

  <Tab value="WhatsApp Cloud">
    ## Connecting WhatsApp Cloud [#connecting-whatsapp-cloud]

    Follow these steps to connect your WhatsApp Cloud API account using your
    Meta developer credentials.

    <Steps>
      <Step>
        ### Initiate Cloud connection [#initiate-cloud-connection]

        Go to the **WhatsApp** tab and select **WhatsApp Cloud**. Click on the
        **Connect Cloud API** card to open the configuration modal.

                <img alt="Initiate WhatsApp Cloud Connection" src="__img4" />
      </Step>

      <Step>
        ### Provide credentials [#provide-credentials]

        A form will appear asking for your WhatsApp Business API credentials. You
        need to provide:

        * **WhatsApp Business Account ID**
        * **User Access Token** (System User Token recommended)
        * **App ID**
        * **Business Manager ID**

        <Callout type="info">
          You can find these details in your
          [Meta App Dashboard](https://developers.facebook.com/apps/) under
          **WhatsApp → API Setup**.
        </Callout>

                <img alt="WhatsApp Cloud Credentials Form" src="__img5" />
      </Step>

      <Step>
        ### Fetch numbers [#fetch-numbers]

        Once you submit valid credentials, the system will automatically authenticate
        with Meta and fetch all **verified phone numbers** associated with your
        WhatsApp Business Account.

        This process may take a few seconds. Using an invalid token or account ID
        will result in an error.

                <img alt="WhatsApp Phone Numbers List" src="__img6" />
      </Step>

      <Step>
        ### Attach a bot [#attach-a-bot-1]

        After the numbers are fetched and displayed in your list:

        1. Find the number you wish to use
        2. Click **Attach Assistant**
        3. Select the AI agent you want to handle conversations for this number

                <img alt="Bot attached to WhatsApp Cloud number" src="__img7" />
      </Step>
    </Steps>
  </Tab>
</Tabs>