Zalo User Plugin

The Zalo User plugin connects Eliza agents to Zalo via a personal account, enabling one-to-one and group messaging outside the Official Account API.

Package: @elizaos/plugin-zalouser

Installation

bash

eliza plugins install zalouser

The Zalo User connector authenticates with a device IMEI and session cookie from your personal Zalo account.

Set environment variables:

bash

export ZALOUSER_IMEI=YOUR_DEVICE_IMEI
export ZALOUSER_COOKIE_PATH=/path/to/cookie

Or enable the connector in eliza.json:

json

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

Variable	Description
`ZALOUSER_IMEI`	Device IMEI identifier (required)
`ZALOUSER_PROFILES`	Profile configuration
`ZALOUSER_DEFAULT_PROFILE`	Default profile to use
`ZALOUSER_COOKIE_PATH`	Path to session cookie file
`ZALOUSER_USER_AGENT`	User agent string for requests
`ZALOUSER_DM_POLICY`	DM policy (`allow`, `deny`, `allowlist`)
`ZALOUSER_GROUP_POLICY`	Group message policy (`allow`, `deny`)
`ZALOUSER_ALLOWED_THREADS`	Comma-separated list of allowed thread IDs
`ZALOUSER_LISTEN_TIMEOUT`	Timeout for listening to events
`ZALOUSER_ENABLED`	Enable or disable the connector