Skip to main content

Setup Zalo OA

Integrate your Zalo Official Account (OA) with Fiko to receive and reply to Zalo messages directly from your unified communication dashboard. Zalo is Vietnam's most popular messaging platform with over 75 million users.

Overview

Fiko integrates directly with Zalo using the official Zalo OA API. Connecting your Zalo OA takes just a few clicks — no developer portal setup or API configuration required.

What you'll achieve

  • Connect your Zalo OA to Fiko with one click
  • Authorize Fiko to send and receive messages on behalf of your OA
  • Start receiving and replying to Zalo messages in Fiko's unified inbox
  • Automatic token management — no manual setup required

About Zalo Official Accounts

Zalo Official Accounts (OA) are business profiles on the Zalo platform. They allow businesses to communicate with customers, send notifications, and provide customer support. Fiko handles all the technical setup — you just need to authorize your OA.

Prerequisites

  • A Zalo Official Account — Create one at oa.zalo.me
  • A Fiko account with admin access to your company
  • Your OA must be verified to use the messaging API in production
  • A paid OA tier package may be required to send outbound messages — check zalo.cloud/oa/pricing

Setup Process

Connecting your Zalo OA to Fiko is a simple 3-step process. No developer portal configuration, webhook setup, or API key management is needed — Fiko handles everything automatically.

1

Create a Zalo Official Account

If you don't already have a Zalo Official Account, create one first.

  • Go to oa.zalo.me
  • Click "Tạo OA" (Create OA) and follow the registration process
  • Fill in your business information and verify your account
  • Wait for Zalo to approve your OA (usually within a few hours)

If you already have a Zalo Official Account, skip this step and proceed to Step 2.

2

Connect Your OA in Fiko

Start the connection process from your Fiko dashboard.

  • Go to Settings → Channels → Zalo OA in your Fiko dashboard
  • Click "Add new channel"
  • Select the "Zalo OA API (Direct)" provider and click "Complete & Continue"
  • Click the "Connect to Zalo" button

A popup window will open with Zalo's authorization page where you can select and authorize your Official Account.

3

Authorize & Complete

Grant Fiko access to your Zalo Official Account.

  • On the Zalo authorization page, select the Official Account you want to connect
  • Check the terms and conditions checkbox to enable the authorization button
  • Click "Cấp quyền" (Grant permissions) to authorize Fiko
  • The popup will close automatically and you will be redirected to your channel list
  • Fiko creates the channel and configures everything automatically

Done! Your Zalo Official Account is now connected to Fiko. You can start receiving and replying to Zalo messages in your unified inbox.

Fiko automatically handles OAuth token exchange, webhook configuration, and token refresh. No manual API configuration is needed.

Token Refresh & Management

Zalo access tokens are short-lived and expire periodically. Fiko handles this automatically — no action is required on your part.

How it works

  • Fiko caches your access token and monitors its validity
  • When a token expires, Fiko automatically uses the refresh token to obtain a new pair
  • Both the new access token and refresh token are securely stored
  • This process is completely transparent — no manual intervention required

Important: If the refresh token becomes invalid (e.g., due to being revoked or unused for too long), you'll need to reconnect your OA by repeating the connection process from Settings → Channels → Zalo OA.

Troubleshooting

Messages not appearing in Fiko?

Ensure your OA is verified and has the required API permissions. Try disconnecting and reconnecting the channel from Settings → Channels → Zalo OA.

Authorization failed?

Make sure you're logged in to Zalo with the account that has admin access to the Official Account.

Cannot send messages?

Your OA may need a paid tier package to send messages via the API. Visit zalo.cloud/oa/pricing to check your OA's tier. Also ensure your OA is verified and has the required API permissions.

"Permission denied" error?

The OA administrator needs to complete the authorization. If you're not the admin, ask the OA owner to complete the connection process.

Token expired?

Fiko refreshes tokens automatically, but if the refresh token is also invalid, reconnect your OA from Settings → Channels → Zalo OA.

Need more help?

Return to the channels overview or contact support if you continue to experience issues.

Back to Channels
Setup Zalo OA — Zalo Integration