Send a message

After you have defined the message type(s) and channel(s) to use for your communication, use the send a Messages API message to create your request.

Depending on the channels and message type you use, remember to add additional options to your send request.

This includes features such as the omitUnsupportedElements parameter where Infobip will attempt to send the message even if the message content for a channel contains unsupported elements.

Message options

Additional message options can be applied to your API request.

omitUnsupportedElements

Add the omitUnsupportedElements parameter to your API request to allow a message to be sent even if it contains elements that are unsupported by the channel.

If the parameter is set to true, the API will automatically remove unsupported elements to ensure the message is delivered successfully.

For example, if you want to include a button in your SMS message, you can set the omitUnsupportedElements parameter to 'true' and the Messages API will handle the delivery of the message to WhatsApp as expected. However, it will render only text for the SMS channel.

If the parameter is set to 'false' and you attempt to send a message over a channel that does not support the defined element, then it will result in an error.

{
  "messages" : [ {
    "channel" : "WHATSAPP"
    "content" : {
      "body" : {
        "text" : "Thank you for joining us on Athleete Unlocked! Would you like to subscribe for future Athleete events?",
        "type" : "TEXT"
      },
      "buttons" : [ {
        "type" : "REPLY"
        "text" : "Yes",
        "postbackData" : "true",
       }, {  
        "type" : "REPLY"         
        "text" : "No",
        "postbackData" : "false",
       } ]
    },
    "options" : {
        "omitUnsupportedElements" : true
    },
    "sender": "441234567890",
    "destinations" : [ {
      "to" : "440987654321"
    } ],
  } ]
}

Output

Buttons

Image

Image with header

Templates

Document

Video

NotifyURL

Use the NotifyURL option if you want users to be able to set the URL where they want to receive API responses. Define the URL under the webhooks parameter of the API request.

{
  "messages": [
    {
      "content": {
        "body": {
          "text": "Thank you for your registration!",
          "type": "TEXT"
        },
      },
        "webhooks": {
            "delivery": {
                "url": "https://notifyme.delivery"
        "sender": "441234567890",
        "destinations": [
        {
          "to": "440987654321"
        }
      ],
      "channel": "SMS"
    }
  ]
}

callbackdata

Use callbackdata if you want to define additional data that users want to see in the delivery reports.