> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waply.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect WhatsApp, Instagram, and Webchat to Waply

> Link WhatsApp Business API, Instagram DM, Facebook Messenger, and Webchat to your Waply inbox so all customer conversations flow into one place.

Waply supports four messaging channels — WhatsApp Business API, Instagram DM, Facebook Messenger, and Webchat. You can connect one or all of them, and each channel you add feeds conversations into the same shared team inbox. Follow the instructions for the channel you want to set up.

<Tabs>
  <Tab title="WhatsApp Business API">
    WhatsApp Business API lets you send and receive messages at scale, run broadcast campaigns, build automated flows, and deploy an AI Agent — all on the WhatsApp number your customers already know.

    <Warning>
      WhatsApp Business API is not the same as the regular WhatsApp or WhatsApp Business app. It operates through Meta's Business Platform and requires a verified WhatsApp Business Account (WABA). Some features, including broadcast messaging to customers who have not messaged you first, require Meta's approval of your Message Templates before they can be sent.
    </Warning>

    **Before you begin**, make sure you have:

    * A Meta Business Manager account at [business.facebook.com](https://business.facebook.com)
    * A phone number that is not already registered on any WhatsApp account (personal or Business app)
    * Admin access to your Meta Business Manager

    <Steps>
      <Step title="Open the WhatsApp channel settings">
        In Waply, go to **Settings > Channels > WhatsApp** and click **Connect WhatsApp**.
      </Step>

      <Step title="Enter your business phone number">
        Type the phone number you want to use for WhatsApp Business API. This must be a number that has never been registered on WhatsApp before, or one you have fully deleted from an existing WhatsApp account.
      </Step>

      <Step title="Verify the number">
        Choose **SMS** or **Voice call** to receive your verification code, then enter the 6-digit code in Waply. The number is now registered with Meta.
      </Step>

      <Step title="Connect to Meta Business Manager">
        Waply will prompt you to log in to Facebook and grant access to your Meta Business Manager. Select the Business Manager account that will own the WhatsApp Business Account, review the requested permissions, and click **Continue**.

        Once connected, your WhatsApp number appears as active in **Settings > Channels**.
      </Step>
    </Steps>

    <Note>
      If your number was previously used with the WhatsApp Business app, you must delete that account inside the app before registering it through the API. Meta does not allow the same number to be active on both the app and the API simultaneously.
    </Note>
  </Tab>

  <Tab title="Instagram DM">
    Connecting Instagram DM lets you receive and reply to direct messages from your Instagram Business account directly inside Waply's inbox.

    **Before you begin**, make sure you have:

    * An Instagram Business account (not a personal or Creator account)
    * A Facebook Page connected to that Instagram Business account
    * Admin access to the Facebook Page

    <Steps>
      <Step title="Open the Instagram channel settings">
        In Waply, go to **Settings > Channels > Instagram** and click **Connect Instagram**.
      </Step>

      <Step title="Log in to Facebook">
        Waply opens a Facebook login dialog. Sign in with the Facebook account that has admin access to the Page connected to your Instagram Business account.
      </Step>

      <Step title="Select your Instagram account">
        Waply lists the Instagram Business accounts linked to your Facebook Pages. Select the account you want to connect and click **Connect**.

        Your Instagram account now appears as active in **Settings > Channels**. New DMs will flow into your shared inbox immediately.
      </Step>
    </Steps>

    <Note>
      If you don't see your Instagram account in the list, confirm that your Instagram profile is set to **Business** (not Personal or Creator) and that it is linked to a Facebook Page you manage. You can check this in **Instagram Settings > Account type and tools > Switch to professional account**.
    </Note>
  </Tab>

  <Tab title="Facebook Messenger">
    Connecting Facebook Messenger lets your team handle messages sent to your Facebook Page from within Waply's inbox, alongside all your other channels.

    **Before you begin**, make sure you have:

    * A published Facebook Page
    * Admin access to that Page

    <Steps>
      <Step title="Open the Messenger channel settings">
        In Waply, go to **Settings > Channels > Messenger** and click **Connect Messenger**.
      </Step>

      <Step title="Log in to Facebook and select your Page">
        Waply opens a Facebook login dialog. Sign in, then select the Facebook Page you want to connect from the list. If you manage multiple Pages, only select the one you want to route into this Waply inbox.
      </Step>

      <Step title="Grant page messaging permissions">
        Review the permissions Waply requests — these include reading and sending messages on behalf of your Page. Click **Save** to confirm.

        Your Facebook Page now appears as active in **Settings > Channels**. Incoming Messenger conversations will appear in your inbox.
      </Step>
    </Steps>

    <Tip>
      You can connect multiple Facebook Pages to the same Waply workspace. Repeat the steps above for each Page and use inbox filters or assignment rules to route conversations to the right team.
    </Tip>
  </Tab>

  <Tab title="Webchat">
    The Webchat widget adds a live chat bubble to your website. Visitors can start conversations directly from your site, and those conversations appear in your Waply inbox alongside messages from every other channel.

    <Steps>
      <Step title="Open the Webchat channel settings">
        In Waply, go to **Settings > Channels > Webchat** and click **Add Webchat widget**.
      </Step>

      <Step title="Customize the widget">
        Configure the widget to match your brand:

        * **Widget name**: The name displayed in the chat header (for example, your company name or "Support").
        * **Accent color**: The hex color used for the chat button and header background.
        * **Welcome message**: The first message visitors see when they open the widget (for example, "Hi there! How can we help you today?").

        Click **Save** when you're happy with the settings. You can update these at any time without changing the embed code.
      </Step>

      <Step title="Copy the embed code">
        Waply generates a small JavaScript snippet unique to your widget. Click **Copy code** to copy it to your clipboard.

        ```html embed.html theme={null}
        <script>
          window.waplyConfig = {
            widgetId: "YOUR_WIDGET_ID"
          };
        </script>
        <script
          src="https://cdn.waply.io/widget.js"
          async
          defer
        ></script>
        ```

        Replace `YOUR_WIDGET_ID` with the ID shown in your Waply dashboard — it is included automatically when you copy the snippet from the settings page.
      </Step>

      <Step title="Add the snippet to your website">
        Paste the snippet into every page where you want the widget to appear. Place it just before the closing `</body>` tag, or inside the `<head>` section — both locations work.

        ```html page.html theme={null}
        <!DOCTYPE html>
        <html lang="en">
          <head>
            <meta charset="UTF-8" />
            <title>My Website</title>
          </head>
          <body>
            <!-- your page content -->

            <script>
              window.waplyConfig = {
                widgetId: "YOUR_WIDGET_ID"
              };
            </script>
            <script
              src="https://cdn.waply.io/widget.js"
              async
              defer
            ></script>
          </body>
        </html>
        ```

        Once deployed, reload your website and you'll see the chat bubble in the bottom-right corner. Send a test message to confirm it arrives in your Waply inbox.
      </Step>
    </Steps>

    <Note>
      If you use a CMS like WordPress, Shopify, or Webflow, paste the snippet into your theme's global footer or use a "Custom code" section so it loads on every page without editing individual templates.
    </Note>
  </Tab>
</Tabs>

## Managing connected channels

After connecting a channel you can view its status, rename it, or disconnect it from **Settings > Channels**. Disconnecting a channel removes it from your inbox but does not delete conversation history.

<Note>
  The number of channels you can connect depends on your plan. Starter supports up to three channels; Growth and Enterprise support unlimited channels. See [Billing & Plans](/billing) for a full comparison.
</Note>