Overview

Topics in Webex Connect are meant for broadcasting messages to your app users on in-app and push messaging channels. Topics are typically used to categorize and collate the app user preferences and interests. These can be direct customer opt-ins or based on customer behavior over time. The topics are unique for an appid on Webex Connect and are categorized into multiple groups. The SDK and API endpoints can be used for managing topics of a particular appid and/or a particular app user.

A topic should be used as the destination in the messaging API request to broadcast messages to all the subscribed app users. The destination can be a single topic id or a conditional expression of multiple topic ids. The available operators are UNION or OR (use ||), INTERSECTION or AND ( use & ), COMPLEMENT or NOT (use ' ) and DIFFERENCE or MINUS (use - ).

📘

JWT Authentication

Webex Connect allows using JWT Authentication for the Thread APIs, Segment APIs, and Topic APIs. Please reach out to the support team to enable the JWT Authentication.

Postman Collection

Try our APIs using the Postman collection here:

Run in PostmanRun in Postman

The following are the APIs in this section:

Error Codes

Description

Error code

Internal error while processing the request

1

Topic already exists

2

Required attributes missing

3

Invalid request

4

Appid/Topic does not exist

5

UserId does not exist

7

Secret key is missing in header

11

AppId is required

14

Secretkey is invalid

26

Stream not found for given appId and userId

31