Post RingSense Insights to N8N Webhook

We are attempting to receive full transcripts as a trigger for our N8N workflow automation. Once RingSense insights are generated, we want to send those over via a POST request from RingCentral to N8N. The documentation is a bit confusing on this but here is what I have been able to gather:

We of course need a subscription to RingSense
The only way to have RingSense insights posted is through the RingCentral push notification service
(this is where it gets confusing) We need to create a webhook inside RingCentral using the Subscriptions API?

Once the webhook is registered, the webhook can send events to our endpoint address in N8N. An example of this would be:
https://developers.ringcentral.com/api-reference/Subscriptions/createSubscription

POST /restapi/v1.0/subscription
Content-Type: application/json

{
  "eventFilters": [
     "/restapi/v1.0/account/~/extension/~/presence",
     "/restapi/v1.0/account/~/extension/~/message-store"
  ],
  "deliveryMode": {
        "transportType": "WebHook",
        "address": "https://consumer-host.example.com/consumer/path"
  }
}

This is where im assuming we would be able to use the event filters to send the correct information to our webhook address endpoint (the N8N trigger) to kickoff our automation.

Again its a bit unclear because in the documentation there are other avenues I could go down. Im not entirely sure that all of this is needed. I may be over complicating it. If someone could shed some insights on what resources I truly need to set this up, that would be greatly appriciated.

RingSense Documentation: https://developers.ringcentral.com/guide/ai/ringsense

Page 1 / 1

It’s as simple as this

POST /restapi/v1.0/subscription
Content-Type: application/json

{
  "eventFilters": [
     "/restapi/v1.0/account/~/extension/~/presence",
     "/restapi/v1.0/account/~/extension/~/message-store",
     "/ai/ringsense/v1/public/accounts/~/domains/pbx/insights",
     "/ai/ringsense/v1/public/accounts/~/domains/rcv/insights"
  ],
  "deliveryMode": {
        "transportType": "WebHook",
        "address": "https://consumer-host.example.com/consumer/path"
  }
}

Then RingCentral will post the events with payload to your registered webhook address (https://consumer-host.example.com/consumer/path)

In the documentation, this link (RingCentral push notification service) shows you how to subscribe for push notification in general. It explains how to use Webhook or WebSocket as the transport method.

And the this link (subscribe for one or more event filters) shows you the list of RingSense event filters you can use for subscribing for RingSense event for different domains.

Thank you! So this will then send those insights into my N8N webhook endpoint that is listening?

My followup is where does Ringsense Insights API come into play. Why am i being sold on a RingSense API license?

Yes, make sure that the Webhook subscription was created successfully. It requires that the registered address is publicly accessible. You should also set the verificationToken to protect your webhook endpoint. It’s not required but I recommend.
There is no such a RingSense API license. It’s a RingSense license which can be purchased and assigned to an extension for accessing RingSense AI features. From the RingSense API perspective, it requires your app to be registered with the RingSense app scope so you can access the RingSense data via API. The RingSense insights API is an additional way to access/retrieve RingSense data besides the RingSense push notification which is the recommended method. In some system or application, they don’t have a way to implement push notification, then they have to detect the sourceRecordId or sourceSessionId, and call the REST API to get RingSense insights.

Sign up

Login with SSO

Login to the community

Login with SSO

Scanning file for viruses.

This file cannot be downloaded