Changelog: Twilio Conversations JavaScript SDK
Latest release
You can always access the latest release’s docs via this link.
Support for previous versions of the Conversations SDKs
Twilio Conversations SDKs use Semantic Versioning. Twilio supports version N-1 for 12 months after the first GA release of version N. We recommend that you upgrade to the latest version as soon as possible to avoid any breaking changes.
Support for 1.x ceased on October 19, 2022. Please upgrade to the latest version.
The non-secure script link does not validate Sub-Resource Integrity but will download bug fix releases automatically.
The secure link provides cryptographic protection against any changes in the Twilio SDK code, which may be critical in some applications.
Changelog
Conversations 2.4.0 (April 25, 2023)
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 2.4.0:
sha256-aiDMoL8+BoPxRZL8bszYZ1vkXlYNfu+UexlzKijbO1c=
- SHA-256 for non-minified version 2.4.0:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 2.4.0:
sha256-n/6RCcuNipqtzWOWjJ1D+UQuQ6jjm66Nu5z6FR5m/a4=
- Base64 SHA-256 for minified version 2.4.0:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/2.4.0/twilio-conversations.min.js"
integrity="sha256-n/6RCcuNipqtzWOWjJ1D+UQuQ6jjm66Nu5z6FR5m/a4="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v2.4/twilio-conversations.min.js"></script>
Changes
Features
- Added support for message channel metadata
- Internal improvements and bugfixes
Conversations 2.3.0 (March 21, 2023)
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 2.3.0:
sha256-bAwsIGWPAjLYtyaL7ChBTyiTE4R4/UT3WbR3BbBi+uQ=
- SHA-256 for non-minified version 2.3.0:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 2.3.0:
sha256-k37Hx/3U6wN1/ai4gc1FedSzTYAyn1kW3oxTGv+EqLY=
- Base64 SHA-256 for minified version 2.3.0:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/2.3.0/twilio-conversations.min.js"
integrity="sha256-k37Hx/3U6wN1/ai4gc1FedSzTYAyn1kW3oxTGv+EqLY="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v2.3/twilio-conversations.min.js"></script>
Changes
Features
- Added support for Content API
Conversations 2.2.2 (February 22, 2023)
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 2.2.2:
sha256-77sdaO4FcNy2mV29PskLC1rwZjNkv+LwDn/TE4EBgPU=
- SHA-256 for non-minified version 2.2.2:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 2.2.2:
sha256-KrOF3nMhorDCOFmy8Lpwz/Du0SElgV4KMyBvW76r0U8=
- Base64 SHA-256 for minified version 2.2.2:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/2.2.2/twilio-conversations.min.js"
integrity="sha256-KrOF3nMhorDCOFmy8Lpwz/Du0SElgV4KMyBvW76r0U8="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v2.2/twilio-conversations.min.js"></script>
Changes
Bug fixes
- Methods
Conversation.leave
andConversation.removeParticipant
will now properly work for participants with identities containing special characters.
Conversations 2.2.1 (November 24, 2022)
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 2.2.1:
sha256-NRCg6xEOzCTaac5AV0SVT/Ob63Q+nILys+Ac6RmMIp0=
- SHA-256 for non-minified version 2.2.1:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 2.2.1:
sha256-BfGQUsDAH2A06f2v117v7T+4qPiRUKbjCFvu/MhNDBg=
- Base64 SHA-256 for minified version 2.2.1:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/2.2.1/twilio-conversations.min.js"
integrity="sha256-BfGQUsDAH2A06f2v117v7T+4qPiRUKbjCFvu/MhNDBg="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v2.2/twilio-conversations.min.js"></script>
Changes
Bug fixes
Client.getConversationBySid
will no longer throw a deprecation warning when it shouldn't.
Conversations 2.2.0 (September 22, 2022)
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 2.2.0:
sha256-IfSb09n9X6nFaXYpr5AKyMfOWyOz0lKHHO3xhzI8JaE=
- SHA-256 for non-minified version 2.2.0:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 2.2.0:
sha256-IVvvlFjCqVxfaKZj7uHAVoOwBtl5q5EjGz4KScEIN+4=
- Base64 SHA-256 for minified version 2.2.0:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/2.2.0/twilio-conversations.min.js"
integrity="sha256-IVvvlFjCqVxfaKZj7uHAVoOwBtl5q5EjGz4KScEIN+4="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v2.2/twilio-conversations.min.js"></script>
Changes
Deprecations (will be removed in 3.0):
Client.token
getter has been deprecated.Client.create
has been deprecated, usenew Client
instead.Message.getMediaByCategory
has been deprecated, useMessage.getMediaByCategories
instead.Message.attachTemporaryUrlsFor
has been deprecated, usegetTemporaryContentUrlsForMedia
instead.- Event
Client.stateChanged
has been deprecated, useClient.initialized
andClient.initFailed
events instead.
New features
- Change multiple media interface to match the mobile platform SDKs.
Bug fixes
- Client initialization no longer fails with broken conversations.
- Class name
SyncError
will no longer get minified in minified bundles. - Attribute parsing has been fixed for SMS participants.
Conversations 2.1.0 (March 3, 2022)
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 2.1.0:
sha256-RN+13KZsLo5IcGpk1KPyAdHEZhQSVd66Di4tYINSv+g=
- SHA-256 for non-minified version 2.1.0:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 2.1.0:
sha256-v2SFLWujVq0wnwHpcxct7bzTP8wII7sumEhAKMEqgHQ=
- Base64 SHA-256 for minified version 2.1.0:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/2.1.0/twilio-conversations.min.js"
integrity="sha256-v2SFLWujVq0wnwHpcxct7bzTP8wII7sumEhAKMEqgHQ="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v2.1/twilio-conversations.min.js"></script>
Changes
New features:
- Improved client synchronization time for users with many Conversations and Participants.
- Added
bindings
property toParticipant
andConversation
. - Added email body and history accessors to
Message
. - Updated
MessageBuilder
to support email payload.
Bug fixes
- Attempting to use FormData in a non-browser environment will now throw an exception.
- Fixed null exceptions thrown when attempting to execute
Message.getEmailBody
when no body is attached or when attempting to executeMessage.getEmailHistory
when no history is attached. - Improved type checking errors thrown in
Message.attachTemporaryUrlsFor
. - Fixed
bindings
update always coming inparticipantUpdated
reasons. - Various documentation improvements.
Conversations 2.0.1 (January 26, 2022)
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 2.0.1:
sha256-qh6mHMySA1dWklWKE8GLSfL0vKvTTL4rppgJBU6GIcQ=
- SHA-256 for non-minified version 2.0.1:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 2.0.1:
sha256-wvZyrbfbpP/U/l7WRmkS7lPBjsDcNg2Ib7SzKlF4SZo=
- Base64 SHA-256 for minified version 2.0.1:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/2.0.1/twilio-conversations.min.js"
integrity="sha256-qh6mHMySA1dWklWKE8GLSfL0vKvTTL4rppgJBU6GIcQ="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v2.0/twilio-conversations.min.js"></script>
Changes
- Fixed a post-install script causing issues on some platforms.
- Fixed an issue with
Client.getConversationBySid
returning wrong conversations. - Bumped required Node.js version to 14.
Conversations 2.0.0 (October 19, 2021)
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 2.0.0:
sha256-Zi+sUnqbLqAWgi1ckoSa9ym+lCfVY6xOZvDR+/ToHgM=
- SHA-256 for non-minified version 2.0.0:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 2.0.0:
sha256-/pQ4lYklKpRl6E4ruYcKqTUcLsfM2FQLUarDWVA9I0o=
- Base64 SHA-256 for minified version 2.0.0:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/2.0.0/twilio-conversations.min.js"
integrity="sha256-/pQ4lYklKpRl6E4ruYcKqTUcLsfM2FQLUarDWVA9I0o="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v2.0/twilio-conversations.min.js"></script>
Changes
Breaking changes
null
can no longer be passed in place ofClientOptions
for client instantiation.null
can no longer be passed toConversations.updateFriendlyName
.null
can no longer be passed toUser.updateFriendlyName
.- Passing
null
toConversation.sendMessage
will result with the message body being an empty string. - Client is now considered fully initialized only when the new
stateChanged
event is emitted with the value"initialized"
. - Accessing
Client.reachabilityEnabled
before the client is fully initialized will now throw an error. - Accessing
Client.user
before the client is fully initialized will now return a non-initialized user. On client initialization, the user will initialize and receive theupdated
event with all the update reasons. - Default exports have been removed. The SDK now only supports named exports, e.g.,
import { Client } from "@twilio/conversations";
.
New features
- Migrated to the Sessionless protocol.
- Added support for multiple media.
Conversation.prepareMessage
could now be used to send multiple media messages.
- Added support for init registrations.
- The client should now be created using the constructor. The
stateChanged
event should be utilized to react to client initialization. - The factory method
Client.create
is now deprecated. Use the constructor instead.- If a client is created using the deprecated factory method, then
Client.onWithReplay
should be used to subscribe to its events. - If
Client.on
is used instead, then some events that are triggered on client initialization will get lost.
- If a client is created using the deprecated factory method, then
Client.unsetPushRegistrationId
is now deprecated. UseClient.removePushRegistrations
instead.
- The client should now be created using the constructor. The
Other changes
Conversation.addNonChatParticipant
now allows all valid JSON values to be passed as attributes.- Fixed type resolution issues on Angular.
- Fixed initialization problems on React Native.
- The SDK now additionally exports the following types:
ParticipantUpdatedEventArgs
,MessageUpdatedEventArgs
,UserUpdatedEventArgs
,Paginator
, andNotificationTypes
. - All events are now strictly typed when using TypeScript.
Conversations 1.2.3 (July 26, 2021)
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 1.2.3:
sha256-fCxO5CJdh4ylmCrBWCTzsqhpE6aIbJ3L0cmt6FGGiDU=
- SHA-256 for non-minified version 1.2.3:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 1.2.3:
sha256-fGJzzkCU7845NUd6g0dG6/p0vm5aAIIAi0Vmsply9II=
- Base64 SHA-256 for minified version 1.2.3:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/1.2.3/twilio-conversations.min.js"
integrity="sha256-fGJzzkCU7845NUd6g0dG6/p0vm5aAIIAi0Vmsply9II="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v1.2/twilio-conversations.min.js"></script>
Changes
- Fix compilation of TS with type exports, broken since 1.2.1.
Conversations 1.2.1 (July 2, 2021)
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 1.2.1:
sha256-/ni6qklORrIc+z+QcqdgxSOlmaczOFLq85cJfKqoKGE=
- SHA-256 for non-minified version 1.2.1:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 1.2.1:
sha256-2UkMXiUMrGQwt95PXoLiklv9Hgl87uLXA3G6q/9HP7I=
- Base64 SHA-256 for minified version 1.2.1:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/1.2.1/twilio-conversations.min.js"
integrity="sha256-2UkMXiUMrGQwt95PXoLiklv9Hgl87uLXA3G6q/9HP7I="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v1.2/twilio-conversations.min.js"></script>
Changes
- Fix IE11 issues: the SDK should now properly load and work on IE11.
- Upgraded to a modern build toolchain, reducing the bundle size.
Conversations 1.2.0 (May 17, 2021)
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 1.2.0:
sha256-f48Ke76doR3wMUykEyccmedAUfDqMAaEH7fe4limPAo=
- SHA-256 for non-minified version 1.2.0:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 1.2.0:
sha256-lYzPQyaIqs8RXkKxfQnkDbfiosIrDKs/OsJ2VjCcMc8=
- Base64 SHA-256 for minified version 1.2.0:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/1.2.0/twilio-conversations.min.js"
integrity="sha256-lYzPQyaIqs8RXkKxfQnkDbfiosIrDKs/OsJ2VjCcMc8="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v1.2/twilio-conversations.min.js"></script>
Changes
- Fix
Conversation.lastReadMessageIndex
not being set during client initialization. - TypeScript typing for
Conversation.lastReadMessageIndex
got changed tonumber | null
. - Dependency bumps.
- Documentation improvements.
Conversations 1.1.0 (Oct 16, 2020)
- js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 1.1.0:
sha256-DFmUiLiTxQM3i9TCRl8DKUHEm48e6egBi7KlXQ5engc=
- SHA-256 for non-minified version 1.1.0:
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 1.1.0:
sha256-CyaWtQO775FKI8f8jyY9Oj2w97RC9r6WHooi8OzgSgE=
- Base64 SHA-256 for minified version 1.1.0:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/1.1.0/twilio-conversations.min.js"
integrity="sha256-CyaWtQO775FKI8f8jyY9Oj2w97RC9r6WHooi8OzgSgE="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v1.0/twilio-conversations.min.js"></script>
Changes
- Added support for detailed delivery receipts.
Conversations 1.0.0 (Sep 28, 2020)
First official release for the new Conversations product
- .js Non-minified Conversations SDK bundled for browsers.
- SHA-256 for non-minified version 1.0.0:
WpAJSSVar1v0rQ89XYLt4MLAOuK+kZ4Brxbadl62p9c=
- .min.js Minified Conversations SDK bundled for browsers.
- Base64 SHA-256 for minified version 1.0.0:
wwGP7TgNRaTpRZj6r7CM/ZPMa/mMj44/QRLQNnQMJjU=
- Base64 SHA-256 for minified version 1.0.0:
- npm Conversations Node.js SDK package.
- Docs JS SDK documentation.
Secure browser script link
<script src="https://sdk.twilio.com/js/conversations/releases/1.0.0/twilio-conversations.min.js"
integrity="sha256-wwGP7TgNRaTpRZj6r7CM/ZPMa/mMj44/QRLQNnQMJjU="
crossorigin="anonymous"></script>
Non-secure browser script link
<script src="https://sdk.twilio.com/js/conversations/v1.0/twilio-conversations.min.js"></script>
Conversations 0.1.0 (Sep 3, 2020)
First public release for the new Conversations product
This release was for testing only, please do not use.
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.