See how the Sinch Conversation API is evolving and find out about new features and bug fixes. Any notes labeled with a future date are included for preparatory reasons and are identified as such. Any breaking changes are listed under a corresponding Breaking changes sub-heading.
- Internal tracing and performance improvements
- Remove BETA annotations for Batch API
- Added insert consent records endpoint to Batch API
- Reworked texts in Batch API documentation
- Internal improvements for Delivery Receipt race condition handling.
- GA release of Smart Conversations functionalities
- Callback processing improvements
- Capability check improvements
- Delivery Receipt processing flow improvements.
- Added support for Batch Processing Report Notification webhook trigger.
As of April 16th, 2025, a breaking change has been introduced to the Conversation API. The default processing mode has changed from
CONVERSATIONtoDISPATCH.This change impacts all new Conversation API apps. Apps created before this date are unaffected by this change.
Please review your configurations and update any dependencies accordingly.
- Added get batch status endpoint to Batch API
- Added create/delete contacts endpoint to Batch API
- Replaced
POST projects/{project_id}/batches:sendwithPOST projects/{project_id}/messagesin Batch API - Replaced
POST projects/{project_id}/batches:cancelwithDELETE projects/{project_id}/messagesin Batch API - Deprecated
projects/{project_id}/batchesendpoint in Batch API
- Added support for
channel_metadatain smart conversations callbacks - Improved handling of callbacks to avoid duplication
- Added support credit validation on API calls. See
403Status under common error responses.
- Added
channel_metadatafield to callbacks. See Callback Format.
- Added support for
correlation_idin Dispatch processing mode.
- Added support for
conversation_metadatain Dispatch processing mode.
- Added forwarding of
message_metadatain user messages withreply_to.
- Infrastructure updates.
- Bug fixes and internal improvements.
- Bug fixes and performance improvements
- Batch API made available for open beta usage for EU and US regions
- Added partial batch handling capability with Asynchronous Error Handling to Batch API
- Added parameterisation support for
channel_properties
- Batch API made available for open beta testing for BR region
- Added partial batch handling capability with Asynchronous Error Handling
- Added parameterisation support for
channel_properties
- Added support for Reply To to the Viber BM channel
- Bug fixes and performance improvements
- Added support for Flows Messages to the WhatsApp channel
- Improved Reply To, increasing support time to 3 days
- Added support for Reply To to the Telegram channel
- Bug fixes and performance improvements
- Fixed update app request, making
display_namefield optional - Added support for configurable message retry time and Delivery Report based fallback
- Bug fixes and performance improvements
- Added
channelfield to the list messages request to enable filtering messages by channel - Added
active_channelfield to the list conversation request to enable filtering conversation by its active channel - Added new Smart Conversations powered Message Redaction Webhook Trigger. See Redacted Messages. Note that Smart Conversations is currently available for open beta testing.
- Added
callback_settingsobject withsecret_for_overridden_callback_urlsfield to the create app request and update app request to enable callback verification in dynamic message delivery - Added the
conversation_metadata_update_strategyfield to the send message request (similar to the query parameter in the conversation update request)
- Added documentation for version 2 (V2) of the Templates API. Moving forward, V2 of the Templates API is the recommended version for template creation, configuration, and maintenance via API calls. Some updates include:
- Strongly typed
translationsfield content, allowing the user to define the message using the same JSON structure used to define messages in a send message request - Improved validation
- The option to override the omni-channel template configuration with a channel-specific template (for channels on which channel-specific templates can be created) using the
explicit_channel_omni_messagefield
- Strongly typed
- Improved the consistency of how MO Contact deliveries (that is, when a subscriber shares a Contact record with the business) are handled. Rather than delivering the Contact as a stringified text message type, it is now delivered as a media message with a URL linking to a vCard. The vCard has a TTL of 7 days; you must retrieve the vCard from the URL within that time period.
- Added the
correlation_idfield to send message request - Improved the handling of template messages sent with multiple channels defined. The template will now be properly evaluated for each different channel send attempt.
- Changed the
CardMessagetitlefield to optional on the send message request
- Added format description to the documentation for the
ttlfield of the send message request of the Conversation API
- Stricter validation of the channels provided in the channel priority order field of a Send Message request. All channels provided in this field must be configured in the corresponding Conversation API app, or the request will be rejected.
- Added Smart Conversations functionality to the Conversation API app configuration options available on the Sinch Build Dashboard. This feature allows you to add artificially intelligent analysis to your Conversation API app. Note that Smart Conversations is currently available for open beta testing.
- Improved list messages endpoint, with the addition of new parameters to allow filtering messages by channel identity and accept_time.
- Extended the existing list contacts endpoint to enable the retrieval of contact information based on externalId or channel-identity.
- Improved handling of failed Send Event (POST /v1/projects/{project_id}/events:send) requests
- Deprecated Opt-In and Opt-out endpoints. They now return mocked responses to maintain backwards compatibility with existing integrations
- Contact channel identities duplication protection mechanism in Conversation Api.
- Updated the limit of options for choice messages to 10
- Removed Conversation API Opt-In and Opt-Out endpoint documentation
- Added List and Get query generators to the Sinch Build Dashboard to assist developers with early integration troubleshooting. These queries can be used to retrieve and display information regarding messages, conversations, and contacts.
- Added Markdown support for the Telegram Bot channel
- Improved Conversation API metadata documentation (callbacks, conversations)
- Queue Prioritisation to support HIGH_PRIORITY messages
- App Cache improvements
- Autoscaling improvements
- Removed manual channel webhook configuration step when configuring Telegram and LINE channels via API
- Added a webhook for when a contact is updated
- Added field
metadata_update_strategyto Conversation Update
- Added field
default_sendertoMMSCredentials - Added the
injectedflag to the message object - Added restriction to callback queue length per application
- Improved webhook url validation
- Internal improvements
- Improved validation of the request body
- Updated Postman Collection
- Moved List Message documentation to the Messages tab in the API reference section
- Release of Dispatch processing mode support Beta
- Support for
SMS_MAX_NUMBER_OF_MESSAGE_PARTSchannel property on SMS channel
- Release of WeChat channel support Beta
- Added Processing Mode documentation
- Improved descriptions of several APIs
- Added more information to unsupported callbacks webhook
- Added support to conversation MO metadata
- Release of LINE channel support Beta
- Improved Apple BC card message with rich link transcoding
- Release of Apple Business Chat channel support Beta
- Allow 4 digit short code senders for the MMS channel
- Correctly populate the ViberBM DR timestamp
- Improved Instagram icebreaker, shop product referral and story reply callbacks with metadata
- Added support for Instagram private replies feature
- Added supporting for Telegram Card & Choice Messages
- Improved validation of Location and Choice Messages for Facebook Messenger
- Bugfix for timestamps in Viber Business contact messages
- Improved Instagram setup process with Facebook login button
- Facebook Media Messages now support image, audio, video and document types
- Improved error messages for MMS channel media validation
- Viber Bot channel user profile query support
- Release of KakaoTalk channel support Beta
- Improvements in validating content for WhatsApp message requests
- Validation of phone number contact identities
- Release of Telegram channel support Beta
- Improvements in transcoding of CardMessage and CarouselMessage for Instagram channel
- Improvements on MMS channel for handling choice responses and contact messages that contain media attachments
- Improvements in message request validation
- Enabled setting contact metadata in message request for newly created contacts
- Handling of Suspended state for WhatsApp bots
- Bugfixes in the CardMessage text formatting on WhatsApp and Viber Business channels
- Improvements for WhatsApp channel error response mapping and forwarding
- Support for vCard .vcf files on MMS channel in MediaMessage and CardMessage
- Support for MMS_STRICT_VALIDATION channel property to validate MMS media message contents against best practices
- Support for contact based retention policy
- New feature in Contact Management: enables fetching user profile from channels (this first release only supports Facebook Messenger)
- Release of Instagram channel support Beta
- Bugfix for supporting RCS CardMessage without media
- Improvements in retention policy execution
- Improved request body validation
- Support for SMS_SENDER channel property to populate originator on SMS channel
- Added support for sending and receiving documents on Viber Business Messaging
- Improved error response mapping and forwarding on Viber Business and SMS channels
- Bugfix for keeping card order in RCS CarouselMessages
- Improvements in Viber Business Messaging transcoding with text formatting
- Various bugfixes
- Added support for MMS
- Added validation of URLs in MT messages
- Added validation against duplicated callback triggers
- Handle ChoiceResponseMessages on Viber Bot that have no match in the choice tracking data
- Fixed prematurely closed HTTP connection exceptions for WhatsApp