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. Setting up your Zalo OA requires completing a guided 5-step wizard in Fiko and manually registering your OAuth callback URL and webhook in the Zalo Developer Portal.

What you'll achieve

  • Connect your Zalo OA to Fiko using a guided 5-step setup wizard
  • 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 refresh after initial setup is complete

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. Connecting your OA requires credentials from the Zalo Developer Portal and manual webhook registration.

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 5-step wizard. Steps 3 and 4 require you to manually register URLs in the Zalo Developer Portal before continuing.

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

Provider Selection

Choose how you want to integrate your Zalo Official Account with Fiko.

  • Go to Settings → Channels → Zalo OA in your Fiko dashboard
  • Click "Add new channel"
  • Select your Zalo integration method and click "Complete & Continue"
3

Configuration

Enter the API credentials for your Zalo application. You will need to retrieve these from the Zalo Developer Portal.

  • Enter your ZALO_APP_ID
  • Enter your ZALO_APP_SECRET
  • Enter your ZALO_OA_ID
  • Click "Complete & Continue"
4

OAuth Callback Setup

Fiko will display an OAuth callback URL. You must manually register this URL in the Zalo Developer Portal before continuing.

  • Go to developers.zalo.me and select your application
  • Navigate to Official Account → Thiết lập chung (General settings)
  • Find the "Official Account Callback Url" field
  • Paste the callback URL shown in Fiko into that field and save

Do not click Continue in Fiko until you have saved the callback URL in the Zalo Developer Portal.

5

Webhook Setup

Fiko will display a webhook URL. You must manually configure this webhook in the Zalo Developer Portal and subscribe to the required events.

  • Go to developers.zalo.me and select your application
  • Navigate to Webhook settings
  • Paste the webhook URL shown in Fiko
  • Subscribe to the "Send message" and "Follow/Unfollow OA" events
  • Click "Verify" to confirm the webhook

Do not click Continue in Fiko until the webhook has been verified successfully in the Zalo Developer Portal.

6

Complete Setup

Return to Fiko and finalize the integration.

  • Click "Complete & Continue" in Fiko to finalize the channel
  • Your Zalo OA channel will appear in your channel list

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

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