With the Boolky API you can integrate a number of functions, such as sending a message to both existing contacts and new ones, you can calculate how much it will cost before sending. You can add a contact whenever you have a new user. You can integrate all the functionality that we have, if some functionality is not enough or you have problems with integration, write to the support service and we will solve this issue as soon as possible.
This endpoint is used to get message history per campaign. For example you send message to 10 contacts at once. When you use this endpoint that sent 10 messages will be returned grouped together as one "history" object. If you want to get single message from that campaign use our another endpoint.
Variable | Type | Validation | Required | Info |
---|---|---|---|---|
from | dateString | Date (yyyy-mm-dd) | true | Date From |
to | dateString | Date (yyyy-mm-dd) | true | Date To |
type | string | 0, 1, 2 | true | 0-all, 1-SMS, 2-MMS |
If everything went well, you can find histories array, also in histories array you can find groupMessageHistory Object and photos array. In groupMessageHistory object you can see id, customerId, selectedReceiverCount, totalReceivedCount, cost, totalPartCount, chargeCount, sentDate, type, text, finished, showDate. In photos array you can see id, customerId, groupHistoryId, photoUrl.
{
"result": {
"data": {
"histories": [
{
"groupMessageHistory": {
"id": 56,
"customerId": 7,
"selectedReceiverCount": 3,
"totalReceivedCount": 3,
"cost": "0.1200",
"totalPartCount": 3,
"chargeCount": 3,
"sentDate": "2020-12-29 14:12:03",
"type": 2,
"text": "text",
"finished": true,
"showDate": "2020-12-29T14:12:03"
},
"photos": [
{
"id": 4,
"customerId": 7,
"groupHistoryId": 56,
"photoUrl": "https://api.boolky.net//var/www/boolky/images/mms/d9f516f35067a7f.jpeg"
},
{
"id": 5,
"customerId": 7,
"groupHistoryId": 56,
"photoUrl": "https://api.boolky.net//var/www/boolky/images/mms/dd8129fbec87be2.jpg"
},
{
"id": 6,
"customerId": 7,
"groupHistoryId": 56,
"photoUrl": "https://api.boolky.net//var/www/boolky/images/mms/6b0b434c45cc561.jpg"
}
]
}
]
}
}
}
An error response can be obtained if you have the wrong api key
{
"error": {
"localizedMessage": "Session expired",
"messageKey": "sessionExpired"
}
}