question

Nikolai Chashchin avatar image
Nikolai Chashchin asked Nikolai Chashchin answered

Unique agent identification

Dear community,


For my application that leverages webhook to get telephony session notifications I need a way to uniquely identify calling/answering agent. The typical notification that I receive looks like this one below:

1658325585715.png

Currently for user identification I use name field. I marked the field that is currently used for identification. I need this information to uniquely map calling/answering agent with some entity in my system.


So my questions here:


1. Is it possible that two agents have same name in the system? In this case the field name cannot be used to uniquely identify agents.

2. Can extensionId be used to uniquely identify agents? If yes, then where can I get the extensionId for a particular agent, as this information available in notification only and not in Admin Console (at least I wasn't able to find it there). I assume that what is displayed in Ext. column is not actual extension as for user with the name Nikolai Chashchin Ext.101 is displayed while with the notification I get 315395004

3. Are there any other options to get agent identify from the notification?

4. Is Admin Console the only way to enter users to the system. Is there a way to import users from Microsoft Active Directory f.ex?


Best,

Nikolai

webhooksringcentral app
1658325585715.png (55.0 KiB)
1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Phong Vu avatar image
Phong Vu answered

See my answer inline

1. Is it possible that two agents have same name in the system? In this case the field name cannot be used to uniquely identify agents.

A. Yes, extensions can have same name, and user can change their name also. So you should not rely on a user name as a unique user identifier.

2. Can extensionId be used to uniquely identify agents? If yes, then where can I get the extensionId for a particular agent, as this information available in notification only and not in Admin Console (at least I wasn't able to find it there). I assume that what is displayed in Ext. column is not actual extension as for user with the name Nikolai Chashchin Ext.101 is displayed while with the notification I get 315395004

A. Extension id is a unique identifier. It's an internal id and no one can change it. Remember that the extension id is different than the extension number. If you want to detect the extension id from the admin console, select a user and pay attention to the URL. E.g. https://service.devtest.ringcentral.com/application/users/users/default/186478004/settings/default

3. Are there any other options to get agent identify from the notification?

A. The best way to identify is the agent's phone number or the extension id. Using the extension id would be the best and you should add the extension id into your system database so you can do a look up for agent other info. To detect extension (agent) info from your RingCentral account, you can use the extension id and call this endpoint.

4. Is Admin Console the only way to enter users to the system. Is there a way to import users from Microsoft Active Directory f.ex?

A.You can use the admin console to manage users. Or you can use APIs to read and manage certain extension data.


1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Nikolai Chashchin avatar image
Nikolai Chashchin answered

Thank you, Phong Vu

1 |3000

Up to 8 attachments (including images) can be used with a maximum of 1.0 MiB each and 10.0 MiB total.

Developer sandbox tools

Using the RingCentral Phone for Desktop, you can dial or receive test calls, send and receive test SMS or Fax messages in your sandbox environment.

Download RingCentral Phone for Desktop:

Tip: switch to the "sandbox mode" before logging in the app:

  • On MacOS: press "fn + command + f2" keys
  • On Windows: press "Ctrl + F2" keys