Message Metadata in iOS

Message metadata is a great way to convey information pertinent to the conversation. This information is forever tied to the message as it is sent, acting as a snapshot of details that can help the Agent and/or administrator.

Adding message metadata in iOS is a two-step process. Messages need to be pulled aside and the metadata added to the message before passing it along to Khoros Response. Here are the steps involved:

1. Set the conversation's delegate (KBMConversationDelegate)
   • In this example, it's set to the class that opens the messages screen, after show() is called.
2. Override the willSendMessage function in the delegate file.

• This will intercept the message before it is sent, so developers can add a metadata dictionary into the message object.
  
  Objective-CSwift

  -(void)startSecureMessaging:(UIButton*)sender {
      [BrandMessenger show];
      [[BrandMessenger conversation] setDelegate:self];
  }
  -(KBMMessage *)conversation:(KBMConversation*)conversation willSendMessage:(KBMMessage *)message {
      [message setMetadata:@{ @"MetadataOS": @"iOS", @"FieldTwo": @"Test" }];
      return message;
  }

  func startSecureMessagging(_ sender: UIButton) {
      BrandMessenger.show()
      BrandMessenger.conversation()?.delegate = self
  }
  func conversation(_ conversation: KBMConversation, willSend message: KBMMessage) -> KBMMessage {
      message.metadata = ["MetadataOS": "iOS", "FieldTwo":"Test"]
      return message
  }

3. In the Agent's Admin page, in Developer -> Metadata Visibility, add the Brand Messenger network in the Display Fields in Post section.
   
   This will show the default fields like clients[0].platform. You'll need to add your custom fields. This makes them visible under each message in the conversation under the Metadata section in Khoros Response Agent View.