Parameterization

Customize parts of a message for each recipient using parameterization.

This is done by defining a parameter key and placing it in the message body. For each parameter key, a recipient and a parameter value must be provided. You can define the position of a parameter in a message by using placeholders. We use the format ${parameter_key} in the message body. The parameter_key is the name of the parameter to replace with its corresponding value.

For example, the message body Hi ${name}! How are you? contains the parameter name and will be replaced according to the rules specified in the parameters field in the Send message operation.

Another example is when a phone number is not specified as a parameter value. Say you used ${MSISDN} in its place. To set this, identify a recipient as default for each parameter key.

In this instance, if a target MSISDN is missing in the parameters object, and no default value has been defined for that parameter, the message will fail for that MSISDN but not for other recipients.

Also note that parameter keys are case sensitive.