User Guide · 07

Service Channel: Let Consumers Use via WeChat QR

This is a completely separate WeChat stack from §6.8 Admin Self-onboarding, dedicated to serving Consumers.

7.1 Enable Flow

  1. In Settings → Service Management, select (or create) a Service
  2. Switch to the WeChat Channel tab
  3. Configure:
    • Enable Switch
    • Expiration time (QR link validity)
    • Max sessions (upper limit of simultaneous connected WeChat users)
  4. Click Copy QR Link or open the /wc/{service_id} landing page directly

7.2 Consumer Scan Flow

  1. Consumer scans the /wc/{service_id} landing page QR with WeChat
  2. Landing page prompts user to follow iLink Bot in WeChat and send any message
  3. Backend session_manager waits for user's first message (captures from_user_id)
  4. Once captured, creates an independent conversation_id for that user
  5. Subsequent messages processed by Consumer Agent + replied via iLink

7.3 Consumer Experience

  • All received messages processed by Service's configured Consumer Agent
  • Agent only has permissions from Service capabilities + allowed_docs/scripts
  • Multimodal: supports send/receive images and voice
  • Friendly tool status: when Agent uses tools, shows "Thinking…" or whitelisted friendly text — doesn't expose real tool names

7.4 Session Management

In Service Management → WeChat Channel tab you can:

  • View active sessions: each WeChat user's recent activity time, message count
  • Disconnect session: actively disconnect a user
  • View conversation: enter a WeChat user's conversation history

7.5 Rate Limits

  • Per-user: 10 messages / 60 seconds
  • QR generation: 5 times / 60 seconds
  • Global: Service's configured max_sessions limit

7.6 Notes

  • iLink Bot (domestic) requires direct connection, no proxy
  • Multi-Admin isolation: each Service's sessions don't cross Admin boundaries
  • Sessions retained long-term (sessions with from_user_id don't participate in 24h idle cleanup)