Actions55
- Answering Rule Actions
- Analytics Actions
- Call Log Actions
- Call Queue Actions
- Contact Actions
- Extension Actions
- Fax Actions
- Meeting Actions
- IVR Menu Actions
- Message (SMS) Actions
- Presence Actions
- Recording Actions
- RingSense Actions
- Team Messaging Actions
- Webhook Actions
RingSense → Get Insights
AI-generatedSummary
Fetch RingSense insights for a call record or session, with optional polling and normalized output shaping.
Inputs
- authMode — Choose to use saved credentials or pass an access token dynamically. Default: credentials.
- accessToken — The valid OAuth 2.0 Access Token. Shown when authMode is dynamic.
- serverUrl — The RingCentral API environment (Production or Sandbox). Shown when authMode is dynamic. Default: Production.
- sourceType (required) — Whether to fetch insights by call record ID or session ID. Default: record.
- sourceRecordId (required) — The RingCentral call record ID used by RingSense for insights lookup. Shown when sourceType is record.
- domain (required) — RingSense domain, typically pbx. Shown when sourceType is session. Default: pbx.
- sourceSessionId (required) — The RingSense session ID for insights lookup. Shown when sourceType is session.
- options — Optional fetch configuration. Shown for getInsights and getManyInsights operations.
Output shape
RingSense insight data, structured with notes, summary, highlights, and next-steps when normalizeOutput is true; otherwise the raw API response.
When options.waitForInsights is enabled, the operation polls up to options.maxAttempts times at intervals of options.retryDelaySeconds seconds until insights are available or the attempt limit is reached.
Examples
Example 1: Fetch latest insights for a specific call record using saved credentials, with normalized output.
authMode=credentials, sourceType=record, sourceRecordId=