Разработчик | Boolky API Интеграция

С помощью Boolky API вы можете интегрировать ряд функций, таких как отправка сообщения как существующим контактам, так и новым, вы можете рассчитать стоимость перед отправкой. Вы можете добавить контакт каждый раз, когда у вас есть новый пользователь. Вы можете интегрировать всю имеющуюся у нас опции, если одно из опций недоступна для вас или у вас возникли проблемы с интеграцией, напишите по адресу Служба поддержки и мы решим эту проблему как можно скорее

POST
Отправить SMS собщения
POST
Рассчитать цену на SMS
POST
Отправить MMS собщения
POST
Рассчитать цену на MMS

PUT
Добавить контакты
GET
Получить контакты
POST
Удалить контакты
PUT
Добавить группу
GET
Получить группу
DELETE
Удалить группу
GET
Получить историю групповых сообщений
GET
Получить историю индивидуальных сообщений
GET
Получить баланс

Отправить SMS собщения

С этим API, вы можете отправлять SMS-сообщения как на существующие контакты, так и на новые. После отправки мы проверяем номер телефона. Если это действующий номер телефона, мы отправляем текстовое сообщение. Также, если вы используете наш Контакты и Группы APIs можете использовать contactIds вместо phoneNumbers или groupIds вместо phoneNumbers.

Request Url: https://api.boolky.net/sendSms
* Если вы хотите получать информацию о статусе SMS через WebHook, вы можете войти в свой профиль и добавить URL Call Back. Тип запроса - POST. Описание запроса вы можете увидеть ниже.
      
{
  "smsStatus": "delivered",
  "groupHistoryId": "14874",
  "phoneNumber": "+18181111112",
  "segments": "1",
  "errorCode": null
}
      
    

Request Headers

Authorization: ВАШ_API_КЛЮЧ (get it on dashboard)

language: EN

Request Body

      
{
  "phoneNumbers": [
    "+18181111112",
    "+18181111113",
    "+18181111114",
    "+18181111115"
  ],
  "text": "Hello. Message sent by Boolky.",
  "saveContacts": false
}
      
    
VariableTypeValidationRequiredInfo
textstringMin 1, Max 650 characterstrueMessage what you want to sent.
phoneNumbersstring[]Min 1 NumbertruePhone numbers to sent.
groupIdsint[]nullfalseSent messages via groupIds, (Advanced).
contactIdsint[]nullfalseSent messages via contactIds, (Advanced).
saveContactsbooleantrue / falsefalseIf you need to save contacts.

Если все правильно, вы увидите в ответ, что полe messageKey является успешным. Вы также можете найти в полях цену,счет отправителя,текст.

  • cost - Стоимость сервиса
  • totalPartCount - общее количество MMS компонентов
  • receiverCount - общее количество сообщений, которых вы можете получить.
  • text - ваше сообщение

Удачный ответ

      
{
  "result": {
    "data": {
      "cost": 0.04,
      "totalPartCount": 4,
      "receiverCount": 4,
      "text": "Hello. Message sent by Boolky."
    },
    "message": {
      "localizedMessage": "Successfully sent cost: $0.04",
      "messageKey": "success"
    }
  }
}
      
    

Ответ на ошибку возможно получить в 3-х случаях.

  • Если вы имеете ошибочный api ключ
  • Если у вас недостаточно средств (если в биллинге не включена автоматическая оплата).
  • Если у вас недостаточно средств (если вы включили автоматический платеж, но,к сожалению, произошла ошибка при вычислении денег).

Ответ на ошибку | Сессия истекла

      
{
  "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"
  }
}
      
    
Если у вас есть вопросы,пожалуйста Свяжитесь с нами и мы будем рады помочь вам

Компания

  • О нас
  • Свяжитесь с нами
  • Тарифы
  • Разработчик
  • FAQ

Функции

  • Отправить СМС сообщения онлайн
  • Отправить ММС сообщения онлайн
  • Получайте SMS-сообщения онлайн
  • Рассчитать цену
  • Группы

Интеграции

  • СМС APIs
  • ММС APIs
  • Импортированные контакты
  • Скачать историю

Секторы использования

  • Социальные сети
  • Рестораны /Отели
  • Поставщики
  • Магазины