Changelog: Twilio Conversations JavaScript SDK

• .js Non-minified Conversations SDK bundled for browsers.
  • SHA-256 for non-minified version 2.5.0: sha256-LmJX51wpqOKimCPhYCdDGnQZJWpytnArJ+cLdSd/Mk8=
• .min.js Minified Conversations SDK bundled for browsers.
  • Base64 SHA-256 for minified version 2.5.0: sha256-aBKm/Hjylgtmr/XtFMSDbUWf+2VlRHBbj4jdgy/KhRc=
• npm Conversations Node.js SDK package.
• Docs JS SDK documentation.

Secure browser script link

1
<script src="https://sdk.twilio.com/js/conversations/releases/2.5.0/twilio-conversations.min.js"
2
  integrity="sha256-aBKm/Hjylgtmr/XtFMSDbUWf+2VlRHBbj4jdgy/KhRc="
3
  crossorigin="anonymous"></script>

Non-secure browser script link

<script src="https://sdk.twilio.com/js/conversations/v2.5/twilio-conversations.min.js"></script>

Features

• Added support for Email in Flex

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/2.4.0/twilio-conversations.min.js"
2
  integrity="sha256-n/6RCcuNipqtzWOWjJ1D+UQuQ6jjm66Nu5z6FR5m/a4="
3
  crossorigin="anonymous"></script>

Non-secure browser script link

<script src="https://sdk.twilio.com/js/conversations/v2.4/twilio-conversations.min.js"></script>

Features

• Added support for message channel metadata
• Internal improvements and bugfixes

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/2.3.0/twilio-conversations.min.js"
2
  integrity="sha256-k37Hx/3U6wN1/ai4gc1FedSzTYAyn1kW3oxTGv+EqLY="
3
  crossorigin="anonymous"></script>

Non-secure browser script link

<script src="https://sdk.twilio.com/js/conversations/v2.3/twilio-conversations.min.js"></script>

Features

• Added support for Content API

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/2.2.2/twilio-conversations.min.js"
2
  integrity="sha256-KrOF3nMhorDCOFmy8Lpwz/Du0SElgV4KMyBvW76r0U8="
3
  crossorigin="anonymous"></script>

Non-secure browser script link

<script src="https://sdk.twilio.com/js/conversations/v2.2/twilio-conversations.min.js"></script>

Bug fixes

• Methods Conversation.leave and Conversation.removeParticipant will now properly work for participants with identities containing special characters.

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/2.2.1/twilio-conversations.min.js"
2
  integrity="sha256-BfGQUsDAH2A06f2v117v7T+4qPiRUKbjCFvu/MhNDBg="
3
  crossorigin="anonymous"></script>

Non-secure browser script link

<script src="https://sdk.twilio.com/js/conversations/v2.2/twilio-conversations.min.js"></script>

Bug fixes

• Client.getConversationBySid will no longer throw a deprecation warning when it shouldn't.

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/2.2.0/twilio-conversations.min.js"
2
  integrity="sha256-IVvvlFjCqVxfaKZj7uHAVoOwBtl5q5EjGz4KScEIN+4="
3
  crossorigin="anonymous"></script>

Non-secure browser script link

<script src="https://sdk.twilio.com/js/conversations/v2.2/twilio-conversations.min.js"></script>

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 interfaces 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.

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/2.1.0/twilio-conversations.min.js"
2
  integrity="sha256-v2SFLWujVq0wnwHpcxct7bzTP8wII7sumEhAKMEqgHQ="
3
  crossorigin="anonymous"></script>

Non-secure browser script link

<script src="https://sdk.twilio.com/js/conversations/v2.1/twilio-conversations.min.js"></script>

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 are 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.

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/2.0.1/twilio-conversations.min.js"
2
  integrity="sha256-qh6mHMySA1dWklWKE8GLSfL0vKvTTL4rppgJBU6GIcQ="
3
  crossorigin="anonymous"></script>

Non-secure browser script link

<script src="https://sdk.twilio.com/js/conversations/v2.0/twilio-conversations.min.js"></script>

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

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/2.0.0/twilio-conversations.min.js"
2
  integrity="sha256-/pQ4lYklKpRl6E4ruYcKqTUcLsfM2FQLUarDWVA9I0o="
3
  crossorigin="anonymous"></script>

Non-secure browser script link

<script src="https://sdk.twilio.com/js/conversations/v2.0/twilio-conversations.min.js"></script>

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 in 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.

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/1.2.3/twilio-conversations.min.js"
2
  integrity="sha256-fGJzzkCU7845NUd6g0dG6/p0vm5aAIIAi0Vmsply9II="
3
  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.

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/1.2.1/twilio-conversations.min.js"
2
  integrity="sha256-2UkMXiUMrGQwt95PXoLiklv9Hgl87uLXA3G6q/9HP7I="
3
  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.

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/1.2.0/twilio-conversations.min.js"
2
  integrity="sha256-lYzPQyaIqs8RXkKxfQnkDbfiosIrDKs/OsJ2VjCcMc8="
3
  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.

• 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

1
<script src="https://sdk.twilio.com/js/conversations/releases/1.1.0/twilio-conversations.min.js"
2
  integrity="sha256-CyaWtQO775FKI8f8jyY9Oj2w97RC9r6WHooi8OzgSgE="
3
  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.

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

1
<script src="https://sdk.twilio.com/js/conversations/releases/1.0.0/twilio-conversations.min.js"
2
  integrity="sha256-wwGP7TgNRaTpRZj6r7CM/ZPMa/mMj44/QRLQNnQMJjU="
3
  crossorigin="anonymous"></script>

Non-secure browser script link

<script src="https://sdk.twilio.com/js/conversations/v1.0/twilio-conversations.min.js"></script>

First public release for the new Conversations product

This release was for testing only, please do not use it.