Для использования API вы должны знать свой API KEY, который можно посмотреть в своем профиле.
Система проста — вы посылаете POST запрос с нужной информацией в формате JSON на специальный адрес. Все данные отправляются и возвращаются в кодировке UTF-8.
Адрес: http://api.client24.ru/METHOD_NAME?api_key=API_KEY
Вы можете воспользоваться нашим классом для отправки запросов, если используете PHP.
send_sms — отправка SMS сообщений
status_sms — получение статуса SMS сообщений
send_email — отправки e-mail сообщений
status_email — получение статуса e-mail сообщений
create_delivery — создание новой рассылки по базе клиентов
send_delivery — запуск уже созданной рассылки
status_delivery — получение статистики рассылки
{
"info":{
"from":"MegaShop",
"tag":"user-register",
"shortlink":1
}
"data":[
{
"to":"79161234567",
"text":"Спасибо за регистрацию в MegaShop! Наши контакты: тел. (495) 123 45 67, megashop.ru",
"otherid":"reg8255"
},
{
"to":"+7 (916) 123-45-68",
"text":"Спасибо за регистрацию в MegaShop! Наши контакты: тел. (495) 123 45 67, megashop.ru",
"otherid":"reg8256"
}
]
}
Параметр shortlink служит для сокращения ссылок в вид cl24.ru/A1b2C3d4. При отключении сокращения ссылок статистика по переходам в SMS-сообщениях собираться не будет!
{
"info":{
"from_name":"MegaShop",
"delivery_id":7681
},
"data":[
{
"to":"79161234567",
"id":2000071837054,
"otherid":"reg8255"
},
{
"to":"+7 (916) 123-45-68",
"id":2000071837212,
"otherid":"reg8256"
}
],
"status":"ok"
}
Внимание! Ранее вместо id использовался ключ sid!
В последствии, используя id или otherid (если идентификатор был указан при отправке), получить статус отправки сообщений. Получение статусов доступно для сообщений, отправленных в текущем и предыдущем календарном месяцах.
Внимание! Параметр otherid должен быть уникальным для каждого отправляемого сообщения и не может быть длиннее 50 символов. При запросе статуса по otherid будут возвращены все сообщения с otherid равным переданному значению без учета регистра. Используя этот параметр можно полностью синхронизировать работу вашей базы с Client24.
[
{
"id":2000071837054
},
{
"otherid":"reg8256"
}
]
В данном примере будет получен статус по otherid и по id одновременно. Возможны любые комбинации. При наличии обоих параметров будет использован id.
{
"data":[
{
"id":"2000071837054",
"otherid":"reg8255",
"phone":"79161234567",
"delivered":"2013-01-01 12:00:00",
"status":1
},
{
"otherid":"reg8256",
"phone":"79161234568",
"delivered":"2013-01-01 12:00:00",
"clicked":"2013-01-01 12:01:00",
"status":4
}
],
"status":"ok"
}
0 — отправлено
1 — доставлено
2 — не доставлено
3 — ошибка
4 — кликнуто
5 — не отправлено
{
"info":{
"from":"info@megashop.com",
"from_name":"MegaShop",
"tag":"email-reg",
},
"data":[
{
"to":"ivan.ivanov@mail.ru",
"to_name":"Иван Иванов",
"subject":"Регистрация на MegaShop успешно завершена!",
"text":"Иван, поздравляем!\\r\\nВаша регистрация на MegaShop успешно завершена!",
"otherid":"reg8255"
},
{
"to":"ivan.petrov@mail.ru",
"to_name":"Иван Петров",
"subject":"Регистрация на MegaShop успешно завершена!",
"text":"<h1>Иван, поздравляем!</h1><p>Ваша регистрация на MegaShop успешно завершена!</p><a href='http://megashop.com'>MegaShop</a>",
"otherid":"reg8256"
},
]
}
info — необязательный блок параметровТекст сообщений может передаваться как обычным текстом, так и в виде HTML. Во втором случае все ссылки, «обернутые» в тэг <a>, будут автоматически отслеживаться и учитываться в статистике.
{
"info":{
"from":"info@megashop.com",
"from_name":"MegaShop",
"delivery_id":7684
},
"data":[
{
"to":"ivav.ivanov@mail.ru",
"id":2000071398521,
"otherid":"regsms8255"
},
{
"to":"ivav.petrov@mail.ru",
"id":2000071398672,
"otherid":"regsms8256"
}
],
"status":"ok"
}
[
{
"id":2000071398521
},
{
"otherid":"regsms8256"
}
]
В данном примере будет получен статус по otherid и по id одновременно. Возможны любые комбинации. При наличии обоих параметров будет использован id.
{
"data":[
{
"id":"2000071398521",
"otherid":"regsms8255",
"email":"ivav.ivanov@mail.ru",
"opened":"2013-01-01 12:00:00",
"status":1
},
{
"otherid":"regsms8256",
"email":"ivav.petrov@mail.ru",
"opened":"2013-01-01 12:00:00",
"clicked":"2013-01-01 12:01:00",
"status":2
}
],
"status":"ok"
}
E-mail
0 — отправлено
1 — прочитано
2 — кликнуто
3 — не доставлено
4 — получатель отписался
Метод для создания (подготовки) новой рассылки для последующей отправки. В ответе на этот запрос возвращается количество клиентов, email-адресов и телефонов, которые попадают под эту рассылку.
{
"type":"email",
"params":{
"name":"Поздравление с Новым Годом",
"subject":"MegaShop поздравляет Вас с Новым Годом!",
"text":"<h1>[Имя]!</h1><p>MegaShop поздравляет Вас с Новым Годом!</p>",
"filter":{
"tagIds":[627,783,1873],
"fields":{
"first_name":{
"operator":"=",
"value":"Иван"
},
"email:{
"operator":"contains",
"value":"@mail.ru"
}
}
}
"sender_email_id":412,
"sender_name_id":425,
"template_id":1031,
"send_time":"2014-01-01 00-00-00"
}
}
Некоторые операторы недоступны для отдельных полей с определенными типами данных.
{
"delivery":{
"delivery_id":1089,
"clients":231000,
"emails":233500,
"phones":235000
},
"status":"ok"
}
Метод отправки уже созданной (через API-запрос или личный кабинет) рассылки.
{
"delivery_id":1089,
}
{
"data":{
"delivery_id":1089,
"status":"Processing",
},
"status":"ok"
}
Получение статистики по отправленной или отправляемой в данный момент рассылке.
{
"delivery_id":1089,
}
{
"stats":{
"full":{
"emails":233500,
"clients":231000,
"sent":233500,
"undelivered":500,
"opened":50000,
"clicked":25000,
"unsubscribed":1500
}
"clicks":{
"click_1":15500,
"click_2":5000,
"click_3":3500,
"click_5":2500
}
"detail":{
"opened":{
"2014-01-01":40000,
"2014-01-02":8000,
"2014-01-03":7000
},
"clicked":{
"2014-01-01":20000,
"2014-01-02":4000,
"2014-01-03":3000
},
"unsubscribed":{
"2014-01-01":1000,
"2014-01-02":300,
"2014-01-03":200
}
}
"status":"ok"
}
$api = new client24api("880470ashINioo9sah92183");
$api->send_email(
array(
"info" => array(
"from" => "company2288@gmail.com",
"from_name" => "Company"
),
"data" => array(
array(
"to" => "address@gmail.com",
"subject" => "hello this is theme!",
"text" => "hello this is text!"
),
array(
"to" => "address@gmail.com",
"subject" => "hello this is theme!2",
"text" => "hello this is text!2"
),
)
)
);
$api = new client24api("880470ashINioo9sah92183");
$api->status_sms(
array(
array(
"id" => 876
),
array(
"id" => 222
)
)
);