ringcentral-chrome-extension-template-spa

RingCentral embeddable Chrome/Firefox extension template for single page app CRM site.

Table of Contents

• Features
• Demo video(Insightly)
• Screenshots(Insightly and Hubspot)
• Realworld examples
• Build and Use
• Build with custom RingCentral clientID/appServer
• Make the features works
• License

Features

• Add Click-to-call button in page.
• Hover conact list to show Click-to-call tooltip.
• Convert phone number text to Click-to-call link.
• Popup caller/callee info panel when call inbound/outbound.
• Build with custom app config.
• Show contact event from RingCentral Widgets.
• Manully/auto Sync Call log to third party contact event.

Demo video(Insightly)

https://youtu.be/Qfje5d5OdK0

Screenshots(Insightly and Hubspot)

| screenshots | screenshots | :-------------------------:|:-------------------------: | | | |

Realworld examples

• insightly-embeddable-ringcentral-phone
• hubspot-embeddable-ringcentral-phone

Build and Use

1. build content.js

# install dependencies, requires nodejs8.10+
npm i

# create env file, and set proper serviceName
cp sample.env .env

# then run it
npm start

# edit src/*.js, webpack will auto-rebuild,
# after rebuild, do not forget to refresh in extension page

1. Go to Chrome extensions page/Firefox choose Addon -> Enable add-on debugging -> Load Temporary Add-on.
2. Open developer mode
3. Load dist as unpacked package.
4. Go to the CRM site to check

Build with custom RingCentral clientID/appServer

• Create an app from https://developer.ringcentral.com/, make sure you choose a browser based app, and set all permissions, and add https://ringcentral.github.io/ringcentral-embeddable/redirect.html to your redirect URI list, Edit config.js.

• Fill your RingCentral app's clientID and appServer in .env.

Make the features works

For now it is just a widget, you can call with it, to make all the features work, still need more developer work.

To make it easier, we already set common modules to reduce developer efforts, you could set proper selectors, methods to make all features to work:

• Edit src/content.js to make all features to work
• Further more you can edit src/manifest.json or src/background.js to do more customization work.
• And you can always read Realworld examples source code as examples
• You can use built-in oauth support like this:

// read docs about auth url from https://developer.chrome.com/apps/identity#method-launchWebAuthFlow
// make sure the redirect url match the pattern https://<app-id>.chromiumapp.org/*
import getAuthCode from 'ringcentral-embeddable-extension-common/src/feat/browser-oauth'

async function auth() {
  let authCode = await getAuthCode(authUrl)
  // do something like get access code with auth code
}

License

MIT