Model#
This schema describes Messages in the responses. Payload for creations and updates is significantly different and can be referenced in docs of the respective API endpoints.
Multiple channels#
It is possible to provide multiple channels per Message. During sending execution, one of them will be chosen, based on:channels which are available for recipient
order (priority) of channels in payload specified during Message creation
Channel attributes#
There are channel attributes specific for given type.| Key | Channel type | Type |
|---|
| message.sender.type | sms | enum: ['alphanumeric', 'international'] |
| message.sender.value | sms | string |
| message.from_email | email | string |
| message.from_name | email | string |
When not provided explicitly, values of those the following attributes are taken from Loyalty Club configuration.The sender describes how SMS sender will be displayed to the receiver of SMS.Depending on selected sender.type, a sender.value can be provided according to the following table:| Type | Value |
|---|
alphanumeric | String consisting of 2-11 characters |
international | Any MSISDN |
Marketing purpose#
Because of GDPR regulations, when Message that has marketing purpose is meant to be sent to MPC members by Audience, then members without marketing consent (see: Member) required for specific channel will be filtered out from the Audience.By default, the marketing purpose of Message is implied from Service - details for a specific service can be referenced here.It is also possible to explicitly mark a Message either by marketing or a non-marketing with marketing:bool flag, but it requires an additional API permit - Messages:Api:Sendings:WithoutConsentsChecks.Aggregated Sendings status#
If all Message's Sendings statuses are of a draft type (or Message has no Sendings), then the sendings_status is draft.If all Message's Sendings are of a finished type, then the sendings_status is finished.If none of the above conditions is true, then sendings_status is scheduled.