Connects an agent to a Zalo Official Account. Users message the account on Zalo; the agent receives and replies within the same conversation.
- Supported agents: Chatbot
- Route type: Conversation
Before You Start
- Create an account at the Zalo Developer Portal (developers.zalo.me).
- Create a Zalo App and link it to your Official Account.
- In your app’s Application Management → Webhook section, note the App ID, App Secret, Official Account ID, and OA Secret Key.
- Register the redirect URL in the Zalo Developer Portal. The format is
<viewer-base-url>/api/v1/zalo/callback. If using an API gateway, enter its proxy URL instead.
Your agent must be published with an active version.
Configuration
Credentials
- App ID — The App ID from the Zalo Developer Portal. Required.
- App Secret — The App Secret from the Zalo Developer Portal. Required.
- Official Account ID — The ID of the linked Zalo Official Account. Required.
- OA Secret Key — Found in Application Management → Webhook in the Zalo portal. Used to validate incoming webhook signatures. Required.
- Redirect URL — The OAuth callback URL. Leave blank to use the default platform URL. Optional.
Route Settings
- Description — Optional label for this channel instance.
- Purpose — Optional note on when the agent should use this channel.
- Session Expiry (hours) — Idle timeout before a conversation session resets. Default: 4. Range: 0.01–48.
Connecting the Official Account
After you save the credential, click Zalo OAuth on the credential to open Zalo’s consent screen and grant the platform access to the Official Account. Sign in with the Official Account that matches the Official Account ID in the credential.
The consent link is valid for 30 minutes and can be used once. If it has expired or has already been used, reopen the credential and click Zalo OAuth again to get a new link.