RingCentralInstall

Summary

Retrieve RingSense AI call insights across multiple call records or sessions by querying account or extension call logs with custom filter criteria.

Inputs

• authMode — Select whether to use saved RingCentral credentials or pass an OAuth 2.0 access token dynamically.
• accessToken — The OAuth 2.0 access token used when dynamic authentication mode is selected.
• serverUrl — The target RingCentral environment (Production or Sandbox) when dynamic authentication is selected.
• sourceType (required) — Specify whether to discover calls and fetch insights using call record IDs or session IDs.
• domain (required) — The RingSense domain (typically 'pbx') used when fetching insights by session ID.
• scope — Scope of call records to search for insights: current extension level or account level (requires admin permissions).
• returnAll — Whether to fetch insights for all discovered calls or cap the count at a specified limit.
• limit — Maximum number of discovered call records to fetch insights for when Return All is disabled (1-1000).
• filters — Filter criteria for call record discovery, such as date ranges, call direction, or presence of recordings.
• continueOnInsightError — Whether to continue processing remaining calls if fetching insights fails for an individual call.
• options — Advanced options including polling settings (Wait For Insights, Max Attempts, Retry Delay Seconds) and Normalize Output formatting.

Output shape

a list of items

Returns one item per processed call record or session containing RingSense AI data. Enabling Normalize Output formats each item with standardized notes, summary, highlights, and next-steps keys. If Continue On Insight Error is enabled, individual call errors return inline error objects without failing the node execution.

Examples

Example 1: Fetch call insights for all recent account-level call recordings

Set Source Type to 'Call Record', Scope to 'Account Level', enable 'Return All', and set Filters to With Recording = true.

Example 2: Extract normalized AI summaries for outbound calls over a date range

Set Source Type to 'Call Record', Scope to 'Extension Level', filter Direction to 'Outbound', set Date From/To, and enable 'Normalize Output' under Options.

Links

• n8n community nodes installation guide