Summary
For the textbots: botflows/sessions/{sessionId}/turns API, there is a upcoming change to be made to the TextBotFlowTurnResponse contract. This contract will have its content array, under the prompts.textPrompts.segments field, use the ConversationMessageContent model commonly used in other messaging APIs (as well as the other textbot's /execute API).
The following elements will be removed from the contract:
contentType will no longer include the values: GenericTemplate, ListTemplate, Postback, and Reactions.
- The properties
generic, list, reactions, mention, and postback will be removed.
- The
id field will be removed.
- From
ContentButtonResponse:
- The
id field will be removed.
These fields are being removed because they are not supported by the backend service processing these requests and, consequently, have never been returned in any TextBotFlowTurnResponses.
Effective Date
Monday, June 23, 2025
Details
The original MessageContent model was designed to accommodate a hybrid deployment model for PureEngage and PureConnect. This change aligns the API with its intended use for Genesys Cloud conversations and facilitates future support for Apple-based rich media.
Impacted APIs
POST /api/v2/textbots/botflows/sessions/{sessionId}/turns
Issue References
[AAPL-530]
Contacts
@Katie Ritz @Claire Murphy
Please reply to this announcement with any questions. This helps the wider developer community benefit from the discussion. We encourage you to use this thread before contacting the designated person directly. Thank you for your understanding.