Zalo Plugin

The Zalo plugin connects Eliza agents to Zalo, enabling message handling through the Zalo Official Account API.

Package: @elizaos/plugin-zalo

Installation

bash

eliza plugins install @elizaos/plugin-zalo

Setup

1. Create a Zalo Official Account

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

2. Configure Eliza

json

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

Or via environment variables:

bash

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

Configuration

Field	Required	Description
`accessToken`	Yes	Zalo API access token
`secretKey`	Yes	Zalo application secret key
`appId`	No	Zalo application ID
`refreshToken`	No	Token refresh credential
`enabled`	No	Set `false` to disable (default: `true`)

Environment Variables

Variable	Required	Description
`ZALO_ACCESS_TOKEN`	Yes	Zalo API access token (primary auto-enable trigger)
`ZALO_SECRET_KEY`	Yes	Zalo application secret key
`ZALO_REFRESH_TOKEN`	No	Zalo API refresh token
`ZALO_APP_ID`	No	Zalo application ID
`ZALO_ENABLED`	No	Enable or disable the connector
`ZALO_PROXY_URL`	No	Proxy URL for API requests
`ZALO_USE_POLLING`	No	Use polling instead of webhooks
`ZALO_WEBHOOK_URL`	No	Webhook callback URL
`ZALO_WEBHOOK_PATH`	No	Webhook endpoint path
`ZALO_WEBHOOK_PORT`	No	Webhook listener port

Connectors Guide — General connector documentation

Installation

Setup

1. Create a Zalo Official Account

2. Configure Eliza

Configuration

Environment Variables

Related