Integrations & Telecom
RC

RingCentral Cloud Fax Integration

Enterprise REST API, Server-to-Server JWT, and automated carrier fax routing

A comprehensive guide to connecting your practice's RingCentral account to Intellectua AI. Configure Server-to-Server JWT credentials, pull carrier DIDs, automate webhook subscriptions, and send/receive clinical faxes with branded practice cover pages.

Overview

RingCentral is a leading global enterprise provider of cloud telecommunications and business communications. By integrating RingCentral with Intellectua AI, practices can use their existing RingCentral telephone lines, DIDs, and enterprise contracts for high-volume digital medical faxing, incoming document extraction, and clinical records exchange.

Key Integration Capabilities

  • Server-to-Server JWT Authentication: Uses RingCentral's modern OAuth 2.0 JWT Bearer flow for headless server-to-server operations without requiring user browser logins or refresh token management.
  • Automated Webhook Handshake Validation: Intellectua AI handles RingCentral's Validation-Token challenge verification automatically during subscription setup, enabling instant push notifications for incoming faxes and outbound transmission statuses.
  • Live DID Auto-Discovery: Pull active phone numbers with fax capabilities directly from RingCentral with one click inside the Fax Settings console.
  • Custom Branded Cover Page Preservation: Intellectua AI automatically attaches your practice's custom-branded PDF cover page (with logo, clinic addresses, and HIPAA confidentiality disclaimers) as page 1, instructing RingCentral (coverIndex: 0) not to overwrite your layout.
  • Zero-Friction Fallback: If a location does not have dedicated RingCentral or Sinch lines configured, outbound transmissions seamlessly route through the system-level master line so clinical workflows are never blocked.

Step-by-Step RingCentral Account Configuration

Follow these sequential steps in the RingCentral Developer Console and your Intellectua AI portal:

1

Create a REST API App in RingCentral

Configure Server-to-Server JWT application

RingCentral Developer Console

Log into the RingCentral Developer Portal using your RingCentral admin credentials.

  • Click Create App > Select REST API App.
  • App Type: Server-only (No UI) > Auth Type: Server-to-Server JWT.
  • Grant required permissions: Faxes, ReadMessages, ReadAccounts, WebhookSubscriptions.
  • Generate and copy your Client ID, Client Secret, and JWT Token.
2

Save Credentials in Intellectua AI

Secure AES-256 GCM encrypted integration storage

AES-256 Encrypted

In Intellectua AI, navigate to Settings > Integrations > RingCentral:

  • Paste your Client ID, Client Secret, JWT Token, and Account Main Phone Number.
  • Toggle Integration Status to Active.
  • Click Test & Save Connection to verify OAuth authentication against RingCentral API.
3

Assign Numbers & Auto-Register Webhooks

Provision the line for your clinic location and register webhook callbacks

Auto-Webhook

Navigate to Settings > Fax Numbers and click Add Fax Number:

  • Set Provider to RingCentral.
  • Click Pull from Account: Intellectua AI automatically contacts the RingCentral REST API and loads your active fax phone numbers into the selector.
  • Assign the line to a specific clinic location (e.g. Downtown Specialty Clinic) or keep it Office-wide.
  • Ensure Send Outbound and Receive Inbound are toggled on.
  • Click Save Fax Number. Intellectua AI immediately calls the RingCentral Subscription API to register the webhook URL and completes the handshake challenge.

How RingCentral Digital Faxing Operates

Intellectua AI treats RingCentral as a native telecom carrier in the same pipeline as Sinch, providing complete feature parity:

Outbound Fax Pipeline

When a clinical staff member dispatches an outbound document, order, or record:

  1. Intellectua AI generates the custom practice-branded PDF cover page.
  2. Combines cover page and clinical attachments into an encrypted PDF payload.
  3. Calls RingCentral REST endpoint POST /restapi/v1.0/account/~/extension/~/fax with coverIndex: 0.
  4. Tracks transmission ID, provider status, and records delivery timestamp.

Inbound Webhook & AI Extraction

When an outside clinic or pharmacy faxes your RingCentral line:

  1. RingCentral posts an event payload to /api/webhooks/fax/ringcentral.
  2. The webhook handler resolves the destination location and decrypts API tokens.
  3. Downloads the binary PDF attachment directly from the RingCentral message store.
  4. Stores the encrypted PDF and triggers automated AI OCR, patient matching, and category assignment.

Troubleshooting & FAQs

Token Expired / Invalid JWT Assertion

Ensure your RingCentral app is set to Server-to-Server JWT and the JWT token was generated for an active admin or service extension. If the token was revoked or regenerated in the RingCentral Developer Console, update the token in Settings > Integrations > RingCentral and click Test Connection.

No Phone Numbers Returned on "Pull from Account"

Verify in your RingCentral Service Portal that the telephone numbers assigned to your company or extension have the Fax feature capability enabled. Voice-only or SMS-only numbers without Fax routing will not be displayed.

Do outbound faxes have duplicate cover pages?

No. Intellectua AI sets coverIndex: 0 (None) when calling the RingCentral Fax API, and directly prepends your clinic's custom-branded PDF cover page as page 1. This ensures full layout control and prevents duplicate cover sheets.