Meeting delegates and scheduling on behalf of another

By default, the host of the meeting is set to the person scheduling the meeting (or calling the API). However, sometimes you need to schedule a meeting on behalf of another. This is a common need for services that operate a centralized booking agent, whereby a single user is acting on behalf of everyone else in the organization to help schedule meetings with customers, clients, patients, etc.

To schedule a meeting on behalf of someone else, one need only set the accountId and extensionId parameters in the create meeting request to the corresponding values of the host.

var ACCOUNT_ID   = '123456789'
var EXTENSION_ID = '987654321'
platform.post('/rcvideo/v2/account/'+ACCOUNT_ID+'/extension/'+EXTENSION_ID+'/bridges', {
    name: 'Test Meeting'
})
.then(function (resp) {
    console.log(resp.json())
});

When setting the account ID and extension ID for a bridge, the tilda character ("~") can be used as a shorthand for the "same account/extension as the currently logged in user." For example:

Enabling someone to act as a meeting delegate

If you receive a "403 Forbidden" error message when trying to set the host of a meeting, that is because the host has not authorized you to schedule meetings on their behalf. People who have this authority are called "delegates." You can make someone a delegate by following the following instructions.

1. Login to the RingCentral Admin Console.
2. Edit your own settings, or that of another user (if you are permitted to do so).
3. Expand the "User Details" section.
4. Select the "Meetings" tab.
5. Under "Schedule meetings for me," click Edit and select the users who are authorized to be your delegate.

Alternatively, delegates can be selected and set within RingCentral Video directly. To do so, follow these instructions.

1. From a RingCentral Video meeting, select "Settings" from the "More" menu.
2. Click the "Delegates" tab.
3. Search for a delegate and click "Add."

Using the API to fetch a list of delegates

To see what users may act as a meeting delegate for any given user, you can call the following endpoint:

platform.get('/rcvideo/v1/accounts/~/extensions/~/delegators')
    .then(function (resp) {
        console.log( resp.json() )
    });

A successful call will have a response similar to the following (an array of users):

[
  {
    id: '322555020',
    name: 'Craig Chan',
    accountId: '37555510',
    extensionId: '322555020'
  }
]

Sample Response

When run, the sample code above should return something that looks like this:

{
  "id": "iad41-c04-ndb256065cf14ae6a1832389d9c2e",
  "name": "Weekly Meeting with Joseph",
  "type": "Instant",
  "host": {
    "accountId": "664287016",
    "extensionId": "664307016"
  },
  "pins": {
    "pstn": {
      "host": "432331057631",
      "participant": "013409241367"
    },
    "web": "018209241352",
    "aliases": [
      "joseph1990",
      "qa_team_2_lead"
    ]
  },
  "security": {
    "passwordProtected": true,
    "password": {
      "plainText": "Wq123ygs15",
      "pstn": "7492486829",
      "joinQuery": "99e4f8e6a241fc71279449a9c8f46eef"
    },
    "noGuests": false,
    "sameAccount": false,
    "e2ee": false
  },
  "preferences": {
    "join": {
      "audioMuted": false,
      "videoMuted": false,
      "waitingRoomRequired": "Nobody",
      "pstn": {
        "promptAnnouncement": true,
        "promptParticipants": true
      }
    },
    "playTones": "Off",
    "musicOnHold": true,
    "joinBeforeHost": true,
    "screenSharing": true,
    "recordingsMode": "User",
    "transcriptionsMode": "User"
  },
  "discovery": {
    "web": "https://v.ringcentral.com/join/018209241352?pw=99e4f8e6a241fc71279449a9c8f46eef"
  }
}