Skip to content

Bot not replying ​

When a Halo bot in WeCom, Feishu or WeChat doesn't reply, check in order: Halo running, connection, the bound Digital Human, Reply Scope, @mentions, owner.

Just tell Halo

My WeCom bot stopped replying. Can you check what's wrong?

Halo works through the official troubleshooting guide and asks you what you see, step by step. With Operate Halo on (+ › Capabilities in the message box), it can also check the bot's connection status itself and reconnect it if needed.

First: did "已收到,正在处理…" arrive? ​

The Processing Notice is on by default: if the Digital Human hasn't replied within 5 seconds, the bot first sends "已收到,正在处理…" ("Received, working on it…").

With Streaming on, the line appears right away inside the reply being written (WeCom shows "ℹ️ 已收到,正在处理…"). With the Processing Notice off and Streaming off, it isn't sent.

1. Halo is running and the computer is awake ​

Bots stay connected to the chat app through Halo. While Halo is closed, the computer sleeps or the network is down, the bot receives nothing. See Keep Digital Humans running.

Pause automatic tasks doesn't affect bots: a paused Digital Human still answers chat messages.

2. The bot is connected ​

Open Settings › Message Channels and check the bot's status:

StatusMeaningWhat to do
Connected (green dot)The connection worksKeep checking below
DisconnectedIt can't connectClick ⋮ › Reconnect at the top right of the bot; for one set up by hand, check the Bot ID and Secret, or the App ID and App Secret
Standby (WeCom)The same bot is in use on another computerTo use it here, click Use on this device
DisabledThe bot is switched offTurn on the switch at the top right of the bot; for a WeChat bot, click Connect WeChat and scan again
Not connected (WeChat)Most likely the WeChat sign-in expiredClick Connect WeChat and scan again
Connected · no messages received yet (Feishu)Connected, but no message has arrivedSee Feishu: no messages arrive

If a company network or proxy blocks WeCom's or Feishu's servers, the bot can't connect either; ask your network administrator.

3. The bot is bound to a Digital Human ​

Expand the bot and check Backend:

  • A Digital Human (or team member) must be picked. If it says "Binding unavailable", the previous Digital Human is gone; pick another.
  • Global Digital Humans (with no workspace) can't take a bot; pick one that lives in a workspace.
  • If the backend is a team member, that member must be on this computer and still in the team.

4. Reply Scope and @mentions ​

  • With Reply Scope set to Group chats only, direct messages are declined with "⚠️ This bot only responds in group chats. Please contact the bot administrator for access."; with Direct messages only, group messages get "⚠️ This bot only responds to direct messages.".
  • In groups, @mention the bot. WeCom forwards only messages that @mention it; Feishu's Require @mention in groups is on by default.
  • WeChat bots don't work in groups.

5. The bot has an owner ​

With Permission Control on and no owner yet, the bot does nothing in groups and only says "⚠️ This bot has no owner yet, so it cannot execute tasks." (at most once every 10 minutes per group). Message the bot directly once and you become its owner. See Owner and guest permissions.

The message arrived but there's no reply ​

  1. Open the Digital Human, switch to the IM sessions tab, find the contact, and check whether the message and a reply are in the conversation.
  2. If it's been replying for a long time without finishing, click Stop generation, then resend from the chat app; you can also send /stop in the chat.
  3. If it replies "The model returned an empty response. Please send your message again.", resend.
  4. If the Digital Human's AI model has a problem (an invalid key, used-up quota), it can't reply either. Chat with it in Halo to see, and look up the error in Error messages.

WeCom ​

  • One bot can be connected on only one computer at a time. When another computer takes it over, this one shows Standby; see The same bot on two computers.
  • "This bot is already in use by another instance. Each bot can only be bound to one digital human.": the bot is already connected through another entry; use that one, or delete it first.
  • More in WeCom Intelligent Bot.

Feishu ​

No messages arrive ​

When the card says "Connected · no messages received yet":

  • The app may still be waiting for your company administrator's approval; it receives messages only after that.
  • The person messaging it may be outside the app's availability.
  • Send it a direct message in Feishu to check; the note disappears as soon as one arrives.

Other cases ​

  • Your computer shows "Feishu bot cannot connect": check the App ID and App Secret, and that the app is published.
  • If the same Feishu app is connected on two computers, messages are split between them at random. Use each app on one computer only.
  • To receive group messages that don't @mention it, give the app the "all group messages" permission in the Feishu developer console, then turn off Require @mention in groups.

More in Feishu Bot.

WeChat ​

  • It shows Not connected: click Connect WeChat and scan again.
  • After Halo restarts, messages the Digital Human sends to someone don't arrive: ask that person to message the bot first.

More in WeChat Bot.

Done

You message the bot from the chat app and it replies; the conversation shows up in the Digital Human's IM sessions.

Next steps ​

基于 MIT 协议开源 · Open source under the MIT license