Manage the chat prompts for a Business Account

This article walks you through the steps for managing the chat prompts for a Business Account using Business Messaging API.

Introduction

Chat prompts are interactive buttons displayed above the input box, designed to encourage user engagement. When users tap a chat prompt, the system automatically generates a corresponding question, helping users start conversations easily. Each Business Account can customize up to six chat prompts.

You can use Business Messaging API to customize chat prompts to guide users toward specific topics or actions. This feature improves user interaction, simplifies conversation initiation, and helps businesses drive meaningful engagement with their audience.

Prerequisites

• You've gained access to TikTok API for Business. See Get Started - Step by step workflow for details.
• To manage the chat prompts for a Business Account, you need relevant permissions. See API Reference to find out permissions required for endpoints (including the endpoints listed in the "Steps" section) and see Update app permissions to find out how to configure permissions.
• You have followed the steps in Authorization and Authentication to obtain a TikTok account access token and the Application specific unique ID for the Business Account.

Steps

To manage the chat prompts for a Business Account, follow these steps:

1. Enable the chat prompts setting using /business/message/auto_message/status/update/. - Set auto_message_type to CHAT_PROMPT and operation_status to ENABLE.

Note
For certain Registered Business Accounts with access to chat prompts, the chat prompt setting is enabled by default. To verify whether the Business Account has the chat prompt setting enabled by default, use /business/message/auto_message/get/ and set auto_message_type to CHAT_PROMPT.

2. Create one or more chat prompts for a Business Account using /business/message/auto_message/create/. - Set auto_message_type to CHAT_PROMPT and specify the chat_prompt object.

3. Verify the statuses of chat prompts using /business/message/auto_message/get/. - Set auto_message_type to CHAT_PROMPT and confirm that the audit_status of each chat prompt is APPROVED and operation_status is ENABLE.
   

   Note: If audit_status of a chat prompt is REVIEWING, you need to wait for some time before rechecking the review status. The exact waiting time may vary depending on the content and other factors, but normally ranges from a few seconds to 2-3 hours.

4. Handle potential issues. - If audit_status is REJECTED:

   1. Update the chat prompt using /business/message/auto_message/update/.
   2. Recheck the status with /business/message/auto_message/get/. - If operation_status is DISABLE: - Enable the chat prompt setting by following the instruction in Step 1.