[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7C4RY5YVZRRWV57C5YV1W3H":3,"skill-same:01M7C4RY5YVZRRWV57C5YV1W3H":87},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":14,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":29,"ownerDescription":6,"updatedAt":30,"install":31,"resources":44},"01M7C4RY5YVZRRWV57C5YV1W3H","tiktok-business-messaging",null,"Integrate with the TikTok Business API — OAuth, direct messages, conversations, media, comments, auto-messages (welcome\u002Fsuggested\u002Fchat prompts), video insights, comment-to-message direct replies, and webhook subscriptions for DIRECT_MESSAGE \u002F BRAND_MENTION \u002F VIDEO \u002F COMMENT events. Use when working with `business-api.tiktok.com\u002Fopen_api\u002Fv1.3\u002Fbusiness\u002F*` or `tt_user\u002Foauth2\u002F*` endpoints; building TikTok DM bots, inboxes, or comment automation for Business Accounts; handling `im_*`, `brand.mention.event`, `comment.update`, or `post.publish.*` webhooks; or when the user mentions TikTok Business Messaging, TikTok DMs, TikTok Business Account auth, brand mention webhooks, video insights, chat prompts, or `business_id`\u002F`open_id` tokens.","justomat\u002Fskills","justomat","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F5717479?v=4","01M7C4JXBF34DXN5D6B832ECXM","Geraldi Sutanto","01M7C4JXC22YGTKQ2MR10FNMDW",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: tiktok-business-messaging\ndescription: Integrate with the TikTok Business API — OAuth, direct messages, conversations, media, comments, auto-messages (welcome\u002Fsuggested\u002Fchat prompts), video insights, comment-to-message direct replies, and webhook subscriptions for DIRECT_MESSAGE \u002F BRAND_MENTION \u002F VIDEO \u002F COMMENT events. Use when working with `business-api.tiktok.com\u002Fopen_api\u002Fv1.3\u002Fbusiness\u002F*` or `tt_user\u002Foauth2\u002F*` endpoints; building TikTok DM bots, inboxes, or comment automation for Business Accounts; handling `im_*`, `brand.mention.event`, `comment.update`, or `post.publish.*` webhooks; or when the user mentions TikTok Business Messaging, TikTok DMs, TikTok Business Account auth, brand mention webhooks, video insights, chat prompts, or `business_id`\u002F`open_id` tokens.\n---\n\n# TikTok Business API\n\nQuick guide. The full OpenAPI 3.1 spec (every field, enum, example, \"Try-it-now\") lives at **\u003Chttps:\u002F\u002Ftiktok-business-api-docs.pages.dev\u002F>** — go there for exhaustive schemas. This file plus `references\u002F` covers gotchas, common workflows, and progressive lookup.\n\n## Quick start\n\nBase URL: `https:\u002F\u002Fbusiness-api.tiktok.com\u002Fopen_api\u002Fv1.3\u002F`\n\nAuth header on `\u002Fbusiness\u002F*` calls: `Access-Token: \u003Cshort-term token>`. Token valid **1 day**; refresh token valid **1 year**.\n\n1. Share the TikTok account holder authorization URL with the business; capture `code` from the redirect.\n2. `POST \u002Ftt_user\u002Foauth2\u002Ftoken\u002F` with `auth_code` (valid 10 min, single-use) → returns `access_token`, `refresh_token`, `open_id`.\n3. Use `open_id` as `business_id` on every `\u002Fbusiness\u002F*` call.\n4. `POST \u002Ftt_user\u002Foauth2\u002Frefresh_token\u002F` before the 1-day expiry.\n\nSend a text message:\n```bash\ncurl -X POST 'https:\u002F\u002Fbusiness-api.tiktok.com\u002Fopen_api\u002Fv1.3\u002Fbusiness\u002Fmessage\u002Fsend\u002F' \\\n  -H \"Access-Token: $ACCESS_TOKEN\" -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"business_id\":\"'\"$OPEN_ID\"'\",\"recipient_type\":\"CONVERSATION\",\"recipient\":\"'\"$CONV\"'\",\"message_type\":\"TEXT\",\"text\":{\"body\":\"Hi\"}}'\n```\n\n## Hard constraints (gotchas)\n\nThese are environment-specific facts that defy reasonable assumptions — read these before designing anything:\n\n- **Rate limit:** 10 QPS across Business Messaging endpoints. On error `40100`, back off.\n- **48-hour reply windows** (non-mutual follow conversations):\n  - After user's first message → up to **10** replies in 48 h.\n  - After each user reply → **unlimited** for 48 h.\n  - After 48 h of silence → only **3** more messages until they reply again.\n- **Cannot initiate** — never message a user who hasn't messaged the business first. The sole exception is `direct_reply` to high-intent comments (VN\u002FID\u002FTH accounts only).\n- **Message is text XOR image**, never both. Text body cap: 6,000 chars (incl. spaces\u002Femoji).\n- **`conversation_id` encoding:** URL-encode `+` as `%2B` in query strings, or you'll get *\"Param conversation_id is invalid\"*.\n- **EU\u002FEEA\u002FUK senders** trigger `im_receive_msg_eu` (not `im_receive_msg`). That payload omits sender, conversation_id, and content — you must poll `conversation\u002Flist\u002F` + `content\u002Flist\u002F` to retrieve the body.\n- **Webhook `content` is a stringified JSON** — always `JSON.parse(payload.content)`.\n- **Image download** requires header `x-user: \u003CAccess-Token>` when GETting the `download_url`.\n- **Big number IDs**: `comment.update` webhook serializes `comment_id`\u002F`video_id`\u002F`parent_comment_id` as bare numbers exceeding `Number.MAX_SAFE_INTEGER`. Use a BigInt reviver or `json-bigint` — naïve `JSON.parse` silently truncates.\n- **Expiry table:** access token 1 d · refresh token 1 y · auth code 10 min (single-use) · `media_id` 30 d · `download_url` 24 h · profile\u002Fsticker\u002FAI-emoji URLs per `x-expires` (typically 30 d).\n- **Pagination caps:** conversation list max 100 (past 90 days only). Message list max 20 most recent per conversation. Comment list returns dupes past the first 500.\n- **Comment-to-Message** only for Business Accounts in **VN\u002FID\u002FTH** replying to APAC\u002FLATAM\u002FMETAP accounts; five eligibility conditions must all hold per reply (see `references\u002Fdirect-reply.md`).\n\n## Common errors\n\n| Code | Meaning | Fix |\n|------|---------|-----|\n| 40001 | No permission | Check app scopes; re-authorize user if scopes changed |\n| 40002 | Param error | Read `message` for the field name |\n| 40007 | Object doesn't exist | Verify ID + URL path |\n| 40064 | DM blocked | Likely outside 48 h window or initiating cold conversation |\n| 40100 | Rate limited | Back off; respect 10 QPS |\n| 40105 | Bad\u002Fexpired access token | Refresh via `\u002Ftt_user\u002Foauth2\u002Frefresh_token\u002F` |\n| 40908 | Unsupported file type | JPG\u002FPNG only, ≤ 3 MB for image upload |\n| 51065 | System error | Retry with backoff; escalate if persistent |\n\n## Endpoint map & progressive disclosure\n\n26 endpoints across 9 categories. **Load only the reference file whose topic you're working on** — each lives in `references\u002F`:\n\n| Category | Load file | When |\n|---|---|---|\n| Authentication | `references\u002Fauthentication.md` | Implementing OAuth flow, refreshing tokens, or introspecting scopes (`\u002Ftt_user\u002Foauth2\u002F*`, `\u002Ftt_user\u002Ftoken_info\u002Fget\u002F`) |\n| Messages | `references\u002Fmessages.md` | Sending DMs (`\u002Fbusiness\u002Fmessage\u002Fsend\u002F`), templates, sender actions, or managing welcome \u002F suggested questions \u002F chat prompts (`\u002Fbusiness\u002Fmessage\u002Fauto_message\u002F*`) |\n| Conversations | `references\u002Fconversations.md` | Listing conversations or reading message history (`\u002Fbusiness\u002Fmessage\u002Fconversation\u002Flist\u002F`, `\u002Fcontent\u002Flist\u002F`) |\n| Media | `references\u002Fmedia.md` | Uploading or downloading images\u002Fvideo attachments (`\u002Fbusiness\u002Fmessage\u002Fmedia\u002Fupload\u002F`, `\u002Fdownload\u002F`, `\u002Fcapabilities\u002Fget\u002F`) |\n| Direct Reply | `references\u002Fdirect-reply.md` | Toggling Comment-to-Message or replying to a high-intent comment (`\u002Fbusiness\u002Fmessage\u002Fdirect_reply\u002F*`) |\n| Comments | `references\u002Fcomments.md` | Reading or replying to comments on owned videos (`\u002Fbusiness\u002Fcomment\u002F*`) |\n| Publish | `references\u002Fpublish.md` | Polling publish status (`\u002Fbusiness\u002Fpublish\u002Fstatus\u002F`) |\n| Videos | `references\u002Fvideos.md` | Listing posts and engagement insights (`\u002Fbusiness\u002Fvideo\u002Flist\u002F`) |\n| Webhooks | `references\u002Fwebhooks.md` | Creating, listing, or deleting webhook subscriptions (`\u002Fbusiness\u002Fwebhook\u002F*`) |\n| Webhook event payloads | `references\u002Fwebhook-events.md` | Implementing a callback handler, or you encounter any of: `im_*` event names, `brand.mention.event`, `comment.update`, `post.publish.*`, the `DIRECT_MESSAGE`\u002F`BRAND_MENTION`\u002F`VIDEO`\u002F`COMMENT` `event_type` values, or a webhook `content` JSON payload |\n\n**Canonical schema source:** \u003Chttps:\u002F\u002Ftiktok-business-api-docs.pages.dev\u002F> — full OpenAPI 3.1 spec with every field, enum, and example. Load when you need an exhaustive schema for a specific endpoint.\n\n## Workflows\n\n**Inbound DM → reply:**\n1. `DIRECT_MESSAGE` webhook fires. Handle both `im_receive_msg` and `im_receive_msg_eu` — see `references\u002Fwebhook-events.md` § EU\u002FEEA caveat (the EU variant is stripped; poll to retrieve content).\n2. Parse the envelope's `content` field (stringified JSON) to get `conversation_id`.\n3. `POST \u002Fbusiness\u002Fmessage\u002Fsend\u002F` with `recipient_type=CONVERSATION`, `recipient=\u003Cconversation_id>`.\n\n**Send an image:**\n1. `GET \u002Fbusiness\u002Fmessage\u002Fcapabilities\u002Fget\u002F` with `capability_types=[\"IMAGE_SEND\"]` for that conversation. Image sharing isn't available in all country pairs.\n2. `POST \u002Fbusiness\u002Fmessage\u002Fmedia\u002Fupload\u002F` (multipart, JPG\u002FPNG ≤ 3 MB) → `media_id` (valid 30 d).\n3. `POST \u002Fbusiness\u002Fmessage\u002Fsend\u002F` with `message_type=IMAGE`, `image.media_id=\u003Cmedia_id>`.\n\n**Reply to a high-intent comment (Comment-to-Message):**\n1. Verify `direct_reply\u002Fget\u002F` returns `operation_status=ENABLE`. If not, `direct_reply\u002Fupdate\u002F` to enable.\n2. From the `im_receive_high_intent_comment` webhook capture `comment_id`.\n3. `POST \u002Fbusiness\u002Fmessage\u002Fsend\u002F` with `direct_reply.reply_type=COMMENT_REPLY`, `comment_reply.comment_id=\u003Cid>`, `message_type=TEXT`.\n\n**Comment lifecycle webhook → fetch body:**\n1. `comment.update` webhook fires (within 5 min of any comment change) with `comment_id`, `video_id`, `comment_action`. **The body is NOT in the payload.**\n2. For `insert` events: `GET \u002Fbusiness\u002Fcomment\u002Flist\u002F?comment_ids=[\u003Ccomment_id>]` to fetch text\u002Fauthor\u002Flikes.\n3. For `delete` events: the comment is gone — the webhook is the only record.\n\n**Video publish lifecycle:**\n1. `POST \u002Fbusiness\u002Fvideo\u002Fpublish\u002F` returns `share_id`.\n2. Either poll `GET \u002Fbusiness\u002Fpublish\u002Fstatus\u002F?publish_id=\u003Cshare_id>` until terminal, **or** subscribe to the `VIDEO` webhook for the four-stage lifecycle (`post.publish.failed` \u002F `complete` \u002F `publicly_available` \u002F `no_longer_publicly_available`).\n3. `post_id` first appears in `post.publish.publicly_available` (or in `post_ids[]` on the polling endpoint when status flips to `PUBLISH_COMPLETE` — may take up to 3 min). Use it as `video_ids` filter in `\u002Fbusiness\u002Fvideo\u002Flist\u002F`.\n\n**Manage chat prompts (auto-messages):**\n1. `POST \u002Fbusiness\u002Fmessage\u002Fauto_message\u002Fstatus\u002Fupdate\u002F` with `CHAT_PROMPT` + `ENABLE`. **Destructive:** if any chat prompts already exist, enabling disables all of them.\n2. `POST \u002Fbusiness\u002Fmessage\u002Fauto_message\u002Fcreate\u002F` once per prompt (max 6). Wait for `audit_status=APPROVED` via `auto_message\u002Fget\u002F` (a few seconds to ~2–3 h).\n3. `POST \u002Fbusiness\u002Fmessage\u002Fauto_message\u002Fsort\u002F` to reorder — pass *all* prompt IDs in the desired order.\n\n## Permission scopes\n\nWebhook event types require specific user-granted scopes to remain valid. Check granted scopes via `POST \u002Ftt_user\u002Ftoken_info\u002Fget\u002F` (see `references\u002Fauthentication.md`):\n\n| Webhook | Scope required |\n|---|---|\n| `im_*` (DIRECT_MESSAGE) | Business Messaging permission |\n| `im_auto_message_*` | Additionally requires `message.list.read` |\n| `comment.update` (COMMENT) | `comment.list` |\n| `post.publish.*` (VIDEO) | TikTok Accounts > Business Content |\n| `brand.mention.event` | Mentions permission |\n","# TikTok Business API\n\nQuick guide. The full OpenAPI 3.1 spec (every field, enum, example, \"Try-it-now\") lives at **\u003Chttps:\u002F\u002Ftiktok-business-api-docs.pages.dev\u002F>** — go there for exhaustive schemas. This file plus `references\u002F` covers gotchas, common workflows, and progressive lookup.\n\n## Quick start\n\nBase URL: `https:\u002F\u002Fbusiness-api.tiktok.com\u002Fopen_api\u002Fv1.3\u002F`\n\nAuth header on `\u002Fbusiness\u002F*` calls: `Access-Token: \u003Cshort-term token>`. Token valid **1 day**; refresh token valid **1 year**.\n\n1. Share the TikTok account holder authorization URL with the business; capture `code` from the redirect.\n2. `POST \u002Ftt_user\u002Foauth2\u002Ftoken\u002F` with `auth_code` (valid 10 min, single-use) → returns `access_token`, `refresh_token`, `open_id`.\n3. Use `open_id` as `business_id` on every `\u002Fbusiness\u002F*` call.\n4. `POST \u002Ftt_user\u002Foauth2\u002Frefresh_token\u002F` before the 1-day expiry.\n\nSend a text message:\n```bash\ncurl -X POST 'https:\u002F\u002Fbusiness-api.tiktok.com\u002Fopen_api\u002Fv1.3\u002Fbusiness\u002Fmessage\u002Fsend\u002F' \\\n  -H \"Access-Token: $ACCESS_TOKEN\" -H 'Content-Type: application\u002Fjson' \\\n  -d '{\"business_id\":\"'\"$OPEN_ID\"'\",\"recipient_type\":\"CONVERSATION\",\"recipient\":\"'\"$CONV\"'\",\"message_type\":\"TEXT\",\"text\":{\"body\":\"Hi\"}}'\n```\n\n## Hard constraints (gotchas)\n\nThese are environment-specific facts that defy reasonable assumptions — read these before designing anything:\n\n- **Rate limit:** 10 QPS across Business Messaging endpoints. On error `40100`, back off.\n- **48-hour reply windows** (non-mutual follow conversations):\n  - After user's first message → up to **10** replies in 48 h.\n  - After each user reply → **unlimited** for 48 h.\n  - After 48 h of silence → only **3** more messages until they reply again.\n- **Cannot initiate** — never message a user who hasn't messaged the business first. The sole exception is `direct_reply` to high-intent comments (VN\u002FID\u002FTH accounts only).\n- **Message is text XOR image**, never both. Text body cap: 6,000 chars (incl. spaces\u002Femoji).\n- **`conversation_id` encoding:** URL-encode `+` as `%2B` in query strings, or you'll get *\"Param conversation_id is invalid\"*.\n- **EU\u002FEEA\u002FUK senders** trigger `im_receive_msg_eu` (not `im_receive_msg`). That payload omits sender, conversation_id, and content — you must poll `conversation\u002Flist\u002F` + `content\u002Flist\u002F` to retrieve the body.\n- **Webhook `content` is a stringified JSON** — always `JSON.parse(payload.content)`.\n- **Image download** requires header `x-user: \u003CAccess-Token>` when GETting the `download_url`.\n- **Big number IDs**: `comment.update` webhook serializes `comment_id`\u002F`video_id`\u002F`parent_comment_id` as bare numbers exceeding `Number.MAX_SAFE_INTEGER`. Use a BigInt reviver or `json-bigint` — naïve `JSON.parse` silently truncates.\n- **Expiry table:** access token 1 d · refresh token 1 y · auth code 10 min (single-use) · `media_id` 30 d · `download_url` 24 h · profile\u002Fsticker\u002FAI-emoji URLs per `x-expires` (typically 30 d).\n- **Pagination caps:** conversation list max 100 (past 90 days only). Message list max 20 most recent per conversation. Comment list returns dupes past the first 500.\n- **Comment-to-Message** only for Business Accounts in **VN\u002FID\u002FTH** replying to APAC\u002FLATAM\u002FMETAP accounts; five eligibility conditions must all hold per reply (see `references\u002Fdirect-reply.md`).\n\n## Common errors\n\n| Code | Meaning | Fix |\n|------|---------|-----|\n| 40001 | No permission | Check app scopes; re-authorize user if scopes changed |\n| 40002 | Param error | Read `message` for the field name |\n| 40007 | Object doesn't exist | Verify ID + URL path |\n| 40064 | DM blocked | Likely outside 48 h window or initiating cold conversation |\n| 40100 | Rate limited | Back off; respect 10 QPS |\n| 40105 | Bad\u002Fexpired access token | Refresh via `\u002Ftt_user\u002Foauth2\u002Frefresh_token\u002F` |\n| 40908 | Unsupported file type | JPG\u002FPNG only, ≤ 3 MB for image upload |\n| 51065 | System error | Retry with backoff; escalate if persistent |\n\n## Endpoint map & progressive disclosure\n\n26 endpoints across 9 categories. **Load only the reference file whose topic you're working on** — each lives in `references\u002F`:\n\n| Category | Load file | When |\n|---|---|---|\n| Authentication | `references\u002Fauthentication.md` | Implementing OAuth flow, refreshing tokens, or introspecting scopes (`\u002Ftt_user\u002Foauth2\u002F*`, `\u002Ftt_user\u002Ftoken_info\u002Fget\u002F`) |\n| Messages | `references\u002Fmessages.md` | Sending DMs (`\u002Fbusiness\u002Fmessage\u002Fsend\u002F`), templates, sender actions, or managing welcome \u002F suggested questions \u002F chat prompts (`\u002Fbusiness\u002Fmessage\u002Fauto_message\u002F*`) |\n| Conversations | `references\u002Fconversations.md` | Listing conversations or reading message history (`\u002Fbusiness\u002Fmessage\u002Fconversation\u002Flist\u002F`, `\u002Fcontent\u002Flist\u002F`) |\n| Media | `references\u002Fmedia.md` | Uploading or downloading images\u002Fvideo attachments (`\u002Fbusiness\u002Fmessage\u002Fmedia\u002Fupload\u002F`, `\u002Fdownload\u002F`, `\u002Fcapabilities\u002Fget\u002F`) |\n| Direct Reply | `references\u002Fdirect-reply.md` | Toggling Comment-to-Message or replying to a high-intent comment (`\u002Fbusiness\u002Fmessage\u002Fdirect_reply\u002F*`) |\n| Comments | `references\u002Fcomments.md` | Reading or replying to comments on owned videos (`\u002Fbusiness\u002Fcomment\u002F*`) |\n| Publish | `references\u002Fpublish.md` | Polling publish status (`\u002Fbusiness\u002Fpublish\u002Fstatus\u002F`) |\n| Videos | `references\u002Fvideos.md` | Listing posts and engagement insights (`\u002Fbusiness\u002Fvideo\u002Flist\u002F`) |\n| Webhooks | `references\u002Fwebhooks.md` | Creating, listing, or deleting webhook subscriptions (`\u002Fbusiness\u002Fwebhook\u002F*`) |\n| Webhook event payloads | `references\u002Fwebhook-events.md` | Implementing a callback handler, or you encounter any of: `im_*` event names, `brand.mention.event`, `comment.update`, `post.publish.*`, the `DIRECT_MESSAGE`\u002F`BRAND_MENTION`\u002F`VIDEO`\u002F`COMMENT` `event_type` values, or a webhook `content` JSON payload |\n\n**Canonical schema source:** \u003Chttps:\u002F\u002Ftiktok-business-api-docs.pages.dev\u002F> — full OpenAPI 3.1 spec with every field, enum, and example. Load when you need an exhaustive schema for a specific endpoint.\n\n## Workflows\n\n**Inbound DM → reply:**\n1. `DIRECT_MESSAGE` webhook fires. Handle both `im_receive_msg` and `im_receive_msg_eu` — see `references\u002Fwebhook-events.md` § EU\u002FEEA caveat (the EU variant is stripped; poll to retrieve content).\n2. Parse the envelope's `content` field (stringified JSON) to get `conversation_id`.\n3. `POST \u002Fbusiness\u002Fmessage\u002Fsend\u002F` with `recipient_type=CONVERSATION`, `recipient=\u003Cconversation_id>`.\n\n**Send an image:**\n1. `GET \u002Fbusiness\u002Fmessage\u002Fcapabilities\u002Fget\u002F` with `capability_types=[\"IMAGE_SEND\"]` for that conversation. Image sharing isn't available in all country pairs.\n2. `POST \u002Fbusiness\u002Fmessage\u002Fmedia\u002Fupload\u002F` (multipart, JPG\u002FPNG ≤ 3 MB) → `media_id` (valid 30 d).\n3. `POST \u002Fbusiness\u002Fmessage\u002Fsend\u002F` with `message_type=IMAGE`, `image.media_id=\u003Cmedia_id>`.\n\n**Reply to a high-intent comment (Comment-to-Message):**\n1. Verify `direct_reply\u002Fget\u002F` returns `operation_status=ENABLE`. If not, `direct_reply\u002Fupdate\u002F` to enable.\n2. From the `im_receive_high_intent_comment` webhook capture `comment_id`.\n3. `POST \u002Fbusiness\u002Fmessage\u002Fsend\u002F` with `direct_reply.reply_type=COMMENT_REPLY`, `comment_reply.comment_id=\u003Cid>`, `message_type=TEXT`.\n\n**Comment lifecycle webhook → fetch body:**\n1. `comment.update` webhook fires (within 5 min of any comment change) with `comment_id`, `video_id`, `comment_action`. **The body is NOT in the payload.**\n2. For `insert` events: `GET \u002Fbusiness\u002Fcomment\u002Flist\u002F?comment_ids=[\u003Ccomment_id>]` to fetch text\u002Fauthor\u002Flikes.\n3. For `delete` events: the comment is gone — the webhook is the only record.\n\n**Video publish lifecycle:**\n1. `POST \u002Fbusiness\u002Fvideo\u002Fpublish\u002F` returns `share_id`.\n2. Either poll `GET \u002Fbusiness\u002Fpublish\u002Fstatus\u002F?publish_id=\u003Cshare_id>` until terminal, **or** subscribe to the `VIDEO` webhook for the four-stage lifecycle (`post.publish.failed` \u002F `complete` \u002F `publicly_available` \u002F `no_longer_publicly_available`).\n3. `post_id` first appears in `post.publish.publicly_available` (or in `post_ids[]` on the polling endpoint when status flips to `PUBLISH_COMPLETE` — may take up to 3 min). Use it as `video_ids` filter in `\u002Fbusiness\u002Fvideo\u002Flist\u002F`.\n\n**Manage chat prompts (auto-messages):**\n1. `POST \u002Fbusiness\u002Fmessage\u002Fauto_message\u002Fstatus\u002Fupdate\u002F` with `CHAT_PROMPT` + `ENABLE`. **Destructive:** if any chat prompts already exist, enabling disables all of them.\n2. `POST \u002Fbusiness\u002Fmessage\u002Fauto_message\u002Fcreate\u002F` once per prompt (max 6). Wait for `audit_status=APPROVED` via `auto_message\u002Fget\u002F` (a few seconds to ~2–3 h).\n3. `POST \u002Fbusiness\u002Fmessage\u002Fauto_message\u002Fsort\u002F` to reorder — pass *all* prompt IDs in the desired order.\n\n## Permission scopes\n\nWebhook event types require specific user-granted scopes to remain valid. Check granted scopes via `POST \u002Ftt_user\u002Ftoken_info\u002Fget\u002F` (see `references\u002Fauthentication.md`):\n\n| Webhook | Scope required |\n|---|---|\n| `im_*` (DIRECT_MESSAGE) | Business Messaging permission |\n| `im_auto_message_*` | Additionally requires `message.list.read` |\n| `comment.update` (COMMENT) | `comment.list` |\n| `post.publish.*` (VIDEO) | TikTok Accounts > Business Content |\n| `brand.mention.event` | Mentions permission |\n",{"name":5,"description":7},"main","a6f90ec38e9b42294e23113714ec6af42cf6e808","skills\u002Ftiktok-business-messaging","https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills","https:\u002F\u002Fgithub.com\u002Fjustomat","geraldisutanto.com","2026-09-05 18:46:25",{"source":8,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add justomat\u002Fskills --skill tiktok-business-messaging",{"tool":37,"command":38},"bunx","bunx skills add justomat\u002Fskills --skill tiktok-business-messaging",{"tool":40,"command":41},"pnpm","pnpm dlx skills add justomat\u002Fskills --skill tiktok-business-messaging","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002FSKILL.md",true,[45,51,55,59,63,67,71,75,79,83],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"references\u002Fauthentication.md","REFERENCE","参考文档",3033,"https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002Freferences\u002Fauthentication.md",{"path":52,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":53,"sourceHtmlUrl":54},"references\u002Fcomments.md",5014,"https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002Freferences\u002Fcomments.md",{"path":56,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":57,"sourceHtmlUrl":58},"references\u002Fconversations.md",2561,"https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002Freferences\u002Fconversations.md",{"path":60,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":61,"sourceHtmlUrl":62},"references\u002Fdirect-reply.md",2158,"https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002Freferences\u002Fdirect-reply.md",{"path":64,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":65,"sourceHtmlUrl":66},"references\u002Fmedia.md",1462,"https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002Freferences\u002Fmedia.md",{"path":68,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":69,"sourceHtmlUrl":70},"references\u002Fmessages.md",5861,"https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002Freferences\u002Fmessages.md",{"path":72,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":73,"sourceHtmlUrl":74},"references\u002Fpublish.md",1792,"https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002Freferences\u002Fpublish.md",{"path":76,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":77,"sourceHtmlUrl":78},"references\u002Fvideos.md",3401,"https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002Freferences\u002Fvideos.md",{"path":80,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":81,"sourceHtmlUrl":82},"references\u002Fwebhook-events.md",18955,"https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002Freferences\u002Fwebhook-events.md",{"path":84,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":85,"sourceHtmlUrl":86},"references\u002Fwebhooks.md",2006,"https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftiktok-business-messaging\u002Freferences\u002Fwebhooks.md",[88,95,102,109,116,123],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7C4S80V7Q4P36QJS6GFWKC9","why","Use for 'why does X work this way', 'why we picked Y', design rationale, regressions, postmortems, or data-backed thresholds. Discovers available MCPs and queries each evidence category (source control, issue tracker, long-form docs, real-time chat, infrastructure observability, error tracking, product analytics warehouse) in parallel, then returns a cited read on decisions and tradeoffs. Use how for runtime behavior.","https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fwhy\u002FSKILL.md",[],[],{"skillNo":96,"name":97,"nameZh":6,"description":98,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":19},"01M7C4S670Q0Q52NNB1YGJARYN","unslop","Cut AI tells from any writing. Must always apply.","https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Funslop\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":106,"categories":107,"keywords":108,"publishedAt":19},"01M7C4S3Y49X2D3TXN0TDG75XD","typescript-best-practices","TypeScript best practices. Use when reading or editing any .ts or .tsx file.","https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftypescript-best-practices\u002FSKILL.md",[],[],{"skillNo":110,"name":111,"nameZh":6,"description":112,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":113,"categories":114,"keywords":115,"publishedAt":19},"01M7C4RTK2SZWHG8X5WV9EB4FK","technical-writing","Layered technical-writing standard: Diátaxis structure, Google developer style sentences, STE instruction rules, Global English syntax. Use for \u002Ftechnical-writing or when writing or reviewing docs, RFCs, readmes, PR descriptions, or commit messages.","https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftechnical-writing\u002FSKILL.md",[],[],{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":19},"01M7C4RQW73FREMTCW55AK25AB","teach","Explain a body of work plainly so a person actually understands it. Runs the `how` and `why` skills and weaves what they find into one clear explanation. Use for 'teach me this', 'help me really understand X', 'explain this change or subsystem to me'.","https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Fteach\u002FSKILL.md",[],[],{"skillNo":124,"name":125,"nameZh":6,"description":126,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":127,"categories":128,"keywords":129,"publishedAt":19},"01M7C4RNRE4E8S5ZVX8JKYRE45","tdd","Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions \"red-green-refactor\", or wants integration tests.","https:\u002F\u002Fgithub.com\u002Fjustomat\u002Fskills\u002Fblob\u002Fmain\u002Fskills\u002Ftdd\u002FSKILL.md",[],[]]