Agent WeChatBot

A TypeScript CLI tool that enables AI agents and humans to send messages through WeChat Official Account API. Designed for customer engagement, template notifications, and CI/CD integrations using App ID + App Secret authentication.

Key Concepts

Before diving in, a few things about WeChat Official Account API:

• Send-only — The Official Account API delivers inbound messages via webhooks only. This CLI cannot list or read received messages.
• Customer service messages — You can send free-form text, image, and news (article) messages to users who have interacted with your account within the last 48 hours.
• Template messages — Pre-approved message templates can be sent at any time. Templates must be created and approved in the WeChat Official Account admin panel.
• App ID — Your Official Account's unique application identifier. Found in the WeChat Official Account admin panel under Development > Basic Configuration.
• App Secret — Your application's secret key, paired with the App ID. Found in the same location.
• OpenID — Each follower has a unique OpenID scoped to your Official Account. Use user list to retrieve follower OpenIDs.
• IP Whitelist — Your server IP must be added to the Official Account's IP whitelist, or API calls will fail with error 40164.
• Rate limits — WeChat enforces API call frequency limits. Customer service messages are limited per account per day.

Quick Start