Skip to main content
Zalo is Vietnam’s most popular messaging app with over 70 million monthly users. profClaw supports the Zalo Official Account (OA) API for business bot interactions.

​
Capabilities

FeatureSupported
1:1 messagesYes
Group messagesLimited
Rich textYes
Image messagesYes
Button templatesYes
WebhookYes

​
Setup

1

Create a Zalo Developer account

Register at developers.zalo.me.
2

Create an Official Account App

Create a new app and link it to a Zalo Official Account (OA). You need a verified business OA.
3

Get credentials

  • App ID
  • App Secret
  • OA Access Token (from OA Management)
4

Configure webhook

In Zalo Developer Portal, set webhook URL: https://your-domain.com/webhooks/zalo
5

Configure profClaw

ZALO_APP_ID=your-app-id
ZALO_APP_SECRET=your-app-secret
ZALO_OA_ACCESS_TOKEN=your-oa-access-token

​
Environment Variables

​
ZALO_APP_ID
string
required
Zalo Developer App ID.
​
ZALO_APP_SECRET
string
required
Zalo Developer App Secret.
​
ZALO_OA_ACCESS_TOKEN
string
required
Zalo Official Account access token.

​
Configuration Example

ZALO_APP_ID=1234567890
ZALO_APP_SECRET=abcdef...
ZALO_OA_ACCESS_TOKEN=your-oa-token

​
Zalo Personal (Beta)

profClaw also includes experimental support for Zalo personal accounts via the zalo-personal provider. This uses unofficial APIs and may break with Zalo updates. 
ZALO_PERSONAL_COOKIE=...
The zalo-personal provider uses unofficial APIs. Use the official OA API (zalo) for production.

​
Notes

  • Status: Beta
  • Zalo requires a Vietnamese business entity for full OA verification.
  • OA access tokens expire and need periodic refresh.
  • Zalo messages support Vietnamese text natively.
  • The Zalo OA API has rate limits of 2000 messages/minute.
  • Chat Providers Overview - Compare all 27 supported channels
  • LINE - Dominant messaging platform in Japan and Taiwan
  • Viber - Popular messaging app in Southeast Asia and Eastern Europe
  • profclaw channels - Enable and test the Zalo connection from the CLI