You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit a7bce14
Browse filesBrowse the repository at this point in the historyBrowse files
authored
docs(zalo-personal): add dedicated account prerequisite warning (EN + ZH) (#138)
Zalo Personal requires a separate Zalo account from the one users will
use to talk to the COCO agent. Added warning box and updated prerequisites,
step text, and references throughout.
Co-authored-by: zylos <cocoai@cocoai-felix-lin-1b.asia-southeast1-b.c.coco-prd-476606.internal>
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Copy file name to clipboardExpand all lines: docs/getting-started/channel-deployment.md
+10-6Lines changed: 10 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1007,18 +1007,22 @@ One credential is required:
1007
1007
1008
1008
**Estimated time: ~2 minutes**
1009
1009
1010
-
> **Note:** Zalo Personal uses your real Zalo account via QR code scanning — no bot registration, API keys, or developer accounts needed. It connects through [zca-js](https://github.com/nicenathapong/zca-js), a reverse-engineered protocol library.
1010
+
> **Note:** Zalo Personal uses a real Zalo account via QR code scanning — no bot registration, API keys, or developer accounts needed. It connects through [zca-js](https://github.com/nicenathapong/zca-js), a reverse-engineered protocol library.
1011
1011
1012
1012
::: warning Unofficial Protocol
1013
1013
Zalo Personal uses an unofficial, reverse-engineered protocol (zca-js) that is **not endorsed by Zalo/VNG**. Your account could potentially be restricted or banned by Zalo. **Use at your own risk.** For an official integration, consider [Zalo Bot Platform](#zalo) instead.
1014
1014
:::
1015
1015
1016
+
::: warning Use a Dedicated Zalo Account
1017
+
Please use a **separate, dedicated Zalo account** for the bot — do **not** use the same Zalo account that users will use to talk to your COCO agent. The connected account becomes the bot's identity, so it must be a different account from any user who will interact with it.
1018
+
:::
1019
+
1016
1020
No credentials are required. Authentication is done entirely via QR code:
1017
1021
1018
1022
| Item | Description |
1019
1023
|------|-------------|
1020
1024
| COCO AI Employee | An existing instance in COCO Dashboard |
1021
-
| Zalo Account | A phone with Zalo installed and logged in |
1025
+
|Dedicated Zalo Account | A phone with Zalo installed and logged in to a **separate account** — not the same account users will use to message your COCO agent|
1022
1026
|~2 minutes | Time to complete deployment |
1023
1027
1024
1028
### Step 1: Click Connect on the Zalo Personal Card
@@ -1028,21 +1032,21 @@ No credentials are required. Authentication is done entirely via QR code:
1028
1032
3. Find the **Zalo Personal** card and click **Connect**
1029
1033
4. The system will generate a QR code — this may take a few seconds
1030
1034
1031
-
### Step 2: Scan the QR Code with Your Zalo App
1035
+
### Step 2: Scan the QR Code with Your Dedicated Zalo Account
1032
1036
1033
-
1. Open **Zalo** on your phone
1037
+
1. Open **Zalo** on the phone logged in to your **dedicated bot account** (not your personal account)
1034
1038
2. Tap the **QR code scanner** (usually in the top-right corner of the home screen or in the search bar)
1035
1039
3. Point your camera at the QR code displayed on the Dashboard
1036
1040
4. Confirm the login on your phone when prompted
1037
1041
1038
1042
### Step 3: Wait for Connection Confirmation
1039
1043
1040
1044
1. After scanning, the Dashboard automatically detects the connection — the Zalo Personal card shows **Connected**
1041
-
2. The connection is established through your personal Zalo account
1045
+
2. The connection is established through your dedicated Zalo account
1042
1046
1043
1047
### Step 4: Start Chatting
1044
1048
1045
-
1. Anyone who sends a message to your Zalo account will receive AI-powered responses
1049
+
1. Anyone who sends a message to your dedicated bot Zalo account will receive AI-powered responses
1046
1050
2. Deployment complete!
1047
1051
1048
1052
> **First message:** The first user to send a DM becomes the **Owner** (administrator). The owner always has full access regardless of policy settings.
0 commit comments