Public repo of the original developers internal version
Go to file
Sharon Kennedy eae9c737d7 clean up config and remove unneccessary constants 2022-01-17 15:47:26 -05:00
__mocks__ update tests 2020-09-06 15:24:41 -04:00
dist clean up config and remove unneccessary constants 2022-01-17 15:47:26 -05:00
jest Optional Mount Parameters (#123) 2019-06-20 13:26:02 -04:00
public add default settings endpoint' 2020-12-15 10:24:20 -05:00
src clean up config and remove unneccessary constants 2022-01-17 15:47:26 -05:00
vendor adding cleanslate support for style scoping 2018-06-09 08:43:18 -04:00
.eslintrc Optional Mount Parameters (#123) 2019-06-20 13:26:02 -04:00
.gitignore reverting changes 2020-04-28 19:36:36 -04:00
README.md clean up config and remove unneccessary constants 2022-01-17 15:47:26 -05:00
package.json clean up config and remove unneccessary constants 2022-01-17 15:47:26 -05:00
renovate.json enabling auto merge (#163) 2019-08-24 09:41:01 -04:00
webpack.config.js package component 2020-10-15 12:24:59 -04:00
webpack.config.profile.js build and add profiler 2020-06-25 23:03:22 -04:00
yarn.lock clean up config and remove unneccessary constants 2022-01-17 15:47:26 -05:00

README.md

Embeddable Matrix Chatbox

Demo video of chatbox

Live demo: https://nomadic-labs.github.io/safesupport-chatbox/

Built on:

Usage

<script src="https://safesupport.chat/chatbox.js" type="text/javascript"></script>
<script>
  var config = {
    matrixServerUrl: 'https://matrix-client.matrix.org',
    botId: '@your-help-bot:matrix.org',
    roomName: 'Support Chat',
    termsUrl: 'https://tosdr.org/',
    introMessage: 'This chat application does not collect any of your personal data or any data from your use of this service.',
    agreementMessage: 'Do you want to continue?',
    confirmationMessage: 'Waiting for a facilitator to join the chat...',
    exitMessage: 'The chat is closed. You may close this window.',
    chatUnavailableMessage: 'The chat service is not available right now. Please try again later.',
    anonymousDisplayName: 'Anonymous',
  }

  EmbeddableChatbox.mount(config);
</script>

Options:

Name Description Default
matrixServerUrl (required) URL for the Matrix homeserver you want to connect to https://matrix-client.matrix.org
botId (required) User ID for the bot account that handles invites null
introMessage (optional) First message the user sees before agreeing to the Terms of Use This chat application does not collect any of your personal data or any data from your use of this service.
termsUrl (optional) URL for the Terms of Use for the chat service https://tosdr.org/
roomName (optional) Name of the chatroom generated in Riot 'Support Chat'
agreementMessage (optional) Text to show to request agreement to the Terms of Use Do you want to continue?
confirmationMessage (optional) Text to show to ask for agreement to continue Waiting for a facilitator to join the chat...
exitMessage (optional) Text to show if the user rejects the Terms of Use. The chat is closed. You may close this window.
anonymousDisplayName (optional) The display name for the chat user. Anonymous
chatUnavailableMessage (optional) Text to show on error or if the service is otherwise unavailable The chat service is not available right now. Please try again later.
waitMessage (optional) Text to show if there is at least one facilitator online but they do not respond right away Please be patient, our online facilitators are currently responding to other support requests.
chatOfflineMessage (optional) Text to show if there is no-one online respond All of the chat facilitators are currently offline.
size (optional) The size of the start button. Can be 'small' or 'large' large
position (optional) The position of the start button. Can be 'top left', 'top right', 'bottom left', 'bottom right'. bottom right
waitInterval (optional) The interval (in ms) at which the bot sends the wait message 120000

Feature list

  • Can be embedded on any website with Javascript enabled
  • WCAG AA compliant
  • Light and dark theme
  • Support seekers are anonymous
  • Uses Matrix's end to end encryption
  • If encryption fails, falls back to unencrypted chat
  • Status texts are customizeable
  • Only initiates chat after user agrees to Terms of Service
  • Upon exiting chat, user data is wiped - account deleted, local datastore cleared
  • If enabled, the bot account can provide transcript of the conversation
  • Automatically parses incoming text messages for URLs and adds the tags
  • Easy to customize colour scheme
  • Bookmarklet allows users to open the chat on any website

Bot account

This chatbox is meant to be used with a bot account that handles a number of functions:

  • Sends out invitations to facilitators to join the support chat
  • Revokes unused invitations when the first facilitator join the chat
  • Keeps a transcript of the conversation
  • Notifies user if there are not facilitators available

The bot account is invited to the chatroom when a support request is initiated.

You can find the code for the bot at ocrcc-bot.

Bookmarklet

The bookmarklet is a special link that runs a script on any website. The user saves the link by dragging it to their bookmarks bar. Then they can click on the bookmark on any page to run the script and load the chatbox.

You can try this out on the live demo.

Local development

Clone the project:

git clone https://github.com/Safe-Support-Chat/ocrcc-chatbox.git

Install the dependencies:

cd ocrcc-chatbox
yarn

Start the development server:

yarn start

Open the demo page at http://localhost:9000/

Production build

yarn build