Добавить телефоны в адресную книгу без переменных

Чтобы добавить телефоны в адресную книгу отправьте POST запрос по ссылке:

https://api.sendpulse.com/sms/numbers

Параметры запроса:

Параметр Тип Описание
addressBookId int ID адресной книги
phones array Массив телефонов

Пример запроса:

{
    "addressBookId": 434443,
    "phones": ["380986235698", "3800685321598"]
}

В случае успешного запроса вы получите ответ:

{
    "result": true,
    "counters": {
        "added": 2,
        "exceptions": 0,
        "exists": 0
    }
}
 

Добавить телефоны в адресную книгу с переменными

Чтобы добавить телефоны к адресной книге c переменными, отправьте POST запрос по ссылке:

https://api.sendpulse.com/sms/numbers/variables

Параметры запроса:

Параметр Тип Описание
addressBookId int ID адресной книги
phones array Массив телефонов с переменными

Пример запроса:

{
   "phones":{
      "380632631234":[
         [
            {
               "name":"Date",
               "type":"date",
               "value":"2018-10-10"
            },
            {
               "name":"Name",
               "type":"string",
               "value":"Name"
            }
         ]
      ],
      "38063333333":[
         [
            {
               "name":"Date",
               "type":"date",
               "value":"2018-10-10"
            },
            {
               "name":"Name",
               "type":"string",
               "value":"Name"
            }
         ]
      ]
   },
   "addressBookId":434443
}

Дата при этом не должна содержать времени, например: "2018-10-10 23:00:00" - НЕверный формат значения переменной, а "2018-10-10" — верный.

В случае успешного запроса вы получите ответ:

[
   {
      "result":true,
      "counters":{
         "added":2,
         "exceptions":0,
         "exists":83
      }
   }
]
 

Изменить значение переменных для одного контакта

Чтобы изменить переменную для одного контакта, отправьте POST запрос по ссылке:

https://api.sendpulse.com/addressbooks/{id}/phones/variable

Параметры запроса:

Параметр Тип Описание
phone string Телефонный контакт, для которого будет заменена переменная
id int ID адресной книги в которой находится нужный контакт
variables array Массив переменных

Пример запроса:

{
   "phone":"380931112233",
   "variables":[
      {
         "name":"name",
         "value":"John"
      },
      {
         "name":"date",
         "value":"2019-02-01"
      }
   ]
}

В переменную типа string возможно установить как числовое значение, так и значение типа int или date(YYYY-MM-DD); в переменную типа number возможно установить только число. В переменную типа date возможно установить только дату, которая передана в формате YYYY-MM-DD. Другие форматы не поддерживаются: к примеру, валидный формат даты : 2017-01-01, а не валидный: 2017-1-1.

В случае успешного запроса вы получите ответ:

{
    "result": true
}
 

Обновить список переменных по нескольким контактам

Чтобы обновить список переменных по массиву контактов, отправьте PUT запрос по ссылке:

https://api.sendpulse.com/sms/numbers

Параметры запроса:

Параметр Тип Описание
addressBookId int ID адресной книги 
phones array Массив телефонов
variables array Массив переменных

Пример параметра phones:

["380933170413","380988365096","380956045455","380635962561"]

Пример параметра variables:

[
   {"name":"test1","type":"date", "value":"2018-10-10 23:00:00"},
   {"name":"test2","type":"string", "value":"czxczxczx"},
   {"name":"test3", "type":"number", "value":12312312312}
]

В случае успешного запроса вы получите ответ:

[
   {
      "result":true,
      "counters":{
         "updated":4
      }
   }
]
 

Удалить телефоны из адресной книги

Чтобы удалить телефоны из адресной книги, отправьте DELETE запрос по ссылке:

https://api.sendpulse.com/sms/numbers

Параметры запроса:

Параметр Тип Описание
phones array Список телефонов
addressBookId int ID адресной книги

Пример запроса:

{
    "addressBookId": 434443,
    "phones": ["380986235698", "380685321598"]
}

В случае успешного запроса вы получите ответ:

{
    "result": true,
    "counters": {
        "deleted": 2
    }
}
 

Получить информацию о телефонном номере

Чтобы получить информацию о телефонном номере, отправьте GET запрос по ссылке:

https://api.sendpulse.com/sms/numbers/info/{id}/{phoneNumber}

Параметры запроса:

Параметр Тип Описание
phoneNumber string Номер телефона
id int ID адресной книги

В случае успешного запроса вы получите ответ:

{
    "result": true,
    "data": {
        "email": "example@gmail.com",
        "status": 0,
        "variables": {
            "Date": "2018-10-10",
            "Name": "John"
        },
        "added": "2021-07-06 09:35:48"
    }
}
 

Добавить номер в черный список

Чтобы добавить номер в черный список, отправьте POST запрос по ссылке:

https://api.sendpulse.com/sms/black_list

Параметры запроса:

Параметр Тип Описание
phones array Список телефонов
description string Описание

Пример запроса:

{
    "phones": ["350905623479", "350915623471"],
    "description": "description"
}

В случае успешного запроса вы получите ответ:

[
   {
      "result":true,
      "counters":{
         "added":2,
         "exists":3
      }
   }
]
 

Удалить номер из черного списка

Чтобы удалить телефона из черного списка, отправьте DELETE запрос по ссылке:

https://api.sendpulse.com/sms/black_list

Параметры запроса:

Параметр Тип Описание
phones array Список телефонов

В случае успешного запроса вы получите ответ:

[  
   {  
      "result":true,
      "counters":{  
         "removed":3
      }
   }
]
 

Получить информацию по черному списку

Чтобы получить информацию по черному листу, отправьте GET запрос по ссылке:

https://api.sendpulse.com/sms/black_list

В случае успешного запроса вы получите ответ:

[  
   {  
      "result":true,
      "counters":{  
         "removed":3
      }
   }
]
 

Получить информацию о телефонах в черном списке

Чтобы получить информацию о телефонах в черном списке, отправьте GET запрос по ссылке:

https://api.sendpulse.com/sms/black_list/by_numbers

Параметры запроса:

Параметр Тип Описание
phones array Список телефонов

В случае успешного запроса вы получите ответ:

[
   {
      "result":true,
      "data":[
         {
            "phone":380506383302,
            "description":"texst",
            "add_date":"2017-02-27 10:48:22"
         }
      ]
   }
]
 

Создать рассылку по адресной книге

Чтобы создать рассылку по адресной книге, отправьте POST запрос по ссылке:

https://api.sendpulse.com/sms/campaigns

Параметры запроса:

Параметры Тип Описание
sender string Имя отправителя SMS (до 11 символов латиницей, можно с цифрами)
addressBookId int Адресная книга
body string Текст рассылки
transliterate int Транслитерация тела (может принимать значения 0 или 1)
route* object Список каналов для отправки по странам (опционально), например, {"UA":"national", "BY":"international"}
date string Дата рассылки в формате Y-m-d H:i:s (опционально)
emulate int Опциональный параметр, запускает тестовый режим; если emulate=1 рассылка формируется,
но не будет отправлена и в панели пользователя не отобразится.
В ответе API ID рассылки будет равен 0

*Для отправки смс на некоторые операторы некоторых стран нужно указывать, по какому каналу будет отправлена смс.

Для отправки по национальному каналу в Украину и Беларусь необходимо одобренное имя отправителя.

Если нет одобренного имени отправителя в Украину, для доставки смс в эти страны нужно указывать международный канал или канал с подменой имени {"UA":"sim_ua"}.

Все сообщения подлежат модерации, поэтому доставка SMS может занять несколько минут.

Пример запроса:

{
   "sender":"Sender",
   "addressBookId":422325,
   "body":"body",
   "transliterate":1,
   "route":{
      "UA":"sim_ua"
   },
   "date":"2021-07-07 10:00:00",
   "emulate":0
}

В случае успешного запроса вы получите ответ:

{
    "result": true,
    "campaign_id": 5033111
}
 

Создать рассылку по телефонному списку

Чтобы создать рассылку по телефонному списку (или на один номер), отправьте POST запрос по ссылке:

https://api.sendpulse.com/sms/send

Параметры запроса:

Параметр Тип Описание
sender string Имя отправителя SMS (до 11 символов латиницей, можно с цифрами)
phones array Список телефонов
body string Текст рассылки
transliterate int Транслитерация тела (может принимать значения 0 или 1)
route* object Список каналов для отправки по странам (опционально) , например, {"UA":"national", "BY":"international"}
emulate int Опциональный параметр, запускает тестовый режим; если emulate=1 рассылка формируется,
но не будет отправлена и в панели пользователя не отобразится.
В ответе API ID рассылки будет  равен 0
date string Дата рассылки в формате Y-m-d H:i:s (опционально)

*Для отправки смс на некоторые операторы некоторых стран нужно указывать, по какому каналу будет отправлена смс.

Для отправки по национальному каналу в Украину и Беларусь необходимо одобренное имя отправителя.

Если нет одобренного имени отправителя в Украину, для доставки смс в эти страны нужно указывать международный канал или канал с подменой имени {"UA":"sim_ua"}.

Все сообщения подлежат модерации, поэтому доставка SMS может занять несколько минут.

Пример запроса:

{
   "sender":"Sender",
   "phones":[
      "0986158966",
      "0930452313"
   ],
   "body":"body",
   "transliterate":1,
   "route":{
      "UA":"sim_ua"
   },
   "emulate":0,
   "date":"2021-07-07 10:00:00"
}

В случае успешного запроса вы получите ответ:

{
    "result": true,
    "campaign_id": 503422,
    "counters": {
        "exceptions": 0,
        "sends": 2
    }
}
 

Получить список рассылок по датам

Чтобы получить список рассылок по датам, отправьте GET запрос по ссылке:

https://api.sendpulse.com/sms/campaigns/list

Параметры запроса (необязательные):

Параметр Тип Описание
dateFrom string Дата от в формате Y-m-d H:i:s
dateTo string Дата до в формате Y-m-d H:i:s

Пример URL запроса c дополнительными параметрами:

https://api.sendpulse.com/sms/campaigns/list?dateFrom=2021-07-05 07:48:22&dateTo=2021-07-07 07:48:22

В случае успешного запроса вы получите ответ:

{
   "result":true,
   "data":[
      {
         "id":508962,
         "address_book_id":0,
         "company_price":"1.28000",
         "company_currency":"UAH",
         "send_date":"2021-07-07 07:00:00",
         "date_created":"2021-07-06 11:20:01",
         "sender_name":"Sender"
      },
      {
         "id":503358,
         "address_book_id":4225856,
         "company_price":"0.64000",
         "company_currency":"UAH",
         "send_date":"2021-07-07 07:48:22",
         "date_created":"2021-07-06 11:04:52",
         "sender_name":"Sender"
      }
   ]
}
 

Получить информацию по рассылке

Чтобы получить информацию по рассылке, отправьте GET запрос по ссылке:

https://api.sendpulse.com/sms/campaigns/info/{id}

Параметры запроса:

Параметр Тип Описание
id int ID рассылки

В случае успешного запроса вы получите ответ:

[  
   {  
      "result":true,
      "data":{  
         "id":7520226,
         "address_book_id":0,
         "currency":"UAH",
         "company_price":0.54,
         "send_date":"2018-09-13 11:03:22",
         "date_created":"2018-09-13 11:03:22",
         "sender_name":"AFK",
         "task_phones_info":[  
            {  
               "phone":380956045455,
               "status":2,
               "status_explain":"Delivered",
               "сountry_code":"UA",
               "money_spent":0.27
            },
            {  
               "phone":380985587288,
               "status":2,
               "status_explain":"Delivered",
               "сountry_code":"UA",
               "money_spent":0.27
            }
         ]
      }
   }
]

Статусы отправки:

Код Название Описание
0 Ready to send Готово к отправке
1 Sent Отправлено
2 Delivered Доставлено
12 Not delivered Не доставлено
 

Отменить рассылку

Используется для запланированных рассылок.

Чтобы отменить рассылку, отправьте PUT запрос по ссылке:

https://api.sendpulse.com/sms/campaigns/cancel/{id}

Параметры запроса:

Параметр Тип Описание
id int ID рассылки

В случае успешного запроса вы получите ответ:

{
    "result": true
}
 

Получить стоимость рассылки

Чтобы получить стоимость рассылки, отправьте GET запрос по ссылке:

https://api.sendpulse.com/sms/campaigns/cost

Параметры запроса:

Параметр Тип Описание
addressBookId int ID адресной книги 
phones array Список телефонов 
body string Тело сообщения
sender string Отправитель
route object Список каналов для отправки по странам (опционально) , например, {"UA":"national", "BY":"international"}

Обратите внимание, что данные необходимо кодировать в URL формат.

Если не указана адресная книга, то обязательно должен быть указан список телефонов, и наоборот.

Если выбран маршрут internationalsender можно не указывать для некоторых стран.

Пример запроса:

{
   "addressBookId":422325,
   "body":"body",
   "sender":"Sender",
   "route":{
      "UA":"national"
   }
}

В случае успешного запроса вы получите ответ:

{
   "result":true,
   "data":{
      "price":14.679,
      "currency":"UAH"
   }
}
 

Получить список имен отправителей

Для получения списка всех зарегистрированных/отправленных на регистрацию/отклоненных имен отправителя для СМС, отправьте GET запрос по ссылке:

https://api.sendpulse.com/sms/senders

В случае успешного запроса вы получите ответ:

[
    {
        "id": 18021,
        "sender": "apicheck",
        "country": "Ukraine",
        "country_code": "UA",
        "status": 2,
        "status_explain": "Rejected"
    },
    {
        "id": 4786,
        "sender": "iQA",
        "country": "Ukraine",
        "country_code": "UA",
        "status": 1,
        "status_explain": "Active"
    },
    {
        "id": 4787,
        "sender": "iQA",
        "country": "Ukraine",
        "country_code": "UA",
        "status": 1,
        "status_explain": "Active"
    },
    {
        "id": 18027,
        "sender": "rejectit",
        "country": "Ukraine",
        "country_code": "UA",
        "status": 0,
        "status_explain": "On moderation"
    }
]

Возможные статусы отправителя:

Код Описание
0 На модерации
1 Активный
2 Отклонен
 

Удалить рассылку

Чтобы удалить рассылку, отправьте DELETE запрос по ссылке:

https://api.sendpulse.com/sms/campaigns

Параметры запроса:

Параметр Тип Описание
id int ID рассылки

В случае успешного запроса вы получите ответ:

{
    "result": true
}