Skip to main content

RingCentral engage digital channel SDK Framework for Python

Project description

RingCentral Engage digital source SDK python

Framework(python) to create Engage Digital channel SDK channel for RingCentral Engage Digital. Wiki about RingCentral Engage Digital channel SDK channel, which is a customized channel that support any source user want to use.

Install Prerequisites

  • Python3.6+ and Pip3.
  • First we install virtualenv which will create an isolated environment in which to install and run all the python libraries needed by this framework. Using virtualenv will ensure that the libraries installed for this project do not conflict or disrupt the other python projects you are working on.
  • RingCentral Engage(Dimelo) account, request a demo.

Quick start

Let's start a simple RingCentral Engage source server.

# init project
source venv/bin/activate

Next, we need to run ngrok, a tool for routing web requests to a localhost. This is what will allow your local bot in development to receive webhooks from RingCentral. ngrok is a node app and is installed and start as follows:


# will show
Forwarding           -> localhost:9898
# Remember the, we will use it later

Follow Step by step guide to create Dimelo SDK source in Admin console to prepare the source.

# create env file
cp .env.sample .env
# then edit .env, set proper setting according to the tip in .env

# run local dev server

Test source server

Save your source, your server will get request, you check the request log from console.

Use it as CLI tool

pip3 install ringcentral_engage_digital_source_sdk
rces path/to/

Use is as a module


Post message to channel

You can get channel realtime url and api token from channel setting page, post new message to the channel.

Check post_message_demo/ as an example.

from ringcentral_engage_digital_source_sdk import postMessageToEngage

def main ():
  body = {
    'action': 'messages.create',
    'params': {
      'actions': ['show', 'reply'],
      'id': 'xxxxx',
      'body': 'hi there~',
      'thread_id': 'yyyyy',
      'author': {
        'id': 'zzzzz',
        'firstname': 'John',
        'lastname': 'Doe',
        'screenname': 'John Doe',
        'created_at': 1622426621537
  r = postMessageToEngage(body, url, token)
  print('result', r)

Write a config


Build and Deploy to AWS Lambda


Init a source server project with factory CLI tool




Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

Built Distribution

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page