Документация по API v2
Схема работы
- Мы подключаем к системе номер телефона, от которого будут уходить сообщения.
- Вы выбираете тариф и оплачиваете его удобным для вас способом.
- Используя наше API осуществляете рассылку ваших сообщений.
Пример на отправку сообщения через HTTP:
Примеры кода:
$data['json_data'] = json_encode([
"method" => "whatsapp_send",
"phone" => "77000000000",
"text" => "Сообщение",
"file_url" => "https://secure.gravatar.com/avatar/7cab71edb0a4c12a1e64bbfdf46a3c64",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
const data = {
json_data: JSON.stringify({
method: "whatsapp_send",
phone: "77000000000",
text: "Сообщение",
file_url: "https://secure.gravatar.com/avatar/7cab71edb0a4c12a1e64bbfdf46a3c64",
api_id: "<app id>"
})
};
fetch("https://api.sendapi.net", {
method: "POST",
headers: {
"Content-Type": "application/x-www-form-urlencoded"
},
body: new URLSearchParams(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error("Error:", error));
import requests
import json
data = {
'json_data': json.dumps({
'method': 'whatsapp_send',
'phone': '77000000000',
'text': 'Сообщение',
'file_url': 'https://secure.gravatar.com/avatar/7cab71edb0a4c12a1e64bbfdf46a3c64',
'api_id': '<app id>'
})
}
response = requests.post('https://api.sendapi.net', data=data)
result = response.json()
print(result)
- Адрес:
- https://api.sendapi.net
- Метод:
- POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_send Отправить сообщение Whatsapp phone да Номер телефона получателя или ID Whatsapp-группы text да Текст сообщения в кодировке UTF-8 api_id да Ваш API ключ - Ответ при успешном запросе:
-
При успешном запросе будет возвращен ID отправленного сообщения по которому в дальнейшем можно получить его статус.
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Примеры кода:
$file_path = 'абсолютный путь /12019526947.jpg';
if (function_exists('curl_file_create')) { // php 5.5+
$cFile = curl_file_create($file_path);
} else {
$cFile = '@' . realpath($file_path);
}
$data['json_data'] = json_encode([
'method' => 'whatsapp_send',
'phone' => '77000000000',
'text' => 'файл 3',
'api_id' => '<app id>'
]);
$data['file'] = $cFile;
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
const formData = new FormData();
const fileInput = document.getElementById('fileInput'); // HTML input type="file"
formData.append('json_data', JSON.stringify({
method: 'whatsapp_send',
phone: '77000000000',
text: 'файл 3',
api_id: '<app id>'
}));
formData.append('file', fileInput.files[0]);
fetch('https://api.sendapi.net', {
method: 'POST',
body: formData
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));
import requests
import json
file_path = '/path/to/your/file.jpg'
data = {
'json_data': json.dumps({
'method': 'whatsapp_send',
'phone': '77000000000',
'text': 'файл 3',
'api_id': '<app id>'
})
}
files = {
'file': open(file_path, 'rb')
}
response = requests.post('https://api.sendapi.net', data=data, files=files)
result = response.json()
print(result)
- Адрес:
- https://api.sendapi.net
- Метод:
- POST
- Параметры для file:
-
Данные передаваемого файла - Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_send Отправить сообщение Whatsapp phone да Номер телефона получателя text нет Текст сообщения в кодировке UTF-8 api_id да Ваш API ключ - Ответ при успешном запросе:
-
При успешном запросе будет возвращен ID отправленного сообщения по которому в дальнейшем можно получить его статус.
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Примеры кода:
$data['json_data'] = json_encode([
"method" => "whatsapp_mailing",
"name" => "Рассылка из API",
"text" => "Тестовое сообщение",
"file_url" => "https://api.sendapi.net/img/kp6.png",
"filter" => ["phones" => [77000000000,77000000001]],
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
const data = {
json_data: JSON.stringify({
method: "whatsapp_mailing",
name: "Рассылка из API",
text: "Тестовое сообщение",
file_url: "https://api.sendapi.net/img/kp6.png",
filter: {
phones: [77000000000, 77000000001]
},
api_id: "<app id>"
})
};
fetch("https://api.sendapi.net", {
method: "POST",
headers: {
"Content-Type": "application/x-www-form-urlencoded"
},
body: new URLSearchParams(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error("Error:", error));
import requests
import json
data = {
'json_data': json.dumps({
'method': 'whatsapp_mailing',
'name': 'Рассылка из API',
'text': 'Тестовое сообщение',
'file_url': 'https://api.sendapi.net/img/kp6.png',
'filter': {
'phones': [77000000000, 77000000001]
},
'api_id': '<app id>'
})
}
response = requests.post('https://api.sendapi.net', data=data)
result = response.json()
print(result)
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_mailing Отправить рассылку Whatsapp name да Наименование рассылки text да (обязателен если не указан file_url) Текст сообщения в кодировке UTF-8. Ограничения от 10 до 2000 символов file_url да (обязателен если не указан text) Ссылка на файл filter да Фильтр, данные в JSON формате, JSON не должен быть пустым. Доступные параметры:
• phones - массив номеров телефонов, минимальное кол-во 2 номера: [77010000000,77010000001];
• category - 'all' или id категории;
• date_registration - дата добавления номера в JSON формате: {"from":"2019-01-01 00:00:00","to":"2019-01-31 23:59:59"};
• date_active - дата активности номера в JSON формате: {"from":"2019-01-01 00:00:00","to":"2019-01-31 23:59:59"};
Параметр phones имеет приоритетный уровень, если он указан другие параметры не участвуют в фильтрации
Рассылка отправляется только на номера со статусом Подписан
Примеры:
{"category":"all","date_registration":{"from":"2019-01-01 00:00:00","to":"2019-01-31 23:59:59"}
{"phones":[77010000000,77010000001]}
{"category":"all"}send_date нет Дата когда необходимо запустить рассылку [формат: 2019-02-03 00:00:00]. Если не передана, рассылка запускается сразу api_id да Ваш API ключ - Ответ при успешном запросе:
-
При успешном запросе будет возвращен ID отправленного сообщения по которому в дальнейшем можно получить его статус.
{ "result":0, "mailing_id":1 } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Примеры кода:
$file_path = 'абсолютный путь /12015426947.jpg';
if (function_exists('curl_file_create')) { // php 5.5+
$cFile = curl_file_create($file_path);
} else {
$cFile = '@' . realpath($file_path);
}
$data['json_data'] = json_encode([
'method' => 'whatsapp_send_contact_card',
'phone' => '77000000000',
'api_id' => '<app id>',
'contact_phone' => '77000000000',
'contact_name' => 'Имя контакта',
'file_url' => 'https://api.sendapi.net/img/kp6.png',
]);
$data['contact_logo_image'] = $cFile;
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
const formData = new FormData();
formData.append('json_data', JSON.stringify({
method: 'whatsapp_send_contact_card',
phone: '77000000000',
api_id: '<app id>',
contact_phone: '77000000000',
contact_name: 'Имя контакта',
file_url: 'https://api.sendapi.net/img/kp6.png'
}));
// Если есть файл логотипа контакта
const fileInput = document.getElementById('logoInput');
if (fileInput && fileInput.files[0]) {
formData.append('contact_logo_image', fileInput.files[0]);
}
fetch('https://api.sendapi.net', {
method: 'POST',
body: formData
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));
import requests
import json
data = {
'json_data': json.dumps({
'method': 'whatsapp_send_contact_card',
'phone': '77000000000',
'api_id': '<app id>',
'contact_phone': '77000000000',
'contact_name': 'Имя контакта',
'file_url': 'https://api.sendapi.net/img/kp6.png'
})
}
# Если есть файл логотипа контакта
files = {}
logo_path = '/path/to/contact/logo.jpg' # путь к файлу логотипа
try:
files['contact_logo_image'] = open(logo_path, 'rb')
except FileNotFoundError:
pass
response = requests.post('https://api.sendapi.net', data=data, files=files)
result = response.json()
print(result)
- Адрес:
- https://api.sendapi.net
- Метод:
- POST
- Параметры для file:
-
Данные передаваемого файла - Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_send_contact_card Отправить сообщение Whatsapp phone да Номер телефона получателя contact_phone да Номер телефона, который передается в контакте contact_name да Имя контакта logo_id да, если не указан параметр contact_logo_image ID логотипа, который становится известен после загрузки логотипа через параметр contact_logo_image. [Параметр устарел используйте file_url] file_url да, если не указан параметр contact_logo_image Url на картинку. Формат изображения jpg, jpeg, png. Пример: https://api.sendapi.net/img/kp6.png api_id да Ваш API ключ - Параметры для contact_logo_image:
-
contact_logo_image да, если не указан параметр logo_id; если указан параметр logo_id, загружаемый файл будет игнорироваться. Внимание: разрешен к отправке только формат изображения jpg, jpeg. Параметр, в который нужно загружать файл - Ответ при успешном запросе:
-
При успешном возвращается только статус отправки.
{ "result":0, } - Ответ при успешном запросе, когда передан contact_logo_image:
-
При успешном возвращается статус отправки и ID логотипа, который можно далее подставлять к параметру logo_id.
{ "result":0, "logo_id":"100" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Примеры кода:
$data['json_data'] = json_encode([
"method" => "whatsapp_send_geolocation",
"phone" => "77000000000",
"latitude" => "53.284461",
"longitude" => "69.378938",
"altitude" => "5.5",
"accurate" => "5.5",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
const data = {
json_data: JSON.stringify({
method: "whatsapp_send_geolocation",
phone: "77000000000",
latitude: "53.284461",
longitude: "69.378938",
altitude: "5.5",
accurate: "5.5",
api_id: "<app id>"
})
};
fetch("https://api.sendapi.net", {
method: "POST",
headers: {
"Content-Type": "application/x-www-form-urlencoded"
},
body: new URLSearchParams(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error("Error:", error));
import requests
import json
data = {
'json_data': json.dumps({
'method': 'whatsapp_send_geolocation',
'phone': '77000000000',
'latitude': '53.284461',
'longitude': '69.378938',
'altitude': '5.5',
'accurate': '5.5',
'api_id': '<app id>'
})
}
response = requests.post('https://api.sendapi.net', data=data)
result = response.json()
print(result)
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_send Отправить сообщение Whatsapp phone да Номер телефона получателя text да Текст сообщения в кодировке UTF-8 api_id да Ваш API ключ - Ответ при успешном запросе:
-
При успешном запросе будет возвращен ID отправленного сообщения по которому в дальнейшем можно получить его статус.
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_message_list",
"message_id" => "0",
"limit" => "100",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_message_list Получить список сообщений Whatsapp message_id нет ID сообщения. По умолчанию 0. phone нет Номер телефона limit нет Кол-во записей за запрос. По умолчанию 50. api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_data":[{ "message_id":1, "message_route":"inbox", "message_type":"message-chat", "message_text":"123", "message_quoted":null, "phone":"7700****000", "file_url":null, "phone_id":426, "add_date":"2019-11-28 16:44:09", "transport_ph_numb":777****6224}] } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_message_get",
"message_id" => "1",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_message_get Получить статус сообщения message_id да Номер сообщения api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_data":[массив данных] } - Ответ при не успешном запросе:
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_phone_list",
"phone_id" => "0",
"limit" => "100",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_phone_list Получить список сообщений Whatsapp phone_id нет ID телефона. По умолчанию 0. limit нет Кол-во записей за запрос. По умолчанию 50. api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_data":[массив данных] } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_phone_add",
"phone" => "77000000000",
"name" => "Имя",
"contact_company" => "0",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_phone_get Получить статус сообщения phone да Номер подписчика name нет Имя подписчика contact_company нет Отправлять или нет контакт компании пользователю. 1 - отправлять, 0 - не отправлять api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_data":[массив данных] } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_phone_get",
"phone" => "77000000000",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_phone_get Получить статус сообщения phone да Номер подписчика api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_data":[массив данных] } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_unsubscribe",
"phone" => "77000000000",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_unsubscribe Отписать подписчика от рассылки phone да Номер подписчика api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_description":"Подписчик отписан." } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_list",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_group_list Получить список whatsapp групп api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "groups": [ { "adminCheck":false, "admins":["77*********"], "subscribers":["77*********","77*********","77*********"], "group_id":"whatsapp_group_********-********", "name":"Тест группа" } ] } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_get",
"group_id"=> "whatsapp_group_*******",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_group_get Получить whatsapp группу group_id да id группы api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "group":{ "adminCheck":false, "admins":["77*********"], "subscribers":["77*********","77*********","77*********"], "group_id":"whatsapp_group_********-********", "name":"Тест группа" } } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_create",
"sp_numb" => "1",
"group_name" => "Тест группа",
"subscribers"=> ['7700*******'],
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_group_create Создать whatsapp группу. Данный метод создает задачу на создание группы. Группа появится только после выполнения задачи. Время выполнения задачи зависит о нагружености канала. sp_numb да id канала, можно получить через метод whatsapp_sender_get group_name да Наименование группы subscribers да Массив подписчиков api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_description":"Задача на создание группы подана успешно. Ожидайте появления группы в списке групп." } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_contact_set",
"group_id" => "whatsapp_group_*******",
"subscribers"=> ['7700*******'],
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_group_contact_set Данный метод создает задачу на добавление подписчиков в группу. Подписчики появится только после выполнения задачи. Время выполнения задачи зависит о нагружености канала. group_id да id группы subscribers да Массив подписчиков api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_description":"Задача на добавление контактов в группу подана успешно." } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_contact_del",
"group_id" => "whatsapp_group_*******",
"subscribers"=> ['7700*******'],
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_group_contact_del Данный метод создает задачу на удаление подписчиков из группы. Подписчики удалятся только после выполнения задачи. Время выполнения задачи зависит о нагружености канала. group_id да id группы subscribers да Массив подписчиков api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_description":"Задача на удаление контактов из группу подана успешно." } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_contact_set_as_admin",
"group_id" => "whatsapp_group_*******",
"subscriber" => "7700*******",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_group_contact_set_as_admin Данный метод создает задачу на дабавление права админа подписчику в группе. Время выполнения задачи зависит о нагружености канала. group_id да id группы subscriber да Номер подписчика api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_description":"Задача на добавление прав админа подана успешно." } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "contact_add",
"phone" => "77000000000",
"sp_numb" => "0",
"name" => "Имя",
"contact_company" => "0",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method contact_add Добавить подписчика с указанием канала phone да Номер подписчика sp_numb да Id канала, можно получить через метод whatsapp_sender_get name нет Имя подписчика contact_company нет Отправлять или нет контакт компании пользователю. 1 - отправлять, 0 - не отправлять api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "phone" : "whatsapp_biz_77000000000", // Вернет номер в формате в зависимости от канала "sp_numb" : 0, "result_description" : "Подписчик добавлен." } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_sender_get",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_sender_get Получить данные каналов api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_data":[] } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "chat_work_list",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method chat_work_list Получить список контактов в работе api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_data":[] } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "chat_work_update",
"phone" => "77000000000",
"operator_id" => "10",
"action" => "chat_in_work"
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method chat_work_update Взять или закрыть диалог phone да Контакт operator_id да ID оператора action да chat_in_work - Взять в работу, chat_out_of_work - зыкрыть диалог api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "chat_operator_online",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method chat_operator_online Получить операторов онлаин api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_data":[] } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "operation_mode",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method operation_mode Получить режим работы api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "result_data":[] } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "instagram_send_text",
"phone" => "instagram_0000000000",
"text" => "Сообщение",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method instagram_send_text Отправить сообщение instagram phone да Контакт instagram. Формат instagram_0000000000. text да Текст сообщения api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
1. Отправка файла ссылкой. Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "instagram_send_file",
"phone" => "instagram_0000000000",
"file_url"=> "https://api.sendapi.net/img/kp6.png",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
2. Отправка файлом. Пример на PHP (с включенным модулем curl):
$file_path = 'абсолютный путь /12019526947.jpg';
if (function_exists('curl_file_create')) { // php 5.5+
$cFile = curl_file_create($file_path);
} else {
$cFile = '@' . realpath($file_path);
}
$data['json_data'] = json_encode([
'method' => 'instagram_send_file',
'phone' => 'instagram_0000000000',
'api_id' => '<app id>'
]);
$data['file'] = $cFile;
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method instagram_send_file Отправить файл instagram phone да Контакт instagram. Формат instagram_0000000000. file_url да Ссылка на файл, обязательна если не прикреплен файл к запросу api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "telegram_send_text",
"phone" => "telegram_0000000000",
"text" => "Сообщение",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
Отправка первым сообщением по @username
Если контакт ещё не добавлен в канал, можно вместо `phone` указать `tg_login` и `sp_numb` (идентификатор канала). Сервер попытается разрешить `@username` через Telegram-gateway, автоматически создать/проверить подписку в указанном `sp_numb` и затем отправить сообщение.
$data['json_data'] = json_encode([
"method" => "telegram_send_text",
"sp_numb" => 123,
"tg_login"=> "@username",
"text" => "Привет! Это первое сообщение.",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
Примечания:
- Валидация `tg_login`: логин должен соответствовать шаблону
^@[a-zA-Z][a-zA-Z0-9_]{4,31}$. - sp_numb — это идентификатор канала (phone_id / smap id). Указанный канал должен иметь настроенный Telegram-слот (tg_v2_slot_id).
- Если при отправке сообщение не уходит и возвращается код ошибки, проверьте корректность `tg_login`, доступность Telegram-gateway и наличие `sp_numb`.
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method telegram_send_text Отправить сообщение telegram phone да Контакт telegram. Формат telegram_0000000000. text да Текст сообщения api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
1. Отправка файла ссылкой. Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "telegram_send_file",
"phone" => "telegram_0000000000",
"file_url"=> "https://api.sendapi.net/img/kp6.png",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
2. Отправка файлом. Пример на PHP (с включенным модулем curl):
$file_path = 'абсолютный путь /12019526947.jpg';
if (function_exists('curl_file_create')) { // php 5.5+
$cFile = curl_file_create($file_path);
} else {
$cFile = '@' . realpath($file_path);
}
$data['json_data'] = json_encode([
'method' => 'telegram_send_file',
'phone' => 'telegram_0000000000',
'api_id' => '<app id>'
]);
$data['file'] = $cFile;
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method telegram_send_file Отправить файл telegram phone да Контакт telegram. Формат telegram_0000000000. file_url да Ссылка на файл, обязательна если не прикреплен файл к запросу api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "vk_send_text",
"phone" => "vk_0000000000",
"text" => "Сообщение",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method vk_send_text Отправить сообщение vk phone да Контакт vk. Формат vk_0000000000. text да Текст сообщения api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
1. Отправка файла ссылкой. Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "vk_send_file",
"phone" => "vk_0000000000",
"file_url"=> "https://api.sendapi.net/img/kp6.png",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
2. Отправка файлом. Пример на PHP (с включенным модулем curl):
$file_path = 'абсолютный путь /12019526947.jpg';
if (function_exists('curl_file_create')) { // php 5.5+
$cFile = curl_file_create($file_path);
} else {
$cFile = '@' . realpath($file_path);
}
$data['json_data'] = json_encode([
'method' => 'vk_send_file',
'phone' => 'vk_0000000000',
'api_id' => '<app id>'
]);
$data['file'] = $cFile;
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method vk_send_file Отправить файл vk phone да Контакт vk. Формат vk_0000000000. file_url да Ссылка на файл, обязательна если не прикреплен файл к запросу api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "facebook_send_text",
"phone" => "facebook_0000000000",
"text" => "Сообщение",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method facebook_send_text Отправить сообщение facebook phone да Контакт facebook. Формат facebook_0000000000. text да Текст сообщения api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
1. Отправка файла ссылкой. Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "facebook_send_file",
"phone" => "facebook_0000000000",
"file_url"=> "https://api.sendapi.net/img/kp6.png",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
2. Отправка файлом. Пример на PHP (с включенным модулем curl):
$file_path = 'абсолютный путь /12019526947.jpg';
if (function_exists('curl_file_create')) { // php 5.5+
$cFile = curl_file_create($file_path);
} else {
$cFile = '@' . realpath($file_path);
}
$data['json_data'] = json_encode([
'method' => 'facebook_send_file',
'phone' => 'facebook_0000000000',
'api_id' => '<app id>'
]);
$data['file'] = $cFile;
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method facebook_send_file Отправить файл facebook phone да Контакт facebook. Формат facebook_0000000000. file_url да Ссылка на файл, обязательна если не прикреплен файл к запросу api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "yandex_send_text",
"phone" => "yandex_0000000000",
"text" => "Сообщение",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method yandex_send_text Отправить сообщение yandex phone да Контакт yandex. Формат yandex_0000000000. text да Текст сообщения api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
1. Отправка файла ссылкой. Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "yandex_send_file",
"phone" => "yandex_0000000000",
"file_url"=> "https://api.sendapi.net/img/kp6.png",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
2. Отправка файлом. Пример на PHP (с включенным модулем curl):
$file_path = 'абсолютный путь /12019526947.jpg';
if (function_exists('curl_file_create')) { // php 5.5+
$cFile = curl_file_create($file_path);
} else {
$cFile = '@' . realpath($file_path);
}
$data['json_data'] = json_encode([
'method' => 'yandex_send_file',
'phone' => 'yandex_0000000000',
'api_id' => '<app id>'
]);
$data['file'] = $cFile;
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method yandex_send_file Отправить файл yandex phone да Контакт yandex. Формат yandex_0000000000. file_url да Ссылка на файл, обязательна если не прикреплен файл к запросу api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "viber_bot_send_text",
"phone" => "viber_bot_0000000000",
"text" => "Сообщение",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method viber_bot_send_text Отправить сообщение viber_bot phone да Контакт viber_bot. Формат viber_bot_0000000000. text да Текст сообщения api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
1. Отправка файла ссылкой. Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "viber_bot_send_file",
"phone" => "viber_bot_0000000000",
"file_url"=> "https://api.sendapi.net/img/kp6.png",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
2. Отправка файлом. Пример на PHP (с включенным модулем curl):
$file_path = 'абсолютный путь /12019526947.jpg';
if (function_exists('curl_file_create')) { // php 5.5+
$cFile = curl_file_create($file_path);
} else {
$cFile = '@' . realpath($file_path);
}
$data['json_data'] = json_encode([
'method' => 'viber_bot_send_file',
'phone' => 'viber_bot_0000000000',
'api_id' => '<app id>'
]);
$data['file'] = $cFile;
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method viber_bot_send_file Отправить файл viber_bot phone да Контакт viber_bot. Формат viber_bot_0000000000. file_url да Ссылка на файл, обязательна если не прикреплен файл к запросу api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "sendapi_send_text",
"phone" => "sendapi_0000000000",
"text" => "Сообщение",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method sendapi_send_text Отправить сообщение sendapi phone да Контакт sendapi. Формат sendapi_0000000000. text да Текст сообщения api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
1. Отправка файла ссылкой. Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "sendapi_send_file",
"phone" => "sendapi_0000000000",
"file_url"=> "https://api.sendapi.net/img/kp6.png",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
2. Отправка файлом. Пример на PHP (с включенным модулем curl):
$file_path = 'абсолютный путь /12019526947.jpg';
if (function_exists('curl_file_create')) { // php 5.5+
$cFile = curl_file_create($file_path);
} else {
$cFile = '@' . realpath($file_path);
}
$data['json_data'] = json_encode([
'method' => 'sendapi_send_file',
'phone' => 'sendapi_0000000000',
'api_id' => '<app id>'
]);
$data['file'] = $cFile;
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method sendapi_send_file Отправить файл sendapi phone да Контакт sendapi. Формат sendapi_0000000000. file_url да Ссылка на файл, обязательна если не прикреплен файл к запросу api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Отправлять сообщение можно в интервале 24 часа после последнего входящего сообщения от контакта.
Узнать, прошло ли 24 часа и есть ли еще возможность отправить сообщение Вы можете воспользовавшись
методом whatsapp_phone_get в параметре inbox_time (время отображается в
секундах).
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_biz_send_text",
"phone" => "whatsapp_biz_0000000000",
"text" => "Сообщение",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_biz_send_text Отправить сообщение WhatsApp Business phone да Контакт WhatsApp Business. Формат whatsapp_biz_0000000000. text да Текст сообщения api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
1. Отправка файла ссылкой. Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "whatsapp_biz_send_file",
"phone" => "whatsapp_biz_0000000000",
"file_url"=> "https://api.sendapi.net/img/kp6.png",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
2. Отправка файлом. Пример на PHP (с включенным модулем curl):
$file_path = 'абсолютный путь /12019526947.jpg';
if (function_exists('curl_file_create')) { // php 5.5+
$cFile = curl_file_create($file_path);
} else {
$cFile = '@' . realpath($file_path);
}
$data['json_data'] = json_encode([
'method' => 'whatsapp_biz_send_file',
'phone' => 'whatsapp_biz_0000000000',
'api_id' => '<app id>'
]);
$data['file'] = $cFile;
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method whatsapp_biz_send_file Отправить файл WhatsApp Business phone да Контакт WhatsApp Business. Формат whatsapp_biz_0000000000. file_url да Ссылка на файл, обязательна если не прикреплен файл к запросу api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0, "message_id":"1" } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
Возвращает список всех активных каналов (номеров) аккаунта с безопасными данными по всем доступным транспортам.
Пример запроса через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "channels_list",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method channels_list Получить список каналов api_id да Ваш API ключ - Поля в result_data:
-
Поле Тип Описание sp_numb int ID канала (используется в параметре sp_numb при отправке) phone_number string Номер телефона / идентификатор канала transport string Тип транспорта: whatsapp, telegram, instagram, vk, facebook, viber_bot, other active_status string Статус канала (on — активен) priority int|null Приоритет канала (меньше = выше приоритет) - Ответ при успешном запросе:
-
{ "result": 0, "result_data": [ { "sp_numb": 123, "transport": "whatsapp", "active_status": "on", "priority": 1 }, { "sp_numb": 456, "phone_number": "79007654321", "transport": "telegram", "active_status": "on", "priority": 2 } ] } - Ответ при не успешном запросе (Подробнее):
-
{ "result": 1, "result_description": "Параметр method не передан." }
Данный метод так же подходит для разблокировки API, если была блокировка по причине длительных некорректных ответов на запросы по URL Web-хука. Необходимо в запросе указывать статус 'active'.
Пример на отправку сообщения через HTTP:
Пример на PHP (с включенным модулем curl):
$data['json_data'] = json_encode([
"method" => "webhook_status_update",
"status" => "off", // доступные статусы: 'active', 'off'
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Адрес:
- https://api.sendapi.net
- Метод:
- GET, POST
- Параметры для json_data:
-
Параметр Обязательный Описание method webhook_status_update Обновить статус вебхука status да Доступные статусы: active, timeout, off. api_id да Ваш API ключ - Ответ при успешном запросе:
-
{ "result":0 } - Ответ при не успешном запросе (Подробнее):
-
{ "result":1, "result_description":"Параметр method не передан." }
При возникновении ошибок API возвращает JSON ответ с полем result не равным 0 и описанием ошибки в поле result_description.
Пример ответа с ошибкой:
{
"result": 1,
"result_description": "Параметр method не передан."
}
Общие принципы обработки ошибок:
- Всегда проверяйте поле
resultв ответе - При
result != 0обрабатывайте ошибку согласно описанию вresult_description - Реализуйте повторные попытки для временных ошибок (коды 42, 6, 72)
- Проверяйте корректность передаваемых параметров перед отправкой запроса
Варианты ответа:
| Ответ | Описание |
|---|---|
| 0 | Успешный результат |
| 1 | Ошибка |
| 11 | Не корректный параметр method. |
| 2 | Параметр phone не передан. |
| 21 | Не корректный параметр phone. |
| 22 | Подписчик не найден. |
| 23 | Подписчик отписан или не обработан. |
| 24 | Не удалось обновить данные подписчика. |
| 3 | Параметр text не передан. |
| 31 | Не корректный параметр text. |
| 32 | Превышена длина сообщения. Максимальная длина 2000 символов. Отправляйте большие сообщения через POST. |
| 4 | Параметр api_id не передан. |
| 41 | Не корректный параметр api_id. |
| 42 | Системная ошибка. Обратитесь в службу поддержки. |
| 5 | Параметр message_id не передан. |
| 51 | Не корректный параметр message_id. |
| 52 | Не удалось получить массив сообщений. |
| 6 | Не удалось создать задание на отправку сообщения. |
| 61 | Данные не найдены. |
| 62 | Необходимо приобрести или оплатить тариф. |
| 71 | Отправители не найдены. |
| 72 | Отправители переполнены. |
Webhook
Настроить ссылку для Webhook можно на странице Настройки API
Действия по которым срабатывает Webhook: