Menu

Expand
Rate this page:

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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 2.4.0: sha256-n/6RCcuNipqtzWOWjJ1D+UQuQ6jjm66Nu5z6FR5m/a4=
  • 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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 2.3.0: sha256-k37Hx/3U6wN1/ai4gc1FedSzTYAyn1kW3oxTGv+EqLY=
  • 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

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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 2.2.2: sha256-KrOF3nMhorDCOFmy8Lpwz/Du0SElgV4KMyBvW76r0U8=
  • 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 and Conversation.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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 2.2.1: sha256-BfGQUsDAH2A06f2v117v7T+4qPiRUKbjCFvu/MhNDBg=
  • 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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 2.2.0: sha256-IVvvlFjCqVxfaKZj7uHAVoOwBtl5q5EjGz4KScEIN+4=
  • 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, use new Client instead.
  • Message.getMediaByCategory has been deprecated, use Message.getMediaByCategories instead.
  • Message.attachTemporaryUrlsFor has been deprecated, use getTemporaryContentUrlsForMedia instead.
  • Event Client.stateChanged has been deprecated, use Client.initialized and Client.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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 2.1.0: sha256-v2SFLWujVq0wnwHpcxct7bzTP8wII7sumEhAKMEqgHQ=
  • 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 to Participant and Conversation.
  • 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 execute Message.getEmailHistory when no history is attached.
  • Improved type checking errors thrown in Message.attachTemporaryUrlsFor.
  • Fixed bindings update always coming in participantUpdated 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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 2.0.1: sha256-wvZyrbfbpP/U/l7WRmkS7lPBjsDcNg2Ib7SzKlF4SZo=
  • 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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 2.0.0: sha256-/pQ4lYklKpRl6E4ruYcKqTUcLsfM2FQLUarDWVA9I0o=
  • 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 of ClientOptions for client instantiation.
  • null can no longer be passed to Conversations.updateFriendlyName.
  • null can no longer be passed to User.updateFriendlyName.
  • Passing null to Conversation.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 the updated 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.
    • Client.unsetPushRegistrationId is now deprecated. Use Client.removePushRegistrations instead.

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, and NotificationTypes.
  • 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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 1.2.3: sha256-fGJzzkCU7845NUd6g0dG6/p0vm5aAIIAi0Vmsply9II=
  • 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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 1.2.1: sha256-2UkMXiUMrGQwt95PXoLiklv9Hgl87uLXA3G6q/9HP7I=
  • 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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 1.2.0: sha256-lYzPQyaIqs8RXkKxfQnkDbfiosIrDKs/OsJ2VjCcMc8=
  • 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 to number | 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=
  • .min.js Minified Conversations SDK bundled for browsers.
    • Base64 SHA-256 for minified version 1.1.0: sha256-CyaWtQO775FKI8f8jyY9Oj2w97RC9r6WHooi8OzgSgE=
  • 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


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=
  • 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.

Rate this page:

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.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!

thanks-feedback-gif