Send push messages directly between users

[Jorge]

If you want to allow users to send push messages between them in you application you can achieve it using user-scope topics.

Previously to that it is needed to:

1. Ensure your application has correctly set the GCM Key (in case of
   iOS application, you would need to set the APNS certificate and password.

2. Ensure the users of the application have correctly set the GCM
   registrationID, (or the APNS deviceID in case of iOS application),
   it is needed for them to receive push notifications.

Create the channel to send the messages

Create a topic in user scope for user A and subscribe it to the topic, do the same for user B.

Execute this for each user:

// The user must be logged in
try{
  // Create a user-scope topic
  String topicName = "ContactMe";
  KiiTopic topic = KiiUser.topic(topicName);

  // Save the topic to Kii Cloud
  topic.save();
  
  // Subscribe the current user to the topic
  KiiUser user = KiiUser.getCurrentUser();
  KiiPushSubscription sub = user.pushSubscription();
  sub.subscribe(topic);
} catch (IOException ioe) {
  // failed.
} catch (ConflictException e) {
  // Already subscribed.
} catch (AppException e) {
  // failed.
}

Allow the users to communicate

Now we need to grant permission for sending messages to user B in the topic of user A, reciprocally grant the same permission to user A in topic of user B.

Allow user B to send messages to user A:

// User A must be logged in
try {
  // Get user B
  KiiUser userB = KiUser.findUserByUserName(userBName);
  
  // Instantiate the user-scope topic of user A
  String topicName = "ContactMe";
  KiiTopic topic = KiiUser.topic(topicName);
  
  // Get the ACL handler of the topic
  KiiACL acl = topic.acl();
  
  // Allow user B to send messages to the topic
  KiiACLEntry entry = new KiiACLEntry(userB, 
      TopicAction.SEND_MESSAGE_TO_TOPIC, true);
  acl.putACLEntry(entry);

  // Save the new ACL entry
  acl.save();
} catch (IOException ioe) {
  // failed.
} catch (NotFoundException e) {
  // User B not found
} catch (AppException e) {
  // failed.
}

To allow user A to send messages to user B, code presented above should be executed changing the roles of the two users.

Send messages

Finally send a message to the topic of the other user.

User A sends a message to user B:

// Loggin with user A
try {
  // Get user B
  KiiUser userB = KiUser.findUserByUserName(userBName);
  
  // Instantiate the user-scope topic of user B
  String topicName = "ContactMe";
  KiiTopic topic = userB.topicOfThisUser(topicName);
  
  // Build the push message
  KiiPushMessage.Data data = new KiiPushMessage.Data();
  data.put("msg", "Hi, how do you do?");
  KiiPushMessage msg = KiiPushMessage.buildWith(data).build();
  
  // Send the message to user B
  topic.sendMessage(msg);
} catch (IOException ioe) {
  // failed.
} catch (NotFoundException e) {
  // User B not found
} catch (AppException e) {
  // failed.
}

If a user would like to be contacted by any user of the application it could be done adding the following ACL entry in its topic:

KiiACLEntry entry = new KiiACLEntry(KiiAnyAuthenticatedUser.create(), 
      TopicAction.SEND_MESSAGE_TO_TOPIC, true);

[paijwar]

Hi Jorge,
Can you please share iOS example for send push message directly between users?
I am not able to find TopicAction.SEND_MESSAGE_TO_TOPIC in iOS.

for this.
KiiACLEntry entry = new KiiACLEntry(KiiAnyAuthenticatedUser.create(),
TopicAction.SEND_MESSAGE_TO_TOPIC, true);

[cjbeauchamp]

Hey @paijwar, the equivalent in iOS is KiiACLTopicActionSend from KiiACLAction. There's some brief documentation about this here: http://documentation.kii.com/references/ios/storage/latest/Constants/KiiACLAction.html

Hope this helps!

[paijwar]

I am unable to send and receive push notification between user on iOS. But a I am able to do it successfully on Android.
Can you please share piece of code for iOS, to send user level messages.

[riza_alaudin]

Hi @paijwar ,
before i heading for the snippet, i want to make sure that you have read and implement this tutorial .
http://documentation.kii.com/en/guides/ios/quickstart/adding-kii-push-notification-to-your-application/

And make sure you are running on development mode for push notifications.

As for the snippet, you can check it bellow.

  // Get user B
   NSError *error= nil;
   KiiUser *userB = [KiUser findUserByUsernameSynchronous:userBName andError:&error];);
  // Instantiate the user-scope topic of user B
  NSString *topicName = @"ContactMe";
  KiiTopic *topic = [userB topicWithName: topicName];

 // Build the push message
 // Create APNs message fields
 KiiAPNSFields *apnsFields = [KiiAPNSFields createFields];

[apnsFields setAlertBody:@"Hi, how do you do?"];

  // Send the message to user B
  KiiPushMessage *message = [KiiPushMessage 
                                                   composeMessageWithAPNSFields:apnsFields 
                                                                                   andGCMFields:nil];

 // Send the message.
 [topic sendMessageSynchronous:message  withError:&error];

[paijwar]

Hi Riza,
Thank you for guiding me.
I have two users, user1 and user2

When i try to send message from user1 to user2, i have used above code.
Before that when I am trying to add an ACL for topic
KiiACL* acl = [topic topicACL];

    KiiACLEntry* entry = [KiiACLEntry entryWithSubject:[KiiAnyAuthenticatedUser aclSubject] andAction:KiiACLTopicActionSubscribe];
    [acl putACLEntry:entry];
    NSMutableArray* success, *failed;
    [acl saveSynchronous:&error didSucceed:&success didFail:&failed];

it is failing

for sending message
I am getting following error

Error Domain=KiiSDK Code=203 "The operation couldn’t be completed. (KiiSDK error 203.)" UserInfo=0x17d45930 {server_message=Access to this resource is forbidden within current authentication context, server_code=UNAUTHORIZED, description=Unable to authorize request, http_status=401}

[riza_alaudin]

@paijwar did you execute the ACL addition right after topic creation?
It should be logged as user that is the owner/creator of the topic object.