TikTok conversation events
TikTok conversation events enrich messaging exchanges between agents and users by surfacing real-time signals beyond message content. Supported events include typing indicators, read receipts, reply-to-message context, and reactions.
Events flow in two directions:
- Outbound (MT): Your system or agent sends an event to the TikTok user.
- Inbound (MO): A TikTok user sends an event that Infobip delivers to your webhook.
Conversation events require a completed TikTok Business Messaging setup, including configured webhook endpoints for inbound event delivery.
Outbound events (MT) [#outbound-events-mt]
Outbound events are actions that your system or an agent sends to a TikTok user during an active conversation. All outbound events require that the user has already initiated the conversation.
Typing indicator [#outbound-typing-indicator]
Send a typing indicator to signal to the TikTok user that an agent is composing a reply.
The typing indicator event follows the same pattern as the WhatsApp Send Events API.
Learn moreFor request structure and field details, see Send TikTok events.
Mark as read [#outbound-mark-as-read]
Send a mark-as-read event to acknowledge that the agent has read a specific inbound message.
The mark-as-read event targets a specific message using its message identifier. The identifier is available in the webhook payload for inbound messages.
The mark-as-read event follows the same pattern as the WhatsApp Send Events API.
Learn moreFor request structure and field details, see Send TikTok events.
Reply to message [#outbound-reply-to-message]
Send a reply that references a specific inbound message. This gives the user visible context about which message you are addressing.
Add reply context within the Send TikTok messages API request. Identify the referenced message using its message identifier from the inbound webhook payload.
Reply-to-message context is a field within the outbound message request, not a separate event type.
Learn moreFor request structure and field details, see Send TikTok events.
Inbound events (MO) [#inbound-events-mo]
Inbound events are signals sent by TikTok users during a conversation. Infobip delivers these events to your configured webhook endpoint.
You must acknowledge each inbound event by returning an HTTP 200 response.
Learn moreFor webhook payload structure and field details, see Receive TikTok inbound events.
Typing indicator [#inbound-typing-indicator]
Infobip delivers a typing indicator event to your webhook when a TikTok user starts composing a message. Use this event to surface real-time typing status in agent-facing interfaces.
The inbound typing indicator event follows the same pattern as the RCS Inbound Typing Indicator.
Read receipt [#inbound-read-receipt]
Infobip delivers a read receipt event to your webhook when a TikTok user views an outbound message. The event includes the identifier of the message that was read.
TikTok delivery and seen reports also describe read receipts for outbound messages. The inbound read receipt event originates from the user reading an agent's message. Infobip delivers it as a webhook event, not a status report.
Reply to message [#inbound-reply-to-message]
When a TikTok user replies to a specific message in the conversation, the inbound webhook event includes context identifying the original message that the user referenced.
The reply context appears as additional fields within the standard webhook payload for inbound messages.
The inbound reply-to-message event follows the same pattern as the WhatsApp Receive Inbound Messages API.
Reaction [#inbound-reaction]
Infobip delivers a reaction event to your webhook when a TikTok user reacts to a message in the conversation. The event includes the identifier of the message that received the reaction and the reaction type.
The inbound reaction event follows the same pattern as the WhatsApp Receive Inbound Messages API.
Event summary [#event-summary]
The following table lists all supported conversation events with their direction and delivery mechanism.
| Event type | Direction | Delivery mechanism |
|---|---|---|
| Typing indicator | MT (outbound) | API request |
| Mark as read | MT (outbound) | API request |
| Reply to message | MT (outbound) | API request (context field within message) |
| Typing indicator | MO (inbound) | Webhook |
| Read receipt | MO (inbound) | Webhook |
| Reply to message | MO (inbound) | Webhook (context field within message event) |
| Reaction | MO (inbound) | Webhook |
Send and receive TikTok messages
Send messages and handle inbound conversations.
TikTok delivery and seen reports
Track message delivery and user interaction.
TikTok over API
Configure API keys, webhooks, and event subscriptions.