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

# How to connect Zalo OA to ChatbotX

> Learn how to connect your Zalo Official Account to ChatbotX so you can automate messages and customer care.

Zalo Official Account, or Zalo OA, is an essential customer channel for businesses in Vietnam. By connecting your Zalo OA to **ChatbotX**, you can use AI Agents to automate customer care, send bulk messages, and manage all conversations from one central workspace.

## Prerequisites

Before you connect Zalo OA, make sure these requirements are met:

1. **Verified Zalo OA:** Your Zalo Official Account must be verified by Zalo and show the yellow badge.
2. **Admin access:** Your personal Zalo account must have **Admin** permission on the Official Account you want to connect.

## Connect Zalo OA

You can start the connection in either of these ways:

### Method 1: From the Create Inbox flow

<Steps>
  <Step title="Open Analytics and click + Create Inbox">
    In your ChatbotX workspace, choose **Analytics** from the left menu, then click the **+ Create Inbox** button.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-188.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=e1f8e754527c2f75c89f026c93a14194" alt="zalo_oa_navigate_to_analytics" width="2972" height="1807" data-path="images/image-188.png" />
    </Frame>
  </Step>

  <Step title="Select Zalo OA and click Continue">
    Select **Zalo OA** from the channel list in the modal, then click **Continue** to proceed to the authorization page.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/o2bLrybbCxir4zYI/images/zalo-select-channel.png?fit=max&auto=format&n=o2bLrybbCxir4zYI&q=85&s=c22277d3b21551e2fb533dc513a6e189" alt="Zalo Select Channel" width="2975" height="1817" data-path="images/zalo-select-channel.png" />
    </Frame>
  </Step>

  <Step title="Authenticate with Zalo">
    The system will redirect you to Zalo's authentication screen. Choose the Zalo Official Account you want to connect, review the access permissions, and click the confirmation button on Zalo to grant access.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-189.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=3ac25528f6147391b43cf8c20924a14e" alt="zalo_oa_authorization_popup" width="2972" height="1807" data-path="images/image-189.png" />
    </Frame>
  </Step>
</Steps>

### Method 2: From Channels management

<Steps>
  <Step title="Navigate to Channels settings">
    Go to **Settings** -> **Channels** from the left sidebar.
  </Step>

  <Step title="Connect Zalo OA">
    Find **Zalo OA** in the channel list and click **Connect**.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-187.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=7be8ca742d24fcd1b9c66af199f3d9af" alt="zalo_oa_navigate_to_channel_setup" width="2965" height="1091" data-path="images/image-187.png" />
    </Frame>
  </Step>

  <Step title="Authenticate with Zalo">
    The system will redirect you to Zalo's authentication screen. Choose the Zalo Official Account you want to connect, review the access permissions, and click the confirmation button on Zalo to grant access.

    <Frame>
      <img src="https://mintcdn.com/chatbotx/bk1D42eDWTivbgT_/images/image-189.png?fit=max&auto=format&n=bk1D42eDWTivbgT_&q=85&s=3ac25528f6147391b43cf8c20924a14e" alt="zalo_oa_authorization_popup" width="2972" height="1807" data-path="images/image-189.png" />
    </Frame>
  </Step>
</Steps>

## Return to ChatbotX

After the authentication succeeds, you will be redirected back to ChatbotX. There, the list of Zalo OA pages you authorized will appear.

Check the Zalo OA you just approved and confirm that the channel now appears in ChatbotX.

<Frame>
  <img src="https://mintcdn.com/chatbotx/BCpXmuL5zx15tIog/images/connect_zalo_dashboard_check.png?fit=max&auto=format&n=BCpXmuL5zx15tIog&q=85&s=54873a0814dbd316ccb77e55d72a648e" alt="Connect Zalo Dashboard Check" width="3084" height="1522" data-path="images/connect_zalo_dashboard_check.png" />
</Frame>

## Finalize and check

When the setup is complete, your Zalo OA will be active on the ChatbotX dashboard.

Go to **Channels** or **Inbox** to confirm that Zalo OA is connected. Then send a test message from a personal Zalo account to check whether the conversation arrives in ChatbotX.

The Zalo interface and most automation features are similar to channels like Messenger. That said, the current Zalo API does not support some UI elements, such as Buttons inside Cards or Quick Replies.

## Test your automation

Now that Zalo OA is connected, you can start automating conversations.

* **Option 1: Create a Flow**
  * Open **Flows** from the sidebar.
  * Build a simple welcome message.
  * Send a message to your Zalo OA from a personal Zalo account and check the reply.
* **Option 2: Set up an AI Agent**
  * Open **AI Agent** and configure the tone and knowledge base for the assistant.
  * Assign that AI Agent to your Zalo OA channel so it can answer incoming questions automatically.