TikTok over API
This page explains how to set up API access for TikTok Business Messaging with Infobip. Before you begin, make sure you have completed the general TikTok setup.
To send and receive TikTok messages through the API, you need an API key and a configured webhook endpoint.
Prerequisites
Before you set up API access, make sure you have the following:
- A connected TikTok Business Account
- An HTTPS endpoint that can receive webhook requests
- It must be publicly accessible over HTTPS
- It must be able to respond with
HTTP 200to acknowledge receipt - It must be secured using the configured notification profile setting
Set up API access
To send TikTok messages programmatically, you need an API key with the required permissions.
- In the Infobip web interface (opens in a new tab), go to Developer Tools > API Keys.
- Select Create API key.
- Add a name and select the following API scopes:
tiktok:managesaas:tiktok-ads:manage
- Select Create to generate the API key.
Copy and store it securely because you will use it in the Authorization header when sending API requests (opens in a new tab).
Configure event subscriptions
To receive inbound messages as well as delivery and seen reports, you must create event subscriptions.
-
In the Infobip web interface (opens in a new tab), go to Developer Tools > Subscriptions.
-
Create a subscription for TikTok and select the following events:
- Delivery
- Inbound message
- Seen
-
During the notification profile creation step, enter your public HTTPS endpoint URL.
- Keep in mind the HTTPS endpoint requirements.
NOTEIf available, enter a secret key that you will use to verify webhook signatures/hashes.
While creating the notification profile, configure HMAC authentication under Security settings and add the secret key.
-
Save your TikTok event subscription.
Visit the API essentials and Subscriptions pages to explore key concepts and setup instructions.
Send and receive TikTok messages
Send your first message after completing the API setup.
TikTok message types
Review supported text, image, and share post formats.
Delivery and seen reports
Monitor delivery and seen events for outbound messages.