Event_PC_InvitationReceived

This notification notifies a user that they are invited to a group discussion (for example, the user is added as a member and the group discussion room category is set to send out invitations). When users receive an invitation, they must accept the invitation to follow the group discussion.

The following table lists the parameters that you can include in this method.

Parameter

Type

Description

roomId

String

This parameter specifies the ID of the group discussion that the user is invited to join

roomName

String

This parameter specifies the name of the group discussion that the user is invited to and added as a member.

roomDescription

String

 This parameter specifies a description of group discussion.

numberOfParticipants

Number

This parameter specifies the number of participants that have joined the group discussion.

invitationId

 Number This parameter specifies the invitation ID for the group discussion.

Code example

If the notification is successful, BEMS sends the following response to the BlackBerry Connect app and includes the discussion group's ID, name, description, number of participants that have joined the discussion group, and the invitation ID. In the following example, the user receives an invitation to join the retirement group discussion

{
  "id":"S38",
  "error":null,
  "result":
  {
    "data":
     {
       "roomId":"ma-chan://gems.sw.rim.net/0772c8f8-0763-47a8-a98d-478cfb389443",
       "roomName":"Retirement celebration",
       "roomDescription":"User 1 Retirement Discussion",
       "numberOfParticipants":25,
       "invitationId":53,
       "method":"pc.InvitationReceived"
     }
  },
  "jsonrpc":"2.0"
}