Connect RingCentral (cloud phone)
Connect your own RingCentral app to Omnifox (BYO model) to handle calls from the Inbox.
RingCentral connects using a "bring your own app" (BYO) model: instead of Omnifox using a shared app, each customer registers their own application in RingCentral and gives Omnifox that app's Client ID and Client Secret.
Requirements
- A RingCentral account (production or sandbox)
- An app registered at developers.ringcentral.com, of type REST API, with OAuth Authorization Code authentication
- That app's Client ID and Client Secret
Steps to connect
- At developers.ringcentral.com, create a REST API app with OAuth Authorization Code authentication.
- In Omnifox, go to Channels → Connect New Channel, pick RingCentral, and paste your app's Client ID and Client Secret.
- Choose the environment: Production (platform.ringcentral.com) or Sandbox (platform.devtest.ringcentral.com), as appropriate.
- Omnifox shows you a Redirect URI: copy it and register it in your app's OAuth settings on RingCentral.
- Click Connect with RingCentral — you're redirected to log in and authorize access; once you're back, the channel is active.
Configuration
- Client ID / Client Secret: credentials for YOUR RingCentral app (not shared by Omnifox).
- Server: Production or Sandbox — must match where your real account lives.
- Access tokens last about an hour and the refresh token rotates roughly every 7 days; Omnifox renews them automatically.
Example
A customer calls your RingCentral number; the system runs a RingOut that first calls the agent's registered device and, once they answer, bridges the call to the customer's number. The event shows up in the Inbox as part of that conversation.
Tips
- If you're testing the integration, use Sandbox first — that way you don't risk your production line while validating the flow.
- Keep the Client Secret safe: RingCentral only shows it once, when the app is created.
Troubleshooting
- Authorization fails with "redirect_uri mismatch": confirm the Redirect URI registered in RingCentral matches exactly what Omnifox showed you, with no extra or missing trailing slash.
- The channel stops receiving events after a few days: the refresh token may have failed to rotate; reconnect the channel to re-authorize from scratch.
Related articles
-
WhatsApp (Meta) error codes: what they mean and what to do
A table of the most common Meta error codes when sending on WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) and how to fix each one.
-
How to connect Telegram
Connect a Telegram bot to your Omnifox inbox in minutes using BotFather.
-
Instagram and Facebook comments: reply and moderate from Omnifox
See and answer comments on your Facebook and Instagram posts and ads, publicly or privately, and set up automatic replies.
-
Sending and receiving videos on each channel: formats and size limits
Which videos you can send and receive on WhatsApp, Instagram, Messenger, Telegram, web chat and email, the real size limits, and what to do with a large video.
-
Move from WhatsApp QR to Coexistence or Cloud API
Once you're done testing with the QR code, move your number to the official connection: no caps, with templates and broadcasts, and no volume-based ban risk.