Skip to main content

RingCentral

Introduction​

Connect RingCentral SMS to BotDojo so inbound messages trigger a flow and the flow's final response is sent back as SMS.

Prerequisites​

  • A RingCentral account with at least one SMS-enabled number
  • A RingCentral app (Client ID + Client Secret) with appropriate permissions (see below)
  • A RingCentral JWT for the extension that owns the SMS numbers

Configure RingCentral​

  1. Register a new RingCentral app in the Developer Portal.
  2. Choose REST API App, then click Next.

RingCentral Rest API App

  1. Fill out the required fields.
  2. For Auth, choose JWT auth flow and select Yes for Issue refresh tokens?.
  3. Under Security, add these Application Scopes:
    • Read Accounts
    • SMS
    • Webhook Subscriptions
  4. For Who will be authorized to access your app?, choose This app is private and will only be callable using credentials from the same RingCentral account..

RingCentral configuration panel

  1. Click Create.
  2. On the next screen, copy the Client ID and Client Secret.

RingCentral app credentials

  1. To create a JWT, click your user name (top right) and select Credentials.
  2. Click Create JWT, fill out the fields, then click Create JWT.
  3. Copy the JWT shown on the next screen.

RingCentral JWT

Connect RingCentral in BotDojo​

  1. In BotDojo, open Integrations.
  2. Find RingCentral and click Connect.
  3. Choose Environment (Production or Sandbox).
  4. Paste Client ID, Client Secret, and JWT.
  5. Click Connect.

BotDojo RingCentral connection modal

info

BotDojo supports multiple RingCentral connections. Create more than one connection if you need to use different RingCentral accounts or extensions.

Create a RingCentral SMS trigger​

  1. Open the flow you want to connect.
  2. Click the Add Trigger button in the flow editor.
  3. Select Integration Trigger, RingCentral Provider, Your Integration Name, and choose RingCentral SMS Message Trigger.
  4. Select the Phone Number you want the bot to respond from.

RingCentral trigger configuration

Behavior and data mapping​

  • Each trigger creates its own RingCentral subscription.
  • Sessions are long-lived and keyed by the sender/receiver number pair.
  • The flow's final output text is sent as a single SMS response.
  • MMS attachments are forwarded into the flow as file/image references when possible; they are also available on the trigger data payload.