Zalo Connector

Connect your agent to Zalo for Official Account messaging and support workflows using the @elizaos/plugin-zalo package.

A personal-account variant is also available as @elizaos/plugin-zalouser.

Prerequisites

Package Info

Setup

1. Create a Zalo Official Account

1. Go to the Zalo Developers portal
2. Create an application and obtain your App ID and App Secret
3. Generate an access token and refresh token for API access

2. Configure Eliza

Install the plugin from the registry:

eliza plugins install zalo

Configure in ~/.eliza/eliza.json:

{
  "connectors": {
    "zalo": {
      "accessToken": "YOUR_ACCESS_TOKEN",
      "secretKey": "YOUR_SECRET_KEY",
      "refreshToken": "YOUR_REFRESH_TOKEN",
      "appId": "YOUR_APP_ID"
    }
  }
}

Or via environment variables:

export ZALO_ACCESS_TOKEN=YOUR_ACCESS_TOKEN
export ZALO_SECRET_KEY=YOUR_SECRET_KEY
export ZALO_REFRESH_TOKEN=YOUR_REFRESH_TOKEN
export ZALO_APP_ID=YOUR_APP_ID

Environment Variables

Configuration Reference

Features

• Official Account messaging and support workflows
• Webhook-based message handling
• Polling mode as alternative to webhooks
• Customer interaction management
• Token refresh support

Zalo User (Personal Account)

A separate connector, @elizaos/plugin-zalouser, provides personal Zalo account messaging (as opposed to Official Account). Install it with:

eliza plugins install zalouser

Package Info

Configuration

{
  "connectors": {
    "zalouser": {
      "enabled": true
    }
  }
}

Environment Variables

Features

• Official Account messaging and support workflows
• Webhook-based message handling
• Customer interaction management

Related

• Zalo Plugin Reference
• Connectors overview