Message Types

In many use cases it makes sense to have descriptive, predefined categories of messages to ensure that as your app grows and expands its functionality, you aren't limited by basic messaging structures. Moreover, you might want to apply conditional processing to messages of the same type, for example:

• Text messaging.
• Text messaging with language translations embedded in the message.
• Hosted image/file messages, where the file is static and the URL is referenced.
• Video files that contain thumbnails and loading icons.
• Polling and questionnaire messages where you also supply predefined answers.
• Invitations to new channels for private or group chat.
• Action messages for the app to do something for this user.
• Session data linked to a third-party such as video service or streaming event.

Custom vs. internal message type

There are two distinct message type fields a message may have.

• Integer messageType refers to the internal PubNub type of the message.
• String custom_message_type refers to a business-specific label or category to messages, signals, and files.

Server response

Every message sent through PubNub has its internal integer message type returned as type in the subscribe payload. On the contrary, a custom message type string (returned as cmt) is only returned when it has been explicitly set beforehand. The cmt value in the returned server response is the same as the value of custom_message_type (name may vary across SDKs) used during a publish.

Internal message type	Description
0	Regular message
2	App Context event
3	Message Reactions event
4	File message

When working with historical messages, you can choose to return the type and the custom message type in the response by enabling the include_custom_message_type flag (name varies across SDKs). For more information on fetching historical messages and how those parameters are returned, refer to Retrieve messages.

Custom message type not present in payload

If you don't set the custom_message_type parameter during a publish, it is not present in the subscribe or history payloads.

Descriptive message types

Consider these three messages:

• {payload: “Hello I am a Message"}
• {payload: "https://cdn.app/your/image/here.png"}
• {payload: "https://cdn.app/your/video/here.mp4"}

Because of the way these messages are constructed, you may run into a number of problems while trying to interpret their payloads in your app. Should you just scan for text? Should you check if every message starts with https? Should you look for .fileType at the end of each message?

You can make your app easier to expand upon by including message types in the publish call. Making types more descriptive also makes it easier to interpret these messages later on.

Generic payload	Descriptive payload
{payload: “Hello, I am a message"}	{message:"Hello, I am a Message"} with custom_message_type set to text
{payload: "https://cdn.app/your/image/here.png"}	{full:"https://cdn.app/your/image/here.png", thumbnail:" https://cdn.app/your/image/here_thumbnail.png"} with custom_message_type set to image
{payload: "https://cdn.app/your/video/here.mp4"}	{url:"https://cdn.app/your/video/here.mp4", thumbnail:"https://cdn.app/your/video/here_thumbnail.png"} with custom_message_type set to video

When your app receives these kinds of messages, it can process them differently displaying text, images and videos according to their respective types.

Future-proof message types

You can add fail-safe measures into your app. If you introduce new message types, older versions of your app can prompt users to upgrade to unlock the features the new message types provide.

Check out these examples of publishing a Hello World! message with the custom_message_type parameter set to text-message:

Java

pubnub.publish()
    .message("Hello World!")
    .channel("my_channel")
    .customMessageType("text-message")
    .async(new PNCallback<PNPublishResult>() {
        @Override
        public void onResponse(PNPublishResult result, PNStatus status) {
            if(!status.isError()) {
                System.out.println("pub timetoken: " + result.getTimetoken());
            }
            System.out.println("pub status code: " + status.getStatusCode());
        }
    });

JavaScript

pubnub.publish(
  {
    channel: "my_channel",
    message: {"Hello World!"},
    custom_message_type: "text-message"
  },
  function(status, response) {
    console.log(status);
    console.log(response);
  }
);

Kotlin

pubnub.publish(
    message="Hello World!",
    channel = "my_channel",
    custom_message_type = "text-message"
).async { result, status ->
    if (!status.error) {
        println("Publish timetoken ${result!!.timetoken}")
    }
    println("Status code ${status.statusCode}")
}

Objective-C

self.client.publish()
    .message(@"Hello World!")
    .channel(@"my_channel")
    .customMessageType(@"text-message")
    .performWithCompletion(^(PNPublishStatus *status) {
        if (!status.isError) {
        } else {
        }
});

PHP

$result = $pubnub->publish()
                ->channel("my_channel")
                ->message("Hello World!")
                ->customMessageType("text-message")
                ->meta(["name" => "Alex"])
                ->sync();

Python

def publish_callback(result, status):
  if status.isError:
    print status.statusCode
  elif
    print result.timetoken

pubnub.publish()\
  .channel("my_channel")\
  .message({"Hello World!"})\
  .custom_message_type("text-message")\
  .pn_async(publish_callback)

Swift

pubnub.publish(
  channel: "my_channel",
  message: ["Hello World!"],
  customMessageType: "text-message"
){ result in
  switch result {
    case let .success(response):
      print("succeeded: \(response)")

    case let .failure(error):
      print("failed: \(error.localizedDescription)")
  }
}

Custom message type

Like we showed before, the optional string parameter custom_message_type (name may vary across SDKs) in the Publish and Files APIs allows you to add business-specific label or category to messages, signals, and files.

You can use this parameter to easily filter, group or apply conditional logic based on the value of the custom_message_type parameter. Refer to Sending Messages, Sending Signals, and Sending Files for more information.

The value or the custom_message_type parameter must be a case-sensitive, alphanumeric string from 3 to 50 characters (dashes and underscores are allowed). The value can't start with special characters or the pn_ or pn- string.

SDKs supporting custom_message_type

For more info on custom_message_type, go to the following SDKs that already support this parameter: Objective-C, Swift, Java, JavaScript, Python, PHP, and Kotlin.

Recommendations

Message payloads and their types should be easy to read and extendable. As your app grows, you want to ensure that future releases don't break old versions.

Below is a list of payload structures and message types that might be helpful to you:

Text

Java

pubnub.publish()
    .message(new JSONObject()
        .put("content", new JSONObject()
            .put("message", "This is a message"))
        .put("sender", "Mathew.Jenkinson"))
    .channel("my_channel")
    .customMessageType("text-message")
    .async(new PNCallback<PNPublishResult>() {
        @Override
        public void onResponse(PNPublishResult result, PNStatus status) {
            if(!status.isError()) {
                System.out.println("pub timetoken: " + result.getTimetoken());
            }
            System.out.println("pub status code: " + status.getStatusCode());
        }

show all 16 lines

JavaScript

pubnub.publish(
  {
    channel: "my_channel",
    message: {
        "content": {
            "message": "This is a message"
        },
        "sender": "Mathew.Jenkinson"
    },
    customMessageType: "text-message"
  },
  function(status, response) {
    console.log(status);
    console.log(response);
  }

show all 16 lines

Kotlin

pubnub.publish(
    mapOf("content" to mapOf(
      "message" to "This is message"),
      "sender" to "Mathew.Jenkinson")),
    channel = "my_channel",
    custom_message_type = "text-message"
).async { result, status ->
    if (!status.error) {
        println("Publish timetoken ${result!!.timetoken}")
    }
    println("Status code ${status.statusCode}")
}

Objective-C

self.client.publish()
    .message(@{
        @"content": @{
            @"message": @"This is a message"
        },
        @"sender": @"Mathew.Jenkinson"
    })
    .channel(@"my_channel")
    .customMessageType(@"text-message")
    .performWithCompletion(^(PNPublishStatus *status) {
        if (!status.isError) {
        } else {
        }
});

PHP

$result = $pubnub->publish()
                ->channel("my_channel")
                ->message([
                    "content" => [
                        "message" => "This is a message"
                    ],
                    "sender" => "Mathew.Jenkinson"
                ])
                ->customMessageType("text-message")
                ->meta(["name" => "Alex"])
                ->sync();

Python

def publish_callback(result, status):
  if status.isError:
    print status.statusCode
  elif
    print result.timetoken

pubnub.publish()\
  .channel("my_channel")\
  .message({
      "content": {
          "message": "This is a message"
      },
      "sender": "Mathew.Jenkinson"
  })\
  .custom_message_type("text-message")\

show all 16 lines

Swift

pubnub.publish(
  channel: "my_channel",
  message: [
    "content": [
      "message": "This is a message"
    ],
    "sender": "Mathew.Jenkinson"
  ] as [String: AnyJSON],
  customMessageType: "text-message"
) { result in
  switch result {
  case let .success(response):
    print("succeeded: \(response)")
  case let .failure(error):
    print("failed: \(error.localizedDescription)")

show all 17 lines

Multi-language Text

Java

JSONObject data = new JSONObject()
    .put("content", new JSONObject()
        .put("message", new JSONObject()
            .put("en", "This is a message")
            .put("es", "Este es un mensaje")
            .put("de", "Dies ist eine Nachricht")
            .put("nl", "Dit is een bericht")))
    .put("sender", "Mathew.Jenkinson");

pubnub.publish()
    .message(data)
    .channel("my_channel")
    .customMessageType("multi-language-text")
    .async(new PNCallback<PNPublishResult>() {
        @Override

show all 22 lines

JavaScript

pubnub.publish(
  {
    channel: "my_channel",
    message: {
        "content": {
            "message": {
                "en": "This is a message",
                "es": "Este es un mensaje",
                "de": "Dies ist eine Nachricht",
                "nl": "Dit is een bericht"
            }
        },
        "sender": "Mathew.Jenkinson"
    },
    customMessageType: "multi-language-text"

show all 23 lines

Kotlin

val data = mapOf(
            "content" to mapOf(
                "message" to mapOf(
                    "en" to "This is a message",
                    "es" to "Este es un mensaje",
                    "de" to "Dies ist eine Nachricht",
                    "nl" to "Dit is een bericht"
                )
            ), "sender" to "Mathew.Jenkinson"
        )

pubnub.publish()
    .message(data)
    .channel("my_channel")
    .customMessageType("multi-language-text")

show all 22 lines

Objective-C

self.client.publish()
    .message(@{
        @"content": @{
            @"message": @{
                @"en": @"This is a message",
                @"es": @"Este es un mensaje",
                @"de": @"Dies ist eine Nachricht",
                @"nl": @"Dit is een bericht"
            }
        },
        @"sender": @"Mathew.Jenkinson"
    })
    .channel(@"my_channel")
    .customMessageType(@"multi-language-text")
    .performWithCompletion(^(PNPublishStatus *status) {

show all 19 lines

PHP

$result = $pubnub->publish()
                ->channel("my_channel")
                ->message([
                    "content" => [
                        "message" => [
                            "en" => "This is a message",
                            "es" => "Este es un mensaje",
                            "de" => "Dies ist eine Nachricht",
                            "nl" => "Dit is een bericht"
                        ]
                    ],
                    "sender" => "Mathew.Jenkinson"
                ])
                ->customMessageType("multi-language-text")
                ->meta(["name" => "Alex"])

show all 16 lines

Python

def publish_callback(result, status):
    if status.is_error():
        print("Status code: {}".format(status.error_data.information))
    else:
        print("Publish timetoken: {}".format(result.timetoken))

pubnub.publish() \
    .channel("my_channel") \
    .message({
        "content": {
            "message": {
              "en": "This is a message",
              "es": "Este es un mensaje",
              "de": "Dies ist eine Nachricht",
              "nl": "Dit is een bericht"

show all 21 lines

Swift

pubnub.publish(
  channel: "my_channel",
  message: [
    "content": [
      "message": [
        "en": "This is a message",
        "es": "Este es un mensaje",
        "de": "Dies ist eine Nachricht",
        "nl": "Dit is een bericht"
      ]
    ],
    "sender": "Mathew.Jenkinson"
  ] as [String: AnyJSON],
  customMessageType: "multi-language-text"
) { result in

show all 22 lines

Text with image

Java

pubnub.publish()
    .message(new JSONObject()
        .put("content", new JSONObject()
            .put("text", "The weather is gorgeous today. Who's available to meet up for lunch at Bob’s Diner? 🌞")
            .put("attachments", new JSONArray()
                .put(new JSONObject()
                    .put("image", new JSONObject()
                        .put("source", "https://www.pubnub.com/pubnub_logo.svg")
                    )
                )
            )
            .put("sender", "Mathew.Jenkinson"))
    .channel("my_channel")
    .customMessageType("text-with-image")
    .async(new PNCallback<PNPublishResult>() {

show all 23 lines

JavaScript

pubnub.publish(
  {
    channel: "my_channel",
    message: {
        "content": {
            "text": "The weather is gorgeous today. Who's available to meet up for lunch at Bob’s Diner? 🌞",
            "attachments": [
              {
                "image": {
                  "source": "https://www.pubnub.com/pubnub_logo.svg"
                }
              }
            ],
            "sender": "Mathew.Jenkinson"
        }

show all 23 lines

Kotlin

pubnub.publish(
  channel: "my_channel",
  message: mapOf(
            "content" to mapOf(
                "text" to "The weather is gorgeous today. Who's available to meet up for lunch at Bob's Diner? 🌞",
                "attachments" to listOf(
                    mapOf(
                        "image" to mapOf(
                            "source" to "https://www.pubnub.com/pubnub_logo.svg"
                        )
                    )
                ),
                "sender" to "Mathew.Jenkinson"
            )
        ),

show all 25 lines

Objective-C

self.client.publish()
    .message(@{
        @"content": @{
            @"text": @"The weather is gorgeous today. Who's available to meet up for lunch at Bob’s Diner? 🌞",
            @"attachments": @[
                @{
                    @"image": @{
                        @"source": @"https://www.pubnub.com/pubnub_logo.svg"
                    }
                }
            ],
            @"sender": @"Mathew.Jenkinson"
        }
    })
    .channel(@"my_channel")

show all 21 lines

PHP

$result = $pubnub->publish()
                ->channel("my_channel")
                ->message([
                    "content" => [
                        "text" => "The weather is gorgeous today. Who's available to meet up for lunch at Bob’s Diner? 🌞",
                        "attachments" => [
                            [
                                "image" => [
                                    "source" => "https://www.pubnub.com/pubnub_logo.svg"
                                ]
                            ]
                        ],
                        "sender" => "Mathew.Jenkinson"
                    ]
                ])

show all 18 lines

Python

def publish_callback(result, status):
  if status.isError:
    print status.statusCode
  else:
    print result.timetoken

pubnub.publish()\
  .channel("my_channel")\
  .message({
      "content": {
          "text": "The weather is gorgeous today. Who's available to meet up for lunch at Bob’s Diner? 🌞",
          "attachments": [
            {
              "image": {
                "source": "https://www.pubnub.com/pubnub_logo.svg"

show all 23 lines

Swift

struct TextWithImage: JSONCodable {
  let text: String
  let attachments: [[String: AnyJSON]]
  let sender: String
}

pubnub.publish(
  channel: "my_channel",
  message: TextWithImage(
    text: "The weather is gorgeous today. Who's available to meet up for lunch at Bob's Diner? 🌞",
    attachments: [
      [
        "image": [
          "source": "https://www.pubnub.com/pubnub_logo.svg"
        ]

show all 28 lines

Document

Java

pubnub.publish()
    .message(new JSONObject()
        .put("content", new JSONObject()
            .put("link", "https://my/full/document.pdf")
            .put("thumbnail", "https://my/thumbnail/image.png"))
        .put("sender", "Mathew.Jenkinson"))
    .channel("my_channel")
    .customMessageType("document")
    .async(new PNCallback<PNPublishResult>() {
        @Override
        public void onResponse(PNPublishResult result, PNStatus status) {
            if(!status.isError()) {
                System.out.println("pub timetoken: " + result.getTimetoken());
            }
            System.out.println("pub status code: " + status.getStatusCode());

show all 17 lines

JavaScript

pubnub.publish(
  {
    channel: "my_channel",
    message: {
        "content": {
            "link": "https://my/full/document.pdf",
            "thumbnail": "https://my/thumbnail/image.png"
        },
        "sender": "Mathew.Jenkinson"
    },
    customMessageType: "document"
  },
  function(status, response) {
    console.log(status);
    console.log(response);

show all 17 lines

Kotlin

pubnub.publish(
    message = mapOf(
            "content" to mapOf(
                "link" to "https://my/full/document.pdf",
                "thumbnail" to "https://my/thumbnail/image.png"
            ),
            "sender" to "Mathew.Jenkinson"
        ),
    channel = "my_channel",
    customMessageType = "document"
).async { result, status ->
    if (!status.error) {
        println("Publish timetoken ${result!!.timetoken}")
    }
    println("Status code ${status.statusCode}")

show all 16 lines

Objective-C

self.client.publish()
    .message(@{
        @"content": @{
            @"content": @{
                @"link": @"https://my/full/document.pdf",
                @"thumbnail": @"https://my/thumbnail/image.png"
            },
            @"sender": @"Mathew.Jenkinson"
        },
    })
    .channel(@"my_channel")
    .customMessageType(@"document")
    .performWithCompletion(^(PNPublishStatus *status) {
        if (!status.isError) {
            NSLog(@"Publish timetoken %@", status.data.timetoken);

show all 19 lines

PHP

$result = $pubnub->publish()
                ->channel("my_channel")
                ->message([
                    "content" => [
                        "link" => "https://my/full/document.pdf",
                        "thumbnail" => "https://my/thumbnail/image.png"
                    ],
                    "sender" => "Mathew.Jenkinson"
                ])
                ->customMessageType("document")
                ->meta(["name" => "Alex"])
                ->sync();

Python

def publish_callback(result, status):
    if status.isError:
        print(status.statusCode)
    else:
        print(result.timetoken)

pubnub.publish()\
    .channel("my_channel")\
    .message({
        "content": {
            "content": {
                "link": "https://my/full/document.pdf",
                "thumbnail": "https://my/thumbnail/image.png"
            },
            "sender": "Mathew.Jenkinson"

show all 19 lines

Swift

pubnub.publish(
  channel: "my_channel",
  message: [
    "content": [
      "content": [
        "link": "https://my/full/document.pdf",
        "thumbnail": "https://my/thumbnail/image.png"
      ],
      "sender": "Mathew.Jenkinson"
    ]
  ] as [String: AnyJSON],
  customMessageType: "document"
) { result in
  switch result {
  case let .success(response):

show all 20 lines

Video

Java

pubnub.publish()
    .message(new JSONObject()
        .put("content", new JSONObject()
            .put("url", "https://my/video/file.png")
            .put("thumbnail", "https://my/video/image.png"))
        .put("sender", "Mathew.Jenkinson"))
    .channel("my_channel")
    .customMessageType("video")
    .async(new PNCallback<PNPublishResult>() {
        @Override
        public void onResponse(PNPublishResult result, PNStatus status) {
            if(!status.isError()) {
                System.out.println("pub timetoken: " + result.getTimetoken());
            }
            System.out.println("pub status code: " + status.getStatusCode());

show all 17 lines

JavaScript

pubnub.publish(
  {
    channel: "my_channel",
    message: {
        "content": {
            "url": "https://my/video/file.png",
            "thumbnail": "https://my/video/image.png"
        },
        "sender": "Mathew.Jenkinson"
    },
    customMessageType: "video"
  },
  function(status, response) {
    console.log(status);
    console.log(response);

show all 17 lines

Kotlin

pubnub.publish(
    message = mapOf(
            "content" to mapOf(
                "content" to mapOf(
                    "url" to "https://my/video/file.png",
                    "thumbnail" to "https://my/video/image.png"
                )
            ),
            "sender" to "Mathew.Jenkinson"
        ),
    channel = "my_channel",
    customMessageType = "video"
).async { result, status ->
    if (!status.error) {
        println("Publish timetoken ${result!!.timetoken}")

show all 18 lines

Objective-C

self.client.publish()
    .message(@{
        @"content": @{
            @"content": @{
                @"url": @"https://my/video/file.png",
                @"thumbnail": @"https://my/video/image.png"
            },
            @"sender": @"Mathew.Jenkinson"
        }
    })
    .channel(@"my_channel")
    .customMessageType(@"video")
    .performWithCompletion(^(PNPublishStatus *status) {
        if (!status.isError) {
        } else {

show all 17 lines

PHP

$result = $pubnub->publish()
                ->channel("my_channel")
                ->message([
                    "content" => [
                        "url" => "https://my/video/file.png",
                        "thumbnail" => "https://my/video/image.png"
                    ],
                    "sender" => "Mathew.Jenkinson"
                ])
                ->customMessageType("video")
                ->meta(["name" => "Alex"])
                ->sync();

Python

def publish_callback(result, status):
  if status.isError:
    print status.statusCode
  elif
    print result.timetoken

pubnub.publish()\
  .channel("my_channel")\
  .message({
      "content": {
          "url": "https://my/video/file.png",
          "thumbnail": "https://my/video/image.png"
      },
      "sender": "Mathew.Jenkinson"
  })\

show all 17 lines

Swift

pubnub.publish(
  channel: "my_channel",
  message: [
    "content": [
      "url": "https://my/video/file.png",
      "thumbnail": "https://my/video/image.png"
    ],
    "sender": "Mathew.Jenkinson"
  ] as [String: AnyJSON],
  customMessageType: "video"
) { result in
  switch result {
  case let .success(response):
    print("succeeded: \(response)")
  case let .failure(error):

show all 18 lines

Typing indicator

Java

pubnub.signal()
    .message(new JSONObject()
        .put("content", new JSONObject()
            .put("event", "typing"))
        .put("sender", "Mathew.Jenkinson"))
    .channel("my_channel")
    .customMessageType("typing-indicator")
    .async(new PNCallback<PNPublishResult>() {
        @Override
        public void onResponse(PNPublishResult result, PNStatus status) {
            if(!status.isError()) {
                System.out.println("pub timetoken: " + result.getTimetoken());
            }
            System.out.println("pub status code: " + status.getStatusCode());
        }

show all 16 lines

JavaScript

pubnub.signal(
  {
    channel: "my_channel",
    message: {
        "content": {
            "event": "typing"
        },
        "sender": "Mathew.Jenkinson"
    },
    customMessageType: "typing-indicator"
  },
  function(status, response) {
    console.log(status);
    console.log(response);
  }

show all 16 lines

Kotlin

pubnub.signal(
    message = mapOf(
            "content" to mapOf(
                "message" to mapOf(
                    "content" to mapOf(
                        "event" to "typing"
                    )
                ),
                "sender" to "Mathew.Jenkinson"
            )
        ),
    channel = "my_channel",
    customMessageType = "typing-indicator"
).async { result, status ->
    if (!status.error) {

show all 19 lines

Objective-C

self.client.signal()
    .message(@{
        @"content": @{
            @"message": @{
                @"content": @{
                    @"event": @"typing"
                },
                @"sender": @"Mathew.Jenkinson"
            }
        }
    })
    .channel(@"my_channel")
    .customMessageType(@"typing-indicator")
    .performWithCompletion(^(PNPublishStatus *status) {
        if (!status.isError) {

show all 18 lines

PHP

$result = $pubnub->signal()
                ->channel("my_channel")
                ->message([
                    "content" => [
                        "content" => [
                            "event" => "typing"
                        ],
                        "sender" => "Mathew.Jenkinson"
                    ]
                ])
                ->customMessageType("typing-indicator")
                ->meta(["name" => "Alex"])
                ->sync();

Python

def publish_callback(result, status):
  if status.isError:
    print status.statusCode
  else:
    print result.timetoken

pubnub.signal()\
  .channel("my_channel")\
  .message({
      "content": {
          "event": "typing"
      },
      "sender": "Mathew.Jenkinson"
  })\
  .custom_message_type("typing-indicator")\

show all 16 lines

Swift

pubnub.signal(
  channel: "my_channel",
  message: [
    "content": [
      "content": [
        "event": "typing"
      ],
      "sender": "Mathew.Jenkinson"
    ]
  ] as [String: AnyJSON],
  customMessageType: "typing-indicator"
) { result in
  switch result {
  case let .success(response):
    print("succeeded: \(response)")

show all 19 lines

Chat invitation

Java

JSONObject message = new JSONObject()
        .put("content", new JSONObject()
            .put("channel", "this is the channel you are being invited to")
            .put("message", "Hi Craig, welcome to the team!"))
        .put("sender", "Mathew.Jenkinson");

pubnub.publish()
    .message(message)
    .channel("my_channel")
    .customMessageType("chat-invitation")
    .async(new PNCallback<PNPublishResult>() {
        @Override
        public void onResponse(PNPublishResult result, PNStatus status) {
            if(!status.isError()) {
                System.out.println("pub timetoken: " + result.getTimetoken());

show all 19 lines

JavaScript

pubnub.publish(
  {
    channel: "my_channel",
    message: {
        "content": {
            "channel": "this is the channel you are being invited to",
            "message":"Hi Craig, welcome to the team!"
        },
        "sender": "Mathew.Jenkinson"
    },
    customMessageType: "chat-invitation"
  },
  function(status, response) {
    console.log(status);
    console.log(response);

show all 17 lines

Kotlin

pubnub.publish(
    message = mapOf(
            "content" to mapOf(
                "channel" to "this is the channel you are being invited to",
                "message" to "Hi Craig, welcome to the team!"
            ),
            "sender" to "Mathew.Jenkinson"
        ),
    channel = "my_channel",
    customMessageType = "chat-invitation"
).async { result, status ->
    if (!status.error) {
        println("Publish timetoken ${result!!.timetoken}")
    }
    println("Status code ${status.statusCode}")

show all 16 lines

Objective-C

self.client.publish()
    .message(@{
        @"content": @{
            @"channel": @"this is the channel you are being invited to",
            @"message": @"Hi Craig, welcome to the team!"
        },
        @"sender": @"Mathew.Jenkinson"
    })
    .channel(@"my_channel")
    .customMessageType(@"chat-invitation")
    .performWithCompletion(^(PNPublishStatus *status) {
        if (!status.isError) {
        } else {
        }
});

PHP

$result = $pubnub->publish()
                ->channel("my_channel")
                ->message([
                    "content" => [
                        "channel" => "this is the channel you are being invited to",
                        "message" => "Hi Craig, welcome to the team!"
                    ],
                    "sender" => "Mathew.Jenkinson"
                ])
                ->customMessageType("chat-invitation")
                ->meta(["name" => "Alex"])
                ->sync();

Python

def publish_callback(result, status):
  if status.isError:
    print status.statusCode
  else:
    print result.timetoken

pubnub.publish()\
  .channel("my_channel")\
  .message({
      "content": {
          "channel": "this is the channel you are being invited to",
          "message":"Hi Craig, welcome to the team!"
      },
      "sender": "Mathew.Jenkinson"
  })\

show all 17 lines

Swift

pubnub.publish(
  channel: "my_channel",
  message: [
    "content": [
      "channel": "this is the channel you are being invited to",
      "message": "Hi Craig, welcome to the team!"
    ],
    "sender": "Mathew.Jenkinson"
  ] as [String: AnyJSON],
  customMessageType: "chat-invitation"
){ result in
  switch result {
  case let .success(response):
    print("succeeded: \(response)")
  case let .failure(error):

show all 18 lines

Video invitation

Java

JSONObject data = new JSONObject()
        .put("content", new JSONObject()
            .put("session", "your-token-here"))
        .put("sender", "Mathew.Jenkinson");

pubnub.publish()
    .message(data)
    .channel("my_channel")
    .customMessageType("video-invitation")
    .async(new PNCallback<PNPublishResult>() {
        @Override
        public void onResponse(PNPublishResult result, PNStatus status) {
            if(!status.isError()) {
                System.out.println("pub timetoken: " + result.getTimetoken());
            }

show all 18 lines

JavaScript

pubnub.publish(
  {
    channel: "my_channel",
    message: {
        "content": {
            "session": "your-token-here"
        },
        "sender": "Mathew.Jenkinson"
    },
    customMessageType: "video-invitation"
  },
  function(status, response) {
    console.log(status);
    console.log(response);
  }

show all 16 lines

Kotlin

pubnub.publish(
    message = mapOf("content" to mapOf("session" to "your-token-here"), "sender" to "Mathew.Jenkinson",
    channel = "my_channel",
    customMessageType = "video-invitation"
    ).async { result, status ->
        if (!status.error) {
            println("Publish timetoken ${result!!.timetoken}")
        }
        println("Status code ${status.statusCode}") 
    }
)

Objective-C

self.client.publish()
    .message(@{
        @"content": @{
            @"session": @"your-token-here"
        },
        @"sender": @"Mathew.Jenkinson"
    })
    .channel(@"my_channel")
    .customMessageType(@"video-invitation")
    .performWithCompletion(^(PNPublishStatus *status) {
        if (!status.isError) {
        } else {
        }
});

PHP

$result = $pubnub->publish()
                ->channel("my_channel")
                ->message([
                    "content" => [
                        "session" => "your-token-here"
                    ],
                    "sender" => "Mathew.Jenkinson"
                ])
                ->customMessageType("video-invitation")
                ->meta(["name" => "Alex"])
                ->sync();

Python

def publish_callback(result, status):
  if status.isError:
    print status.statusCode
  else:
    print result.timetoken

pubnub.publish()\
  .channel("my_channel")\
  .message({
      "content": {
          "session": "your-token-here"
      },
      "sender": "Mathew.Jenkinson"
  })\
  .custom_message_type("video-invitation")\

show all 16 lines

Swift

pubnub.publish(
  channel: "my_channel",
  message: [
    "content": [
      "session": "your-token-here"
    ],
    "sender": "Mathew.Jenkinson"
  ] as [String: AnyJSON],
  customMessageType: "video-invitation"
) { result in
  switch result {
  case let .success(response):
    print("succeeded: \(response)")
  case let .failure(error):
    print("failed: \(error.localizedDescription)")

show all 17 lines

Poll

Java

pubnub.publish()
    .message(new JSONObject()
        .put("content", new JSONObject()
            .put("question", "What do people want for lunch?")
            .put("answers", new JSONObject()
                .put("pizza", 0)
                .put("pierogi", 6)
                .put("sushi", 0)))
        .put("sender", "Mathew.Jenkinson"))
    .channel("my_channel")
    .customMessageType("poll")
    .async(new PNCallback<PNPublishResult>() {
        @Override
        public void onResponse(PNPublishResult result, PNStatus status) {
            if(!status.isError()) {

show all 20 lines

JavaScript

pubnub.publish(
  {
    channel: "my_channel",
    message: {
        "content": {
            "question": "What do people want for lunch?",
            "answers": {
                "pizza": 0,
                "pierogi": 6,
                "sushi": 0
            }
        },
        "sender": "Mathew.Jenkinson"
    },
    customMessageType: "poll"

show all 24 lines

Kotlin

pubnub.publish(
    message = mapOf ("content" to mapOf(
            "question" to "What do people want for lunch?",
            "answers" to mapOf("pizza" to 0, "pierogi" to 6, "sushi" to 0)
        ), "sender" to "Mathew.Jenkinson"),
    channel = "my_channel",
    customMessageType = "poll"
).async { result, status ->
    if (!status.error) {
        println("Publish timetoken ${result!!.timetoken}")
    }
    println("Status code ${status.statusCode}")
}

Objective-C

self.client.publish()
    .message(@{
        @"content": @{
            @"question": @"What do people want for lunch?",
            @"answers": @{
                @"pizza": @0,
                @"pierogi": @6,
                @"sushi": @0
            }
        },
        @"sender": @"Mathew.Jenkinson"
    })
    .channel(@"my_channel")
    .customMessageType(@"poll")
    .performWithCompletion(^(PNPublishStatus *status) {

show all 19 lines

PHP

$result = $pubnub->publish()
                ->channel("my_channel")
                ->message([
                    "content" => [
                        "question" => "What do people want for lunch?",
                        "answers" => [
                            "pizza" => 0,
                            "pierogi" => 6,
                            "sushi" => 0
                        ]
                    ],
                    "sender" => "Mathew.Jenkinson"
                ])
                ->customMessageType("poll")
                ->meta(["name" => "Alex"])

show all 16 lines

Python

def publish_callback(result, status):
  if status.isError:
    print status.statusCode
  elif
    print result.timetoken

pubnub.publish()\
  .channel("my_channel")\
  .message({
      "content": {
          "question": "What do people want for lunch?",
          "answers": {
              "pizza": 0,
              "pierogi": 6,
              "sushi": 0

show all 21 lines

Swift

pubnub.publish(
  channel: "my_channel",
  message: [
    "content": [
      "question": "What do people want for lunch?",
      "answers": [
        "pizza": 0,
        "pierogi": 6,
        "sushi": 0
      ]
    ],
    "sender": "Mathew.Jenkinson"
  ] as [String: AnyJSON],
  customMessageType: "poll"
) { result in

show all 22 lines