Description:

Related issue (if applicable): #796

Added RingCentral Support

• Source: https://ringcentral.com
• Icon Support: No
• Attachment Support: No
• Message Format: Text
• Message Limit: 160 Characters per message

You need to have an account with RingCentral and create an App configured to use the JWT auth flow.

• At a bare minimum, you must grant it the SMS Application Scope

One you've completely set up your Application, you will need to then access the credentials portion of your account and generate a JWT Token that you can share with Apprise (allowing you to authenticate).

Syntax

Valid syntax is as follows:

• ringc://{from_phone}:{token}@{client_id}/{secret}
• ringc://{from_phone}:{token}@{client_id}/{secret}/{targets}
• ringc://{from_phone}:{password}@{client_id}/{secret}
• ringc://{from_phone}:{password}@{client_id}/{secret}/{targets}

Parameter Breakdown

New Service Completion Status

• apprise/plugins/NotifyRingCentral.py
• KEYWORDS
  • add new service into this file (alphabetically).
• README.md
  • add entry for new service to table (as a quick reference)
• packaging/redhat/python-apprise.spec
  • add new service into the %global common_description

Checklist

• The code change is tested and works locally.
• There is no commented out code in this PR.
• No lint errors (use flake8)
• 100% test coverage

Testing

Anyone can help test this source code as follows:

# Create a virtual environment to work in as follows:
python3 -m venv apprise

# Change into our new directory
cd apprise

# Activate our virtual environment
source bin/activate

# Install the branch
pip install git https://github.com/caronc/apprise.git@796-ringcentral-support

# Test out the changes with the following command (send's a SMS message to our account)
apprise -t "Test Title" -b "Test Message" \
"ringc://myphone:jwt_token@client_id:client_secret"

# Test out the changes with the following command; sends a text message
# to the 2 phone numbers found after our client_secret
apprise -t "Test Title" -b "Test Message" \
"ringc://myphone:jwt_token@client_id:client_secret/ 1555123432/1800123436/...."