Analyze Bulk Messages - Campaigns

Analyzing a bulk sendout is useful when the user needs information about the send out before actually sending it.

RESPONSE PARAMETERS

KEY

DESCRIPTION

contacts

The details for each contact. The key refers to the id of the contact given in the request.

contacts.recipient

The mobile phone that corresponds to the given contact id.

smsAnalysis.contacts.recipientCountry

The country that corresponds to the given contact id.

contacts.blacklisted

Indicates if the contact is in the SMS blacklist. If true the contact will be excluded from the request.

numberOfRecipients

The total number of recipients.

recipientCountries

The country that each mobile belongs to. The key refers to the mobile of the recipients request property.

recipientsPerCountry

The total recipients per country. The key refers to the country.

recipientsPerGroup

For each group the number of recipients that it contains without the blacklisted contacts (in SMS blacklist). The key refers to the group given in the group request property.

totalInGroups

The total number of recipients in all given groups excluding the ones already specified (in contacts and recipients request property) as well as the ones that are blacklisted.

bodyAnalysis

The analysis for the body of the SMS.

bodyAnalysis.characters

The total number of characters of message body.

bodyAnalysis.parts

The number of actual SMS that will be sent.

bodyAnalysis.transcode

Contains information for the transcoded body of the sms message. This will be available only if the message can be transcoded.

bodyAnalysis.transcode.message

The transcoded message of the original unicode message.

bodyAnalysis.transcode.parts

The number of the parts of the transcoded message.

bodyAnalysis.unicode

Indicates if the body contains unicode characters.

bodyAnalysis.unsupportedGSMCharacters

Which characters caused the message to be considered as unicode.

errors.code

The code of error

errors.developerMessage

Message of error

errors.property

The numbers of invalid recipients

ERROR CODES

STATUS

CODE

DESCRIPTION

400

400001009

You don't have enough balance to send the campaign.

400

400005000

In case you haven't specified any recipients or the sender is invalid.

409

409009003

Your account already has a campaign with the given name.

400

400009004

Your campaign has no recipients. Your groups might be empty or all contacts might be blacklisted.

404

404002001

A contact id does not exist.

Language