---
title: "WeChat Bot: chat with a Digital Human in WeChat"
description: "Scan once with WeChat to chat with a Halo Digital Human in your personal WeChat, no WeCom account needed. Direct chats only, and no owner or guest roles."
type: "how-to"
audience: ["office"]
prerequisites: ["digital-humans/channels"]
related: ["digital-humans/channels", "digital-humans/wecom-bot", "digital-humans/feishu-bot", "troubleshooting/channels"]
lang: "en"
canonical: "https://hello-halo.cc/docs/en/digital-humans/personal-wechat.html"
last_updated: "2026-10-19T00:11:17+08:00"
source: "Halo 3.0.4 docs"
---
# WeChat Bot

Scan once with WeChat to chat with a Halo Digital Human in your personal WeChat, no WeCom account needed. Direct chats only, and no owner or guest roles.

You connect it yourself, by clicking in Halo and scanning with WeChat on your phone; Halo can't connect it for you.

## Before you start {#before-you-start}

- A personal WeChat account, with WeChat on your phone.
- A Digital Human that lives in a workspace; see [Create a Digital Human](https://hello-halo.cc/docs/en/digital-humans/create.html).
- Halo running. The bot doesn't reply while Halo is closed or the computer sleeps; see [Keep Digital Humans running](https://hello-halo.cc/docs/en/digital-humans/keep-running.html).

## How it differs from WeCom and Feishu bots {#compare}

- **Direct chats only**: it can't be added to groups.
- **No permission control**: everyone who can message it is treated as the owner and can have the Digital Human do anything. Connect it only for yourself, or for people you trust.
- **No replies that appear as they're written**: each reply is sent once it's done.

If you need group chats or owner and guest permissions, use the [WeCom Intelligent Bot](https://hello-halo.cc/docs/en/digital-humans/wecom-bot.html) or the [Feishu Bot](https://hello-halo.cc/docs/en/digital-humans/feishu-bot.html).

## Connect from the Digital Human {#connect}

1. Click **Digital Humans** on the left rail, open the Digital Human that should answer in WeChat, and switch to **Capabilities and settings**.
2. Under **Messages & Notifications › Bot Access**, click **Scan to add a bot › WeChat bot** to open "Add WeChat bot".
3. Scan the QR code with WeChat on your phone ("Scan with WeChat to connect") and confirm on the phone. The dialog shows "Waiting for confirmation...", then "Connecting...", and closes once connected; the bot then appears in the **Bot Access** list.
4. Send the bot a message in WeChat, and the Digital Human replies.

If the code expires, the dialog says "QR code expired"; click **Retry** for a new one (when connecting from Settings, the button is **Refresh**).

::: done
The Digital Human replied to your message in WeChat. Under **Settings › Message Channels**, the bot shows **Connected** and the WeChat Bot card header shows "1 connected".
:::

## Connect from Settings {#from-settings}

1. Open **Settings › Message Channels**, find **WeChat Bot** and click **Add Bot**.
2. In the new bot, click **Connect WeChat**, then scan with WeChat on your phone and confirm.
3. Pick a Digital Human under **Backend**.

![The WeChat Bot card in Settings: the new bot shows a QR code (blurred) and Scan with WeChat to connect, with Backend and Processing Notice below](https://hello-halo.cc/docs/images/digital-humans/personal-wechat/connect.en.webp)

## Disconnect {#disconnect}

Click **Disconnect** in the bot's card; the bot then shows **Disabled**. The Digital Human stops receiving WeChat messages, and the connection credentials are cleared, so you'll need to scan again next time.

## Limits {#limits}

- Direct chats only.
- One message holds up to 4,000 characters; longer replies are split into several messages.
- It receives images, voice (as WeChat's transcript), files and video, up to 25 MB per file.
- It can reply to, or message, only people who have messaged it recently. After Halo restarts, a person must message the bot first before the Digital Human can message them again.
- The WeChat sign-in expires. When it does, the bot stops and you need to scan to connect again.

The **Processing Notice** is on by default: if there's no reply within 5 seconds, it first sends "已收到，正在处理…" ("Received, working on it…").

## Troubleshooting {#troubleshooting}

### The bot shows "Not connected" or "Disabled"

- "Not connected": the WeChat sign-in expired. Click **Connect WeChat** and scan again.
- "Disabled": someone clicked **Disconnect**. Click **Connect WeChat** and scan again too.

### Messages the Digital Human sends on its own don't arrive

Halo has restarted, or the person has never messaged the bot. Ask them to send the bot a message first; after that, sending works again.

For more, see [Bot not replying](https://hello-halo.cc/docs/en/troubleshooting/channels.html).

## Next steps {#next-steps}

- [Message channels overview](https://hello-halo.cc/docs/en/digital-humans/channels.html): how the bots differ and how to use them.
- [WeCom Intelligent Bot](https://hello-halo.cc/docs/en/digital-humans/wecom-bot.html): use it when you need group chats and permission control.