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

# Learn how to manage your whatsapp channel deployments and credits tracking

> Configure WhatsApp channel integrations. Manage your channel deployments, track credits, and optimize your messaging experience.

Channel settings allow you to connect and configure WhatsApp Business numbers for your AI Agents, enabling seamless communication through WhatsApp messaging.

## WhatsApp Business Numbers management

<Steps>
  <Step title="Add Business Number" icon="plus">
    Click the `+ Add Business Number` button in the top-right corner to open the configuration modal.

    <Frame>
      <img src="https://mintcdn.com/tars-c52ebe98/pzfXZlbe5u4r3EET/images/dashboard/account/whatsapp/step-1-click-add-bussiness-number.png?fit=max&auto=format&n=pzfXZlbe5u4r3EET&q=85&s=833720fce9e207d2540f2adb0d52c431" alt="WhatsApp Numbers page with Add Business Number button" width="1964" height="981" data-path="images/dashboard/account/whatsapp/step-1-click-add-bussiness-number.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/tars-c52ebe98/pzfXZlbe5u4r3EET/images/dashboard/account/whatsapp/step-2-whatsapp-number-configuration.png?fit=max&auto=format&n=pzfXZlbe5u4r3EET&q=85&s=6aad2549eec1d82c45fbcc17fd1e924a" alt="Add Business Number modal with configuration form" width="1964" height="981" data-path="images/dashboard/account/whatsapp/step-2-whatsapp-number-configuration.png" />
    </Frame>

    **Required Information:**

    * **Business Number**: Enter your WhatsApp Business phone number with country code
    * **API Key**: Provide your WhatsApp Business API key for authentication
    * **About**: Brief description of the business
    * **Description**: Detailed description of the business purpose
    * **Company Name**: Your organization name
    * **Business Vertical**: Select your industry category
    * **Profile Picture**: Upload your business profile picture

    Click `Save` to add the Business Number to your account.
  </Step>

  <Step title="Business Number added" icon="check">
    Once successfully added, your Business Number appears in the WhatsApp numbers
    table.

    <Frame>
      <img src="https://mintcdn.com/tars-c52ebe98/pzfXZlbe5u4r3EET/images/dashboard/account/whatsapp/step-3-added-WB-number.png?fit=max&auto=format&n=pzfXZlbe5u4r3EET&q=85&s=f3c54b9020920cf204ae7621be9150e9" alt="WhatsApp Numbers table showing added Business Number" width="1964" height="981" data-path="images/dashboard/account/whatsapp/step-3-added-WB-number.png" />
    </Frame>

    **Table Structure:** - **Business Number**: Shows your added WhatsApp number -
    **Agent**: Displays "Connect Agent" button for Agent assignment - **Actions**:
    Gear icon for additional options
    <Check>Your Business number is now ready for Agent connection.</Check>
  </Step>

  <Step title="Connect Agent" icon="link">
    Click the `Connect Agent` button to assign an AI Agent to your WhatsApp
    number.

    <Frame>
      <img src="https://mintcdn.com/tars-c52ebe98/pzfXZlbe5u4r3EET/images/dashboard/account/whatsapp/step-4-click-connect-agent.png?fit=max&auto=format&n=pzfXZlbe5u4r3EET&q=85&s=65efddb1a1ab1592484d4d6648ec718b" alt="Connect Agent button highlighted in the table" width="1964" height="981" data-path="images/dashboard/account/whatsapp/step-4-click-connect-agent.png" />
    </Frame>

    This opens the Agent selection modal where you can choose from your created
    agents.
  </Step>

  <Step title="Select and connect Agent" icon="robot">
    In the Agent selection modal, choose the Agent you want to connect to your
    WhatsApp number.

    <Frame>
      <img src="https://mintcdn.com/tars-c52ebe98/pzfXZlbe5u4r3EET/images/dashboard/account/whatsapp/step-5-select-agent-and-connect-Agent.png?fit=max&auto=format&n=pzfXZlbe5u4r3EET&q=85&s=2354b09f1b593ceaf06ebc45479dfd6f" alt="Agent selection modal with available agents" width="1964" height="981" data-path="images/dashboard/account/whatsapp/step-5-select-agent-and-connect-Agent.png" />
    </Frame>

    **Agent Selection:** - Browse through all your created agents - Use the search
    bar to find specific agents - Select the desired Agent (highlighted with
    purple border and checkmark) - Click `Connect Agent` to complete the
    connection

    <Info>
      **Agent Assignment**: The selected Agent will handle all conversations for
      this WhatsApp number.
    </Info>
  </Step>

  <Step title="Agent connected successfully" icon="circle-check">
    Once connected, your Agent is now active on the WhatsApp number.

    <Frame>
      <img src="https://mintcdn.com/tars-c52ebe98/pzfXZlbe5u4r3EET/images/dashboard/account/whatsapp/step-6-agent-connected-to-whatapp-number.png?fit=max&auto=format&n=pzfXZlbe5u4r3EET&q=85&s=3d160b636443da49cc3fa9525bc55c62" alt="Agent successfully connected to WhatsApp number with success notification" width="1979" height="981" data-path="images/dashboard/account/whatsapp/step-6-agent-connected-to-whatapp-number.png" />
    </Frame>

    **Connection Confirmation:** - Agent name appears in the table under the
    "Agent" column - Success notification confirms the connection - Agent is now
    ready to handle WhatsApp conversations

    <Check>
      **Live Integration**: Customers can now message your WhatsApp number and
      interact with your AI Agent.
    </Check>
  </Step>

  <Step title="Disconnect Agent" icon="link-slash">
    To disconnect an Agent from your WhatsApp number, click the 'X' icon next to
    the Agent name.

    <Frame>
      <img src="https://mintcdn.com/tars-c52ebe98/pzfXZlbe5u4r3EET/images/dashboard/account/whatsapp/step-7-click-disconnect-agent-button.png?fit=max&auto=format&n=pzfXZlbe5u4r3EET&q=85&s=aa1bb2032a3d04fb35b1d214930f2622" alt="Disconnect Agent button with X icon highlighted" width="1964" height="981" data-path="images/dashboard/account/whatsapp/step-7-click-disconnect-agent-button.png" />
    </Frame>

    This opens a confirmation modal to ensure you want to remove the Agent
    connection.
  </Step>

  <Step title="Confirm agent removal" icon="trash">
    In the removal confirmation modal, review the action and confirm the
    disconnection.

    <Frame>
      <img src="https://mintcdn.com/tars-c52ebe98/pzfXZlbe5u4r3EET/images/dashboard/account/whatsapp/step-8-click-remove-agent.png?fit=max&auto=format&n=pzfXZlbe5u4r3EET&q=85&s=724bb9aa5cca8d3dcd58f5cf591ce902" alt="Remove Agent confirmation modal" width="1964" height="981" data-path="images/dashboard/account/whatsapp/step-8-click-remove-agent.png" />
    </Frame>

    **Removal Process:** - Review the confirmation message - Click `Remove Agent`
    to disconnect the Agent - The Agent will be disconnected from the WhatsApp
    number - You can now connect a different Agent if needed

    <Warning>
      **Agent Disconnection**: Once removed, the Agent will no longer respond to
      messages on this WhatsApp number.
    </Warning>
  </Step>

  <Step title="Manage WhatsApp number" icon="gear">
    Click the gear icon in the Actions column to access additional options for your WhatsApp number.

    <Frame>
      <img src="https://mintcdn.com/tars-c52ebe98/pzfXZlbe5u4r3EET/images/dashboard/account/whatsapp/step-9-whatsapp-number-quick-actions.png?fit=max&auto=format&n=pzfXZlbe5u4r3EET&q=85&s=a2f93234737f5f642487c4401f10a3e8" alt="Quick actions dropdown with Edit and Delete options" width="1964" height="981" data-path="images/dashboard/account/whatsapp/step-9-whatsapp-number-quick-actions.png" />
    </Frame>

    **Available actions:**

    * **Edit**: Modify Business number details, API key, and other configuration
    * **Delete**: Remove the WhatsApp number completely from your account

    <Info>
      **Edit functionality**: The edit option opens the same configuration modal where you can update all Business number details.
    </Info>
  </Step>
</Steps>

## Learn more

<CardGroup cols={2}>
  <Card title="WhatsApp integration" icon="whatsapp" href="/platform-fundamentals/how-tars-works#how-does-whatsapp-integration-work-in-tars%3F">
    Learn how WhatsApp integration works in Tars
  </Card>

  <Card title="Advanced settings" icon="sliders" href="/platform-fundamentals/platform-tour/settings/advanced">
    Customize additional platform preferences
  </Card>
</CardGroup>
