Skip to content

Commit a7bce14

Browse files
FelixLin6zylosclaude
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>
1 parent 2397738 commit a7bce14

2 files changed

Lines changed: 20 additions & 12 deletions

File tree

‎docs/getting-started/channel-deployment.md‎

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1007,18 +1007,22 @@ One credential is required:
10071007

10081008
**Estimated time: ~2 minutes**
10091009

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.
10111011
10121012
::: warning Unofficial Protocol
10131013
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.
10141014
:::
10151015

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+
10161020
No credentials are required. Authentication is done entirely via QR code:
10171021

10181022
| Item | Description |
10191023
|------|-------------|
10201024
| 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 |
10221026
| ~2 minutes | Time to complete deployment |
10231027

10241028
### Step 1: Click Connect on the Zalo Personal Card
@@ -1028,21 +1032,21 @@ No credentials are required. Authentication is done entirely via QR code:
10281032
3. Find the **Zalo Personal** card and click **Connect**
10291033
4. The system will generate a QR code — this may take a few seconds
10301034

1031-
### Step 2: Scan the QR Code with Your Zalo App
1035+
### Step 2: Scan the QR Code with Your Dedicated Zalo Account
10321036

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)
10341038
2. Tap the **QR code scanner** (usually in the top-right corner of the home screen or in the search bar)
10351039
3. Point your camera at the QR code displayed on the Dashboard
10361040
4. Confirm the login on your phone when prompted
10371041

10381042
### Step 3: Wait for Connection Confirmation
10391043

10401044
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
10421046

10431047
### Step 4: Start Chatting
10441048

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
10461050
2. Deployment complete!
10471051

10481052
> **First message:** The first user to send a DM becomes the **Owner** (administrator). The owner always has full access regardless of policy settings.

‎docs/zh/getting-started/channel-deployment.md‎

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1137,18 +1137,22 @@ Bot 需要独立身份。只有使用专属号码,其他人才能把它当作
11371137

11381138
**预计耗时:约2分钟**
11391139

1140-
> **说明:** Zalo 个人版通过二维码扫描使用你的真实 Zalo 账号连接——无需注册 Bot、无需 API 密钥、无需开发者账号。它通过 [zca-js](https://github.com/nicenathapong/zca-js)(逆向工程协议库)实现连接。
1140+
> **说明:** Zalo 个人版通过二维码扫描使用真实 Zalo 账号连接——无需注册 Bot、无需 API 密钥、无需开发者账号。它通过 [zca-js](https://github.com/nicenathapong/zca-js)(逆向工程协议库)实现连接。
11411141
11421142
::: warning 非官方协议
11431143
Zalo 个人版使用的是非官方的逆向工程协议(zca-js),**未经 Zalo/VNG 官方认可**。你的账号可能会被 Zalo 限制或封禁。**使用风险自负。** 如需官方集成,请使用 [Zalo Bot Platform](#zalo)。
11441144
:::
11451145

1146+
::: warning 请使用专用 Zalo 账号
1147+
请使用一个**独立的、专门用于 Bot 的 Zalo 账号**——**不要**使用与 COCO agent 对话的用户相同的账号。连接的账号将成为 Bot 的身份,因此必须与任何要与其交互的用户账号不同。
1148+
:::
1149+
11461150
无需填写凭证。认证完全通过二维码完成:
11471151

11481152
| 所需项目 | 说明 |
11491153
|----------|------|
11501154
| COCO AI 员工 | COCO Dashboard 中已创建的实例 |
1151-
| Zalo 账号 | 一台已安装并登录 Zalo 的手机 |
1155+
| 专用 Zalo 账号 | 一台已安装并登录**独立账号**的手机——不能与用户联系 COCO agent 使用的账号相同 |
11521156
| 约2分钟 | 完成部署所需时间 |
11531157

11541158
### 第1步:点击 Zalo 个人版卡片的「连接」
@@ -1158,21 +1162,21 @@ Zalo 个人版使用的是非官方的逆向工程协议(zca-js),**未经
11581162
3. 找到 **Zalo 个人版** 卡片,点击 **连接**
11591163
4. 系统将生成二维码——可能需要几秒钟
11601164

1161-
### 第2步:使用 Zalo App 扫描二维码
1165+
### 第2步:使用专用 Zalo 账号扫描二维码
11621166

1163-
1. 打开手机上的 **Zalo**
1167+
1. 打开已登录**专用 Bot 账号**的手机上的 **Zalo**(不是你的个人账号)
11641168
2. 点击 **二维码扫描器**(通常在首页右上角或搜索栏中)
11651169
3. 将手机摄像头对准 Dashboard 上显示的二维码
11661170
4. 在手机上确认登录
11671171

11681172
### 第3步:等待连接确认
11691173

11701174
1. 扫码成功后,Dashboard 自动检测到连接——Zalo 个人版卡片显示为 **已连接(Connected)**
1171-
2. 连接已通过你的个人 Zalo 账号建立
1175+
2. 连接已通过你的专用 Zalo 账号建立
11721176

11731177
### 第4步:开始聊天
11741178

1175-
1. 任何给你 Zalo 账号发送消息的人都会收到 AI 自动回复
1179+
1. 任何给你的专用 Bot Zalo 账号发送消息的人都会收到 AI 自动回复
11761180
2. 部署完成!
11771181

11781182
> **首条消息:** 第一个发送私聊消息的用户将成为 **Owner**(管理员)。Owner 始终拥有完整访问权限,不受策略设置限制。

0 commit comments

Comments
 (0)