Zalo

Connect profClaw to Zalo via the Zalo Official Account API. The leading messaging platform in Vietnam.

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

Feature	Supported
1:1 messages	Yes
Group messages	Limited
Rich text	Yes
Image messages	Yes
Button templates	Yes
Webhook	Yes

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

.env

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

settings.yml

chat:
  zalo:
    app_id: "${ZALO_APP_ID}"
    app_secret: "${ZALO_APP_SECRET}"
    oa_access_token: "${ZALO_OA_ACCESS_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.

Related

• 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