Set post-publish WeChat notifications
set_publish_notifyOwner only. Control the three notifications this workspace sends after publishing, all WeChat service-account template messages sent only to people in the workspace and never to clients: auto_push sends each new live version to WeChat automatically, one personal link per person; include_me decides whether that automatic push also reaches whoever triggered the publish; unread_remind tells the author once when a page has been published for seven days without anyone opening it (once per page). Pass only the switches you want to change; the others keep their current value. With auto_push off you can still send a specific page with push_to_wechat; with it on, publishing already sends it — no need to call push_to_wechat as well (each person gets a version once; repeat calls are deduplicated automatically). People who have not followed the service account cannot receive these: the switch being on does not mean delivery — the receipt from push_to_wechat is what tells you. When YOU have no WeChat binding or have not followed the service account, the receipt includes a binding QR code (an image plus bind_qr_image_url): the user scans it in WeChat, which follows the service account and links that WeChat to the current account in one step. Never tell the user to “sign in by scanning in WeChat” — that creates a separate account. Calling it with no arguments only reports the current state and hands out the code when needed; when the user says they have scanned, call it again to confirm. For ONE page only, also pass proposal_id: auto_push then sets that page (true = notify for this page even when the workspace is off; false = do not notify for this page, neither people nor subscribers; null = follow the workspace again); proposal_id alone reports whether the page is notified. include_me and unread_remind are workspace-wide and cannot be combined with proposal_id. For a single small edit, leave the switches alone and pass quiet: true to publish_file / finalize_upload / publish_version. SUBSCRIBE CODES (for clients, managers or family — not workspace members): whenever proposal_id is passed, the result also carries that page’s subscribe code (an image plus subscribe_code.qr_image_url). One WeChat scan follows the service account and subscribes that person to the page, so new versions reach them as WeChat reminders. The default code is the same one as in the publish receipt; for a code with a note for one person add subscribe_code_label (such as “for Mr. Wang”; the same label returns the same code). Passing proposal_id + subscribe_code_label without auto_push only issues the code, without reading or changing switches, and needs editor rather than owner. Pages that are private, suspended or published without signing in get no code, and the result says why. SUBSCRIBER LIST (who subscribed to the page, shown by get_engagement_summary as one line per person with a row number, grouped by source code): revoke_subscribe_code (a code_id) revokes a code — scanning it no longer subscribes anyone, and everyone who subscribed through it is unsubscribed; remove_subscriber (a row number) removes one person. Both need proposal_id and editor rather than owner; passing only them (without auto_push / subscribe_code_label) only edits the list and issues no code. Confirm with the user which code or row before doing either. SUBSCRIBE TO A FOLDER (for weekly or daily issues — no new code for every issue): pass folder_id (optionally with subscribe_code_label) to get that folder’s subscribe code. One scan subscribes the person to the whole folder: any page in it getting a new version, or a new page being added, sends a reminder (at most one a day per subscription); pages marked internal do not notify. folder_id cannot be combined with proposal_id or the switches; folders visible only to you get no code.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auto_push | No | Push each new live version to WeChat automatically; with proposal_id it changes this page only, and null returns the page to the workspace setting | |
| folder_id | No | 拿某个文件夹的订阅码时传（`list_folders` 里的 folder_id）：扫了订上整个文件夹，夹里有新版本或新的一页都提醒。不能和 proposal_id / 开关一起传 | |
| include_me | No | 自动推送也发给触发发布的那个人本人 | |
| proposal_id | No | 只管这一页时传（`list_proposals` 里的 proposal_id）：看 / 改这一页的提醒，并附上这一页的订阅码；不传 = 改整个工作区 | |
| unread_remind | No | 发布七天没人打开时提醒作者一次 | |
| remove_subscriber | No | Remove one person from the subscriber list (row number, from the subscriber list in get_engagement_summary); future updates of this page will not remind them. Requires proposal_id; confirm with the user first | |
| subscribe_code_label | No | 订阅码的备注（≤ 20 字，如「给王总」），只有作者自己看得到；不传 = 这一页的默认码。需要同时传 proposal_id | |
| revoke_subscribe_code | No | Revoke one of this page’s subscribe codes (code_id, from the subscriber list in get_engagement_summary): scanning it no longer subscribes anyone, and everyone who subscribed through it is unsubscribed. Requires proposal_id; confirm with the user first |