Skip Navigation
  1. BlackBerry Docs
  2. BlackBerry Enterprise Mobility Server 3.5
  3. BlackBerry Connect messaging APIs
  4. Event notifications
  5. Event_PC_InvitationReceived

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"
}