Документация по API v2

Быстрая навигация по API методам

Введение

Схема работы

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

whatsapp_send - отправить сообщение

Примеры кода:

$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 не передан."
}

whatsapp_send - отправить сообщение с файлом

Примеры кода:

$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 ключ

Ответ при успешном запросе:

{
  "result":0,
  "message_id":"1"
}

Ответ при не успешном запросе (Подробнее):

{
  "result":1,
  "result_description":"Параметр method не передан."
}

whatsapp_mailing - отправить рассылку

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"whatsapp_mailing","name":"Рассылка из API","text":"Тестовое сообщение","file_url":"https://api.sendapi.net/img/kp6.png","filter":{"phones":[77000000000,77000000001]},"api_id":"<app id>"}

Примеры кода:

$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 ключ

Ответ при успешном запросе:

{
  "result":0,
  "mailing_id":1
}

Ответ при не успешном запросе (Подробнее):

{
  "result":1,
  "result_description":"Параметр method не передан."
}

whatsapp_send_contact_card - отправить контакт

Примеры кода:

$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 не передан."
}

whatsapp_send_geolocation - отправить геопозицию

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"whatsapp_send_geolocation","phone":"77000000000","latitude":"53.284461","longitude":"69.378938","altitude":"5.5","accurate":"5.5","api_id":"<app id>"}

Примеры кода:

$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 ключ

Ответ при успешном запросе:

{
  "result":0,
  "message_id":"1"
}

Ответ при не успешном запросе (Подробнее):

{
  "result":1,
  "result_description":"Параметр method не передан."
}

whatsapp_message_list - получить список сообщений

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"whatsapp_message_list","message_id":"0","limit":"100","api_id":"<app id>"}

Пример на 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 не передан."
}

whatsapp_message_get - получить сообщение

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"whatsapp_message_get","message_id":"1","api_id":"<app id>"}

Пример на 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 не передан."
}

whatsapp_phone_list - получить список подписчиков

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"whatsapp_phone_list","phone_id":"0","limit":"100","api_id":"<app id>"}

Пример на 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 не передан."
}

whatsapp_phone_add - добавить подписчика (имеются ограничения на добавления новых подписчиков)

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"whatsapp_phone_add","phone":"77000000000","name":"Имя","contact_company":"0","api_id":"<app id>"}

Пример на 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 не передан."
}

whatsapp_phone_get - получить данные подписчика

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"whatsapp_phone_get","phone":"77000000000","api_id":"<app id>"}

Пример на 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 не передан."
}

whatsapp_unsubscribe - отписать подписчика от рассылки

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"whatsapp_unsubscribe","phone":"77000000000","api_id":"<app id>"}

Пример на 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 не передан."
}

whatsapp_group_list - получить список whatsapp групп

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"whatsapp_group_list","api_id":"<app id>"}

Пример на 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 не передан."
}

whatsapp_group_get - получить whatsapp группу

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"whatsapp_group_get","group_id":"whatsapp_group_*******","api_id":"<app id>"}

Пример на 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 не передан."
}

whatsapp_group_create - создать whatsapp группу

Пример на 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 не передан."
}

whatsapp_group_contact_set - добавить подписчиков в whatsapp группу

Пример на 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 не передан."
}

whatsapp_group_contact_del - удалить подписчиков из whatsapp группы

Пример на 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 не передан."
}

whatsapp_group_contact_set_as_admin - добавить права админа подписчику в whatsapp группе

Пример на 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 не передан."
}

contact_add - добавить подписчика с указанием канала

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"contact_add","phone":"77000000000","sp_numb":"0","name":"Имя","contact_company":"0","api_id":"<app id>"}

Пример на 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 не передан."
}

whatsapp_sender_get - Получить данные каналов

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"whatsapp_sender_get","api_id":"<app id>"}

Пример на 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 не передан."
}

chat_work_list - Получить список контактов в работе

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"chat_work_list","api_id":"<app id>"}

Пример на 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 не передан."
}

chat_work_update - Взять или закрыть диалог

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"chat_work_update","phone":"77000000000","operator_id":"10","action":"chat_in_work","api_id":"<app id>"}

Пример на 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 не передан."
}

chat_operator_online - Получить операторов онлаин

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"chat_operator_online","api_id":"<app id>"}

Пример на 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 не передан."
}

operation_mode - Получить режим работы

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"operation_mode","api_id":"<app id>"}

Пример на 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 не передан."
}

instagram_send_text - Отправить сообщение instagram

Пример на 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 не передан."
}

instagram_send_file - Отправить файл instagram

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 не передан."
}

telegram_send_text - Отправить сообщение telegram

Пример на 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 не передан."
}

telegram_send_file - Отправить файл telegram

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 не передан."
}

vk_send_text - Отправить сообщение vk

Пример на 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 не передан."
}

vk_send_file - Отправить файл vk

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 не передан."
}

facebook_send_text - Отправить сообщение facebook

Пример на 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 не передан."
}

facebook_send_file - Отправить файл facebook

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 не передан."
}

yandex_send_text - Отправить сообщение yandex

Пример на 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 не передан."
}

yandex_send_file - Отправить файл yandex

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 не передан."
}

viber_bot_send_text - Отправить сообщение viber_bot

Пример на 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 не передан."
}

viber_bot_send_file - Отправить файл viber_bot

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 не передан."
}

sendapi_send_text - Отправить сообщение sendapi

Пример на 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 не передан."
}

sendapi_send_file - Отправить файл sendapi

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 не передан."
}

whatsapp_biz_send_text - Отправить сообщение WhatsApp Business

Отправлять сообщение можно в интервале 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 не передан."
}

whatsapp_biz_send_file - Отправить файл WhatsApp Business

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 не передан."
}

whatsapp_biz_template_list - Получить шаблоны WhatsApp Business

Пример на PHP (с включенным модулем curl):

$data['json_data'] = json_encode([
  "method"  =>  "whatsapp_biz_template_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_biz_template_list	Получить шаблоны WhatsApp Business
api_id	да	Ваш API ключ

Ответ при успешном запросе:

{
  "result":0,
  "result_data":[
    {"sp_numb":0000,"phone_number":00000000000,"template_name":"template_1","template_message":"Сообщение","params_count":0}
  ]
}

Ответ при не успешном запросе (Подробнее):

{
  "result":1,
  "result_description":"Параметр method не передан."
}

whatsapp_biz_template_send - Отправить шаблон WhatsApp Business

$data['json_data'] = json_encode([
  "method"  =>  "whatsapp_biz_template_send",
  "phone"   => "whatsapp_biz_0000000000",
  "template_name" => "template_1",
  "template_params" => ["текст"],
  "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_template_send	Отправить шаблон WhatsApp Business
phone	да	Контакт WhatsApp Business. Формат whatsapp_biz_0000000000.
template_name	да	Название шаблона
template_params	да	Дополнительные данные шаблона
api_id	да	Ваш API ключ

Ответ при успешном запросе:

{
  "result":0,
  "message_id":"1",
  "user_balance": 0
}

Ответ при не успешном запросе (Подробнее):

{
  "result":1,
  "result_description":"Параметр method не передан."
}

channels_list - Список всех каналов

Возвращает список всех активных каналов (номеров) аккаунта с безопасными данными по всем доступным транспортам.

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

https://api.sendapi.net?json_data={"method":"channels_list","api_id":"<app id>"}

Пример на 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 не передан."
}

user_balance - Баланс пользователя

Примеры кода:

$data['json_data'] = json_encode([
  "method"  =>  "user_balance",
  "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: "user_balance",
    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': 'user_balance',
        '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	user_balance	Баланс пользователя
api_id	да	Ваш API ключ

Ответ при успешном запросе:

{
  "result":0,
  "user_balance": 0
}

Ответ при не успешном запросе (Подробнее):

{
  "result":1,
  "result_description":"Параметр method не передан."
}

webhook_status_update - Обновить статус вебхука

Данный метод так же подходит для разблокировки API, если была блокировка по причине длительных некорректных ответов на запросы по URL Web-хука. Необходимо в запросе указывать статус 'active'.

Пример на отправку сообщения через HTTP:

https://api.sendapi.net?json_data={"method":"webhook_status_update","status":"off","api_id":"<app id>"}

Пример на 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:

Новое входящее сообщение POST <Your webhook url>
Content-Type: application/json

Параметр	Значение/Тип	Описание
callback_status	new_inbox_message	Тип действия. Новое входящее сообщение
phone	string	Номер телефона
transport	string	Канал связи whatsapp
phone_number	string	Номер шлюз подключенный к системе
phone_id	int	ID шлюза подключенного к системе
message_id	int	ID сообщения
message_data	Array	Данные сообщения
user_id	int	ID клиента в системе
add_date	ISODate	Дата добавления
reverse_date	ISODate	Дата добавления

Взят в работу / Закончен диалог POST <Your webhook url>
Content-Type: application/json

Параметр	Значение/Тип	Описание
callback_status	chat_in_work/chat_out_of_work	Тип действия. chat_in_work - взят в работу. chat_out_of_work - диалог закончен
phone	string	Номер телефона
transport	string	Канал связи whatsapp
phone_number	string	Номер шлюз подключенный к системе
phone_id	int	ID шлюза подключенного к системе
hook_body_row	json	{operator_id:1}. ID оператора
user_id	int	ID клиента в системе
add_date	ISODate	Дата добавления
reverse_date	ISODate	Дата добавления

Статусы доставки сообщений для WhatsApp POST <Your webhook url>
Content-Type: application/json

Параметр

Значение/Тип

Описание

callback_status

set_delivery_status

Тип действия. Статус доставки отправленного сообщения изменился

delivery_status

string

Статус доставки на номера

Значение	Описание
4	Сообщение отправлено
5	Сообщение доставлено
13	Сообщение прочитано

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

Значение	Описание
4	Сообщение отправлено на номера всех участников
5	Сообщение доставлено на номера всех участников
13	Сообщение прочитано всеми участниками группы

phone

string

Номер телефона

transport

string

Канал связи WhatsApp

phone_number

string

Номер шлюз подключенный к системе

phone_id

int

ID шлюза подключенного к системе

user_id

int

ID клиента в системе

add_date

ISODate

Дата добавления

reverse_date

ISODate

Дата добавления

Загрузка...

Документация по API v2

Основные методы WhatsApp:

Управление сообщениями:

Группы WhatsApp:

Другие платформы:

Служебные методы:

Дополнительная информация:

Схема работы

Примеры кода:

Примеры кода:

Примеры кода:

Примеры кода:

Примеры кода:

Примеры кода:

Пример ответа с ошибкой:

Общие принципы обработки ошибок:

Варианты ответа:

Webhook