Versions in this module Expand all Collapse all v1 v1.2.2 Oct 12, 2026 v1.2.1 Oct 6, 2026 v1.2.0 Sep 27, 2026 Changes in this version + var ErrMessageHandlerRequired = errx.New("message handler is required") type Client + func (c *Client) ReceiveMessages(ctx context.Context, handler func(context.Context, Message) error) error v1.1.0 Sep 27, 2026 v1.0.2 Sep 26, 2026 v1.0.1 Sep 24, 2026 Changes in this version + var ErrHTTPStatus = errx.New("unexpected http status") + var ErrInvalidURL = errx.New("invalid api url") + var ErrProtocol = errx.New("wechat protocol error") + var ErrQRCodeContentRequired = errx.New("qrcode content is required") + var ErrQRCodeRequired = errx.New("qrcode is required") + var ErrRequest = errx.New("wechat request failed") + var ErrSessionExpired = errx.New("wechat session expired") + var ErrTextRequired = errx.New("text is required") + var ErrTokenRequired = errx.New("bot token is required") + var ErrTooManyLocalTokens = errx.New("too many local tokens") + var ErrUserIDRequired = errx.New("user id is required") + var ErrWriterRequired = errx.New("writer is required") + func IsSessionExpired(err error) bool + type Client struct + func New(opts ...Option) *Client + func (c *Client) GetQRCode(ctx context.Context, request GetQRCodeRequest) (*GetQRCodeResponse, error) + func (c *Client) GetQRCodeStatus(ctx context.Context, request GetQRCodeStatusRequest) (*GetQRCodeStatusResponse, error) + func (c *Client) GetUpdates(ctx context.Context, request GetUpdatesRequest) (*GetUpdatesResponse, error) + func (c *Client) SendText(ctx context.Context, request SendTextRequest) (*SendTextResponse, error) + type GetQRCodeRequest struct + LocalTokens []string + type GetQRCodeResponse struct + QRCode string + QRCodeImageContent string + func (r GetQRCodeResponse) PrintQRCode() error + func (r GetQRCodeResponse) WriteQRCode(writer io.Writer) error + type GetQRCodeStatusRequest struct + BaseURL string + QRCode string + VerifyCode string + type GetQRCodeStatusResponse struct + BaseURL string + BotID string + BotToken string + RedirectHost string + Status QRCodeStatus + UserID string + func (r GetQRCodeStatusResponse) RedirectBaseURL() (string, error) + type GetUpdatesRequest struct + Cursor string + Timeout time.Duration + type GetUpdatesResponse struct + Cursor string + ErrorCode *int + ErrorMessage string + LongPollingTimeoutMS int64 + Messages []Message + Ret *int + func (r GetUpdatesResponse) LongPollingTimeout() time.Duration + func (r GetUpdatesResponse) NextCursor(current string) string + type Message struct + ClientID string + ContextToken string + CreateTimeMS int64 + DeleteTimeMS int64 + FromUserID string + GroupID string + Items []MessageItem + MessageID MessageID + RunID string + Sequence int64 + SessionID string + State MessageState + ToUserID string + Type MessageType + UpdateTimeMS int64 + type MessageID string + func (id *MessageID) UnmarshalJSON(data []byte) error + type MessageItem struct + Completed bool + CreateTimeMS int64 + MessageID MessageID + Text *TextItem + Type MessageItemType + UpdateTimeMS int64 + type MessageItemType int + const MessageItemTypeFile + const MessageItemTypeImage + const MessageItemTypeNone + const MessageItemTypeText + const MessageItemTypeToolCallResult + const MessageItemTypeToolCallStart + const MessageItemTypeVideo + const MessageItemTypeVoice + type MessageState int + const MessageStateFinished + const MessageStateGenerating + const MessageStateNew + type MessageType int + const MessageTypeBot + const MessageTypeNone + const MessageTypeUser + type Option func(*Client) + func WithBaseURL(u string) Option + func WithBotAgent(agent string) Option + func WithChannelVersion(version string) Option + func WithClient(cli *restx.Client) Option + func WithInsecureHTTP() Option + func WithLongPollTimeout(timeout time.Duration) Option + func WithRouteTag(routeTag string) Option + func WithTimeout(timeout time.Duration) Option + func WithToken(token string) Option + type QRCodeStatus string + const QRCodeStatusBoundRedirect + const QRCodeStatusConfirmed + const QRCodeStatusExpired + const QRCodeStatusNeedVerifyCode + const QRCodeStatusScanned + const QRCodeStatusScannedRedirect + const QRCodeStatusVerifyCodeBlocked + const QRCodeStatusWait + type SendTextRequest struct + ContextToken string + RunID string + Text string + ToUserID string + type SendTextResponse struct + ClientID string + ErrorMessage string + MessageID MessageID + Ret *int + type TextItem struct + Text string