wecom-send-template-card

Generates structured WeCom template card JSON for notifications, votes, and interactive selections.

287|46|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/YanHaidao/wecom --skill wecom-send-template-card-yanhaidao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wecom-send-template-card
Source: https://github.com/YanHaidao/wecom/tree/main/skills/wecom-send-template-card
Command: npx skills add https://github.com/YanHaidao/wecom --skill wecom-send-template-card-yanhaidao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Sending structured, interactive messages through WeCom (Enterprise WeChat) requires building card payloads that strictly conform to Tencent's template card JSON Schema, which is error-prone when done by hand. This Skill guides the AI to emit a valid card JSON block in its reply, which the wecom plugin automatically extracts and sends. ## Core Features & Use Cases - Five card types: text_notice and news_notice for one-way notifications, plus button_interaction, vote_interaction, and multiple_interaction for user actions like approvals, polls, and multi-dimension selections. - Schema-grounded generation: All fields, nesting, and enums must match the JSON Schema in references/api-template-card-types.md, with a decision flowchart and required-field cheat sheet to pick the right card type. - Simplified vote and selector formats: vote_interaction and multiple_interaction use simplified fields (options, selectors) that the plugin code converts to the official API format automatically. - Use Case: A user says "ask the team whether they prefer plan A or plan B" — the Skill produces a button_interaction card with two styled buttons and a unique task_id, sent directly in the wecom channel. ## Quick Start Ask the assistant to send a WeCom template card, for example: send a vote card asking the team to choose between hiking, dinner, and escape room for the team-building event.

Frequently Asked Questions about wecom-send-template-card

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send an interactive template card in WeCom?

Output a json code block in your reply containing a card payload with card_type, task_id, and the required fields for that type. The wecom plugin automatically extracts the block and sends it; do not call wecom-cli or other tools to send cards.

Which WeCom card type should I use for a poll or vote?

Use vote_interaction when users pick one or more options for a single question and submit together. Use button_interaction for a few immediate action buttons like approve or reject, and multiple_interaction when several independent questions each need one selection.

What fields are required for a WeCom template card?

Every card requires card_type and a task_id formatted as task_{scenario}_{timestamp}. text_notice also needs card_action plus main_title or sub_title_text; button_interaction needs main_title and button_list; vote_interaction needs title and options; multiple_interaction needs title and selectors.

Can I use this card skill outside the wecom channel?

No, this Skill is limited to the wecom channel and requires the channels.wecom configuration. The card JSON is only extracted and sent by the wecom plugin's message pipeline.

Why does my WeCom card fail schema validation?

Validation fails when field names, enum values, or nesting deviate from the JSON Schema in references/api-template-card-types.md. Common mistakes include using API-native fields like checkbox or question_key in vote cards instead of the simplified options format, or omitting task_id.