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.
With this API, you can send MMS messages to both existing contacts and new ones. After sending we check the phone number. If it is a valid phone number, we send a text message. Also if you are using our Contacts and Groups APIs you can use contactIds instead of phoneNumbers or groupIds instad of phoneNumbers.
{
"phoneNumbers": [
"+18181111112",
"+18181111113",
"+18181111114",
"+18181111115"
],
"text": "Hello. Message sent by Boolky.",
"photos": "(binary)"
}
Variable | Type | Validation | Required | Info |
---|---|---|---|---|
text | string | Min 1, Max 650 characters | true | Message what you want to sent. |
phoneNumbers | string[] | Min 1 Number | true | Phone numbers to sent. |
photos | file[] | Min 1, Max 10 Photos | true | Sent mms Photos |
groupIds | int[] | null | false | Sent messages via groupIds, (Advanced). |
contactIds | int[] | null | false | Sent messages via contactIds, (Advanced). |
If everything is correct, you will find in response that the value of the messageKey field is successful. Also in these fields you can find the cost, totalPartCount, receiverCount, text
{
"result": {
"data": {
"cost": 0.16,
"totalPartCount": 4,
"receiverCount": 4,
"text": "Hello. Message sent by Boolky."
},
"message": {
"localizedMessage": "Successfully sent cost: $0.16",
"messageKey": "success"
}
}
}
The error response can be obtained in 3 cases.
{
"error": {
"localizedMessage": "Session expired",
"messageKey": "sessionExpired"
}
}
{
"error": {
"localizedMessage": "Account balance is not enough for this purchase, try to fund your account",
"messageKey": "insufficientFunds"
}
}
{
"error": {
"localizedMessage": "Payment error.",
"messageKey": "reject"
}
}