Automate now

Zalo OA and FreshChat Integration using HexaSync Platform – User Guide

By Beehexa Automation TeamPublished Updated

Overview

The Zalo OA and FreshChat Integration Solution is designed by the HexaSync Platform to synchronize messages between the Zalo Official Account (OA) and FreshChat. This solution facilitates communication, enabling FreshChat admins to manage Zalo messages efficiently

Task Description

Zalo OA and FreshChat Integration

[FRESHCHAT > ZALO] Message Sync​

freshchat to zalo message

[ZALO > FRESHCHAT] Message Sync​

zalo to freshchat message

Zalo OA

FreshChat

Message Sync

HexaSync Profile Task Template

AUTOMATE NOW

[ZALO > FRESHCHAT] Recent User > User​

zalo to freshchat user

Constraints

Data TypeConstraints
Texts (FreshChat > Zalo)– Text will be sent as an .txt file
– Zalo Users will receive a direct link to download the file
Media Files– Every media file will be uploaded to Zalo Cloud
– FreshChat or Zalo Users will receive a link to it
Document Files– Every document file will be uploaded to Zalo Cloud
– FreshChat or Zalo Users will receive a link to it
Stickers– Every document file will be uploaded to Zalo Cloud
– FreshChat or Zalo Users will receive a link to it
Emojis– Emojis (or icons) sent from Zalo will appear as characters on FreshChat
Links– Links or any data sent as links from Zalo to FreshChat will expire after 7 days due to Zalo Policy
– Link content preview will not be displayed on FreshChat
Reaction– When Zalo Users react to a message on Zalo, it will not be shown on FreshChat
Messages sent by OA– FreshChat Admin will not see any messages sent by OA to Zalo Users
– Zalo Users will see duplicate messages if both Zalo OA Admin and FreshChat Admin reply to the same sender with the same message
Zalo User Information– Zalo User Information such as Real name, Phone Number, Email, Browser or Using Device will not be synced due to Zalo Privacy Policy

Common Causes Of Errors

Error TypeDescriptionActions
Message errorCaused by message exceeds 2000 characters– Files should be sent one by one from FreshChat to ZaloText will be sent as an .txt file
– A file sent should not include other messages to avoid text exceeding 2000 characters
Error code -213 “User has not followed OA”Caused by the requirement of Zalo on users– Zalo Users need to open chat with OA by mobile at least one
– Recommended solution to avoid this error:
+ Set up an automatic response to Zalo Users on OA to redirect them to Mobile Zalo App
+ Encourage Zalo Users to start the first conversation with OA by scanning OA QR code via mobile
Error code -320 “Your app needs to connect with Zalo Business Account to use paid features”Caused by Zalo requirements on paid features (Zalo Announcement)Zalo OA and HexaSync App need to connect with Zalo Business Account to send active messages to Zalo Users
AppendixZalo Error Codes

Customization​

Filter Zalo OA Messages On FreshChat​

Installation Guide​

To set up for connecting Zalo and FreshChat, please provide us via email team@www.beehexa.com with the following information:

1. FreshChat

- App ID
- API Key

2. Zalo

- OA ID
- Authorization Code

3. HexaSync App

Register a HexaSync Profile at https://app.hexasync.com/

beehexa image 1

If you need help on how to get that information, please follow our guidance below:

Step-By-Step Setup

FreshChat​

Zalo OA​​

Note: You must be an OA Admin to grant access to Zalo OA

beehexa image 3

beehexa image 4

beehexa image 2

beehexa image