API v2 құжаттамасы — SendAPI.net

Жұмыс сызбасы

  1. Біз жүйеге хабарламалар жіберілетін телефон нөмірін қосамыз.
  2. Сіз тарифті таңдап, оған өзіңізге ыңғайлы тәсілмен төлейсіз.
  3. Біздің API арқылы хабарламаларыңызды таратасыз.
Код мысалдары:
$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 иә Алушының телефон нөмірі немесе WhatsApp тобының ID
text иә (file_url көрсетілмесе міндетті) UTF-8 кодтауындағы хабарлама мәтіні
file_url иә (text көрсетілмесе міндетті) Файлға сілтеме
smap_number жоқ Хабарлама жіберілетін WhatsApp арнаңыздың нөмірі; контакт осы арнаға бекітіледі. Көрсетілмесе, арнаны жүйе таңдайды
mark_read жоқ true — жіберілгеннен кейін операторлар чатында диалогты оқылған деп белгілеу
operator_id жоқ Хабарлама атынан жіберілетін аккаунт қызметкерінің id-і («Қызметкерлер» бөлімі): нөлден үлкен бүтін сан. Берілмесе — аккаунт иесінің атынан. Осы аккаунттың қызметкері емес, жойылған немесе бұғатталған болса — жіберусіз бас тарту (result 2)
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 арқылы хабарлама жіберу мысалы:

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 кілтіңіз
Сәтті сұраудағы жауап:

Сұрау сәтті болса, жіберілген хабарламаның 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 арқылы хабарлама жіберу мысалы:

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_geolocation WhatsApp геопозициясын жіберу
phone иә Алушының телефон нөмірі
latitude иә Ендік
longitude иә Бойлық
altitude иә Карта масштабы (Google Maps сілтемесінің z параметрі), мысалы 17
accurate иә Дәлдік
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:

Сұрау сәтті болса, жіберілген хабарламаның ID қайтарылады, ол арқылы кейін оның мәртебесін алуға болады.

{
  "result":0,
  "message_id":"1"
}
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":1,
  "result_description":"Параметр method не передан."
}

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,
              "transport":"whatsapp",
              "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",
              "message_status":2,
              "message_status_name":"delivered_to_device",
              "referral":null,
              "transport_ph_numb":"777****6224"}]
}

referral — Click-to-WhatsApp жарнамасынан өту: жарнама ID-і, шерту ID-і және жарнама деректері; null — хабарлама жарнамадан емес. Объект өрістері — Webhook-тағыдай.

Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":1,
  "result_description":"Параметр method не передан."
}

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":[деректер массиві]
}

Массив элементі — whatsapp_message_list әдісіндегідей өрістер, соның ішінде referral — Click-to-WhatsApp жарнамасынан өту (null — хабарлама жарнамадан емес; объект өрістері — Webhook-тағыдай).

Сәтсіз сұраудағы жауап:
{
  "result":1,
  "result_description":"Параметр method не передан."
}

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 Абоненттер тізімін алу
phone_id жоқ Телефон ID-і. Әдепкі бойынша 0.
limit жоқ Бір сұраудағы жазбалар саны. Әдепкі бойынша 50.
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:
{
  "result":0,
  "result_data":[деректер массиві]
}
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":1,
  "result_description":"Параметр method не передан."
}

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_add Абонент қосу
phone иә Абонент нөмірі
name жоқ Абонент аты
contact_company жоқ Компания контактісін пайдаланушыға жіберу немесе жібермеу. 1 - жіберу, 0 - жібермеу
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:
{
  "result":0,
  "result_data":[деректер массиві]
}
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":1,
  "result_description":"Параметр method не передан."
}

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

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

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

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

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 арқылы хабарлама жіберу мысалы:

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

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

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

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

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

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

Кабинеттің «Статистика» бетіндегі сандармен бірдей. Кезең тәуліктері сервердің уақыт белдеуі бойынша есептеледі, ол timezone өрісінде келеді. Бүгінгі күннің деректері сұрау сәтінде есептеледі.

HTTP арқылы сұраныс мысалы:

https://api.sendapi.net?json_data={"method":"chat_statistic","date_from":"2026-11-01","date_to":"2026-11-17","api_id":"<app id>"}

PHP мысалы (curl модулі қосулы):

$data['json_data'] = json_encode([
  "method"     =>  "chat_statistic",
  "date_from"  =>  "2026-11-01",
  "date_to"    =>  "2026-11-17",
  "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_statistic Кезеңдегі чат статистикасын алу
date_from иә Кезеңнің бірінші күні, YYYY-MM-DD пішімінде.
date_to иә Кезеңнің соңғы күні, YYYY-MM-DD пішімінде, бүгіннен кешіктірмей. Кезең 31 күннен аспайды.
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:
{
  "result":0,
  "result_data":{
    "date_from":"2026-11-01",
    "date_to":"2026-11-17",
    "timezone":"Asia/Yekaterinburg",
    "chats":248,
    "new_contacts":61,
    "inbox_messages":1932,
    "outbox_messages":2210,
    "finished_dialogs":305,
    "average_response_time":94
  }
}
result_data ішіндегі өрістер:
  • chats — кезең ішінде хат алмасу болған контактілер (кіріс немесе шығыс хабарламалар), «Чаттар» қойындысындағыдай.
  • new_contacts — кезең ішінде кабинетте алғаш пайда болған контактілер.
  • inbox_messages — кіріс хабарламалар.
  • outbox_messages — шығыс хабарламалар.
  • finished_dialogs — кабинеттің барлық қызметкерлері аяқтаған диалогтар.
  • average_response_time — қызметкерлердің орташа жауап беру уақыты, секундпен: тәуліктік мәндердің орташасы, «Операторлар» қойындысындағыдай; null — деректер жоқ.
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":91,
  "result_description":"Период не может быть длиннее 31 дней."
}

Кабинет иесі және жасырылғандардан басқа қызметкерлер, «Статистика» бетінің «Операторлар» қойындысындағыдай. Кезең мен уақыт белдеуі chat_statistic әдісіндегідей.

HTTP арқылы сұраныс мысалы:

https://api.sendapi.net?json_data={"method":"chat_operator_statistic","date_from":"2026-11-01","date_to":"2026-11-17","api_id":"<app id>"}

PHP мысалы (curl модулі қосулы):

$data['json_data'] = json_encode([
  "method"     =>  "chat_operator_statistic",
  "date_from"  =>  "2026-11-01",
  "date_to"    =>  "2026-11-17",
  "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_statistic Кезеңдегі қызметкерлер бойынша статистиканы алу
date_from иә Кезеңнің бірінші күні, YYYY-MM-DD пішімінде.
date_to иә Кезеңнің соңғы күні, YYYY-MM-DD пішімінде, бүгіннен кешіктірмей. Кезең 31 күннен аспайды.
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:
{
  "result":0,
  "result_data":{
    "date_from":"2026-11-01",
    "date_to":"2026-11-17",
    "timezone":"Asia/Yekaterinburg",
    "operators":[
      {
        "operator_id":110,
        "name":"Ivan",
        "role":"owner",
        "finished_dialogs":42,
        "average_response_time":75,
        "leads":3,
        "leads_amount":45000
      },
      {
        "operator_id":2150,
        "name":"Anna",
        "role":"operator",
        "finished_dialogs":0,
        "average_response_time":null,
        "leads":0,
        "leads_amount":0
      }
    ]
  }
}
operators элементінің өрістері:
  • operator_id — қызметкер ID; кабинет иесінде — кабинет ID.
  • name — қызметкер аты.
  • role — owner (кабинет иесі) немесе operator (қызметкер).
  • finished_dialogs — қызметкер аяқтаған диалогтар.
  • average_response_time — қызметкердің орташа жауап беру уақыты, секундпен; null — деректер жоқ.
  • leads, leads_amount — кезеңдегі қызметкер мәмілелерінің саны мен сомасы.
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":90,
  "result_description":"Параметры date_from и date_to обязательны, формат YYYY-MM-DD."
}

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` бар-жоғын тексеріңіз.

Топ тақырыбына жіберу

Бот тақырыптары бар топқа (форумға) қосылған болса, хабарламаны тақырыпқа жіберуге болады: phone — telegram_-1001234567890 түріндегі топ, topic_id — telegram_create_topic әдісі жауабындағы тақырып id-і.

$data['json_data'] = json_encode([
    "method"   =>  "telegram_send_text",
    "phone"    => "telegram_-1001234567890",
    "topic_id" => 42,
    "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 telegram_send_text Telegram хабарламасын жіберу
phone иә (tg_login көрсетілмесе міндетті) Telegram контактісі. Формат telegram_0000000000.
tg_login иә (phone көрсетілмесе міндетті) Telegram логині @username форматында — арнада әлі жоқ контактіге алғашқы хабарлама үшін
sp_numb иә (tg_login-пен бірге міндетті) tg_login бойынша хабарлама жіберілетін арна идентификаторы (phone_id)
topic_id жоқ Хабарлама жіберілетін топ (форум) тақырыбының id-і: нөлден үлкен бүтін сан, тек бот тобы үшін (phone түрі telegram_-1001234567890)
reply_to_message_id жоқ Дәйексөзбен жауап берілетін Telegram хабарламасының id-і: нөлден үлкен бүтін сан, тек Telegram боты үшін. Бастапқы хабарлама жойылса, жауап дәйексөзсіз жіберіледі
reply_quote жоқ Дәйексөзге алынатын reply_to_message_id хабарламасы мәтінінің үзіндісі: 1-ден 1024-ке дейін таңба, хабарламадағыдай дәл, тек reply_to_message_id-пен бірге. Үзінді хабарламада болмаса, хабарлама жіберілмейді
text иә Хабарлама мәтіні
operator_id жоқ Хабарлама атынан жіберілетін аккаунт қызметкерінің id-і («Қызметкерлер» бөлімі): нөлден үлкен бүтін сан. Берілмесе — аккаунт иесінің атынан. Осы аккаунттың қызметкері емес, жойылған немесе бұғатталған болса — жіберусіз бас тарту (result 2)
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:
{
  "result":0,
  "message_id":"1"
}
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":1,
  "result_description":"Параметр method не передан."
}

Кабинет ботына /connect командасымен қосылған Telegram тобында тақырып (форум) құрады. Топта тақырыптар қосулы болуы керек, ал бот тақырыптарды басқаруға құқығы бар әкімші болуы керек. Жауаптағы тақырып id-і telegram_send_text әдісінің topic_id параметріне беріледі.

PHP мысалы (curl модулі қосулы):

$data['json_data'] = json_encode([
  "method"  =>  "telegram_create_topic",
  "phone"   => "telegram_-1001234567890",
  "name"    => "Клиент · кабинет 123",
  "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 telegram_create_topic telegram тобында тақырып құру
phone иә Боттың telegram тобы. Пішімі telegram_-1001234567890.
name иә Тақырып атауы, 1-ден 128 таңбаға дейін
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:
{
  "result":0,
  "topic_id":42,
  "name":"Клиент · кабинет 123"
}
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":1,
  "result_description":"Группа не подключена к этому аккаунту",
  "error_code":"not_connected"
}

Бас тарту себебі error_code өрісінде: not_connected — топ кабинетке қосылмаған, topics_not_enabled — топта тақырыптар қосылмаған, bot_not_admin — бот әкімші емес немесе тақырыптарды басқара алмайды, telegram_error — Telegram жауап бермеді.

Бот /connect командасымен кабинет ботына қосылған Telegram тобындағы хабарламаға реакция қояды. Боттың бір хабарламада бір реакциясы болады: жаңасы алдыңғысын алмастырады, reaction өрісіндегі бос жол оны алып тастайды. Тек Telegram реакциялар тізіміндегі эмодзилерге рұқсат етіледі (мысалы 👀, ✍, 👨‍💻, 👌, 🤔, 🤷).

PHP мысалы (curl модулі қосулы):

$data['json_data'] = json_encode([
  "method"     =>  "telegram_set_reaction",
  "phone"      => "telegram_-1001234567890",
  "message_id" => 4242,
  "reaction"   => "👀",
  "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 telegram_set_reaction telegram тобындағы хабарламаға реакция қою
phone иә Боттың telegram тобы. Пішімі telegram_-1001234567890.
message_id иә Топтағы Telegram хабарламасының id-і: нөлден үлкен бүтін сан
reaction иә Telegram тізіміндегі реакция эмодзиі; бос жол боттың реакциясын алып тастайды
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:
{
  "result":0,
  "message_id":4242,
  "reaction":"👀"
}
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":1,
  "result_description":"Группа не подключена к этому аккаунту",
  "error_code":"not_connected"
}

Бас тарту себебі error_code өрісінде: not_connected — топ кабинетке қосылмаған, bot_not_found, bot_not_owned, bot_not_bound — топ боты табылмады, басқа кабинетке тиесілі немесе SendAPI арнасына қосылмаған, telegram_error — Telegram реакцияны қабылдамады (хабарлама топта жоқ, эмодзиге топта рұқсат жоқ) немесе жауап бермеді.

/connect командасымен кабинет ботына қосылған Telegram тобының хабарламасын топтың тақырыбына көшіреді. Telegram-да хабарламаларды тақырыптар арасында көшіру жоқ, сондықтан бот хабарламаны тақырыпқа қайта жібереді (тақырыпта авторымен «Қайта жіберілген» белгісі көрінеді) және бастапқысын жояды. Жою үшін бот хабарламаларды жою құқығы бар әкімші болуы керек, ал хабарлама 48 сағаттан жаңа болуы керек; әйтпесе бастапқысы қалады, ал жауаптағы deleted — false. Тақырып id-і — telegram_create_topic әдісінің жауабынан.

PHP мысалы (curl модулі қосулы):

$data['json_data'] = json_encode([
  "method"     =>  "telegram_move_message",
  "phone"      => "telegram_-1001234567890",
  "message_id" => 4242,
  "topic_id"   => 42,
  "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 telegram_move_message telegram тобының хабарламасын тақырыпқа көшіру
phone иә Боттың telegram тобы. Пішімі telegram_-1001234567890.
message_id иә Топтағы Telegram хабарламасының id-і: нөлден үлкен бүтін сан
topic_id иә Хабарлама көшірілетін топ тақырыбының id-і: нөлден үлкен бүтін сан
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:
{
  "result":0,
  "message_id":4242,
  "topic_id":42,
  "new_message_id":4250,
  "deleted":true
}
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":1,
  "result_description":"Группа не подключена к этому аккаунту",
  "error_code":"not_connected"
}

Бас тарту себебі error_code өрісінде: not_connected — топ кабинетке қосылмаған, bot_not_found, bot_not_owned, bot_not_bound — топ боты табылмады, басқа кабинетке тиесілі немесе SendAPI арнасына қосылмаған, telegram_error — Telegram хабарламаны қайта жібермеді (хабарлама немесе тақырып топта жоқ) немесе жауап бермеді; бұл жағдайда бастапқы хабарлама жойылмайды.

Бот /connect командасымен кабинет ботына қосылған Telegram тобындағы хабарламаны бекітеді немесе бекітуден алады (unpin — true). Бекіту топ қатысушыларына хабарландырусыз жасалады. Бот топтың хабарламаларды бекіту құқығы бар әкімшісі болуы керек.

PHP мысалы (curl модулі қосулы):

$data['json_data'] = json_encode([
  "method"     =>  "telegram_pin_message",
  "phone"      => "telegram_-1001234567890",
  "message_id" => 4242,
  "unpin"      => false,
  "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 telegram_pin_message telegram тобының хабарламасын бекіту
phone иә Боттың telegram тобы. Пішімі telegram_-1001234567890.
message_id иә Топтағы Telegram хабарламасының id-і: нөлден үлкен бүтін сан
unpin жоқ true — хабарламаны бекітуден алу; false немесе параметрсіз — бекіту
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:
{
  "result":0,
  "message_id":4242,
  "pinned":true
}
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":1,
  "result_description":"Бот не администратор группы или у него нет права закреплять сообщения",
  "error_code":"bot_cannot_pin"
}

Бас тарту себебі error_code өрісінде: not_connected — топ кабинетке қосылмаған, bot_not_found, bot_not_owned, bot_not_bound — топ боты табылмады, басқа кабинетке тиесілі немесе SendAPI арнасына қосылмаған, bot_cannot_pin — бот топ әкімшісі емес немесе оның хабарламаларды бекіту құқығы жоқ, telegram_error — 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 иә Файлға сілтеме, сұранысқа файл тіркелмесе міндетті
topic_id жоқ Хабарлама жіберілетін топ (форум) тақырыбының id-і: нөлден үлкен бүтін сан, тек бот тобы үшін (phone түрі telegram_-1001234567890)
reply_to_message_id жоқ Дәйексөзбен жауап берілетін Telegram хабарламасының id-і: нөлден үлкен бүтін сан, тек Telegram боты үшін. Бастапқы хабарлама жойылса, жауап дәйексөзсіз жіберіледі
reply_quote жоқ Дәйексөзге алынатын reply_to_message_id хабарламасы мәтінінің үзіндісі: 1-ден 1024-ке дейін таңба, хабарламадағыдай дәл, тек reply_to_message_id-пен бірге. Үзінді хабарламада болмаса, хабарлама жіберілмейді
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.
Нөмірін жасырған WhatsApp Business әңгімелесушісі нөмірмен емес, BSUID арқылы келеді (WhatsApp пайдаланушысының идентификаторы): whatsapp_biz_US.13491208655302741918 түріндегі контакт. Мұндай контактіге нөмірге жіберетіндей жібереді.
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.
Нөмірін жасырған WhatsApp Business әңгімелесушісі нөмірмен емес, BSUID арқылы келеді (WhatsApp пайдаланушысының идентификаторы): whatsapp_biz_US.13491208655302741918 түріндегі контакт. Мұндай контактіге нөмірге жіберетіндей жібереді.
file_url иә Файлға сілтеме, сұранысқа файл тіркелмесе міндетті
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:
{
  "result":0,
  "message_id":"1"
}
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":1,
  "result_description":"Параметр method не передан."
}

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 не передан."
}
$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.
Нөмірін жасырған WhatsApp Business әңгімелесушісі нөмірмен емес, BSUID арқылы келеді (WhatsApp пайдаланушысының идентификаторы): whatsapp_biz_US.13491208655302741918 түріндегі контакт. Мұндай контактіге нөмірге жіберетіндей жібереді.
template_name иә Үлгі атауы
template_params иә Үлгінің қосымша деректері
api_id иә Сіздің API кілтіңіз
Сәтті сұраудағы жауап:
{
  "result":0,
  "message_id":"1",
  "user_balance": 0
}
Сәтсіз сұраудағы жауап (Толығырақ):
{
  "result":1,
  "result_description":"Параметр method не передан."
}

Барлық қолжетімді транспорттар бойынша қауіпсіз деректері бар аккаунттың барлық белсенді арналарының (нөмірлердің) тізімін қайтарады.

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 не передан."
}
Код мысалдары:
$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 не передан."
}

Бұл әдіс Web-хук URL бойынша сұраныстарға ұзақ уақыт дұрыс емес жауап берілгендіктен API бұғатталған жағдайда оны бұғаттан шығару үшін де жарайды. Сұраныста '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 result өрісі 0-ге тең емес және қате сипаттамасы result_description өрісінде көрсетілген JSON жауап қайтарады.

Қате бар жауап мысалы:
{
  "result": 1,
  "result_description": "Параметр method не передан."
}
Қателерді өңдеудің жалпы қағидаттары:
  • Жауаптағы result өрісін әрқашан тексеріңіз
  • result != 0 болғанда қатені result_description ішіндегі сипаттамаға сәйкес өңдеңіз
  • Уақытша қателер үшін (42, 6, 72 кодтары) қайталау әрекеттерін іске асырыңыз
  • result: 26 жауабы алынған сұрауды (жіберу нәтижесі белгісіз) автоматты түрде қайталамаңыз: қайталау хабарламаны екі рет жіберіп алуы мүмкін
  • Сұраныс жібермес бұрын берілетін параметрлердің дұрыстығын тексеріңіз

Жауап нұсқалары:

Жауап Сипаттама
0 Сәтті нәтиже
1 Қате
11 method параметрі дұрыс емес.
2 phone параметрі берілмеген.
21 phone параметрі дұрыс емес.
22 Абонент табылмады.
23 WhatsApp Business 24 сағаттық терезесі жабық: контакт 24 сағаттан астам уақыт жазған жоқ, ал хабарлама үлгісіз жіберіледі (whatsapp_biz_send_text, whatsapp_biz_send_file). whatsapp_biz_template_send әдісімен үлгі жіберіңіз немесе контактіден хабарлама күтіңіз.
24 whatsapp_unsubscribe: Абонент деректерін жаңарту мүмкін болмады.
whatsapp_biz_send_file: WhatsApp Business файл форматын қабылдамайды. Бас тарту түпкілікті: дәл сол жіберуді қайталау ештеңені өзгертпейді, басқа форматтағы файлды жіберіңіз. Рұқсат етілген форматтар: суреттер JPEG, PNG; бейне MP4, 3GP; аудио AAC, AMR, MP3, M4A, OGG; құжаттар TXT, PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX.
26 Жіберу нәтижесі белгісіз: шлюз сұрауды алды, бірақ оны растамады, сондықтан хабарлама кетуі де, кетпеуі де мүмкін. Бұл кодты жіберу әдістері, атап айтқанда *_send_text, *_send_file және whatsapp_biz_template_send қайтарады.
Мұндай жауапты жеткізу деп санамаңыз және дәл сол сұрауды қайталамаңыз: қайталау хабарламаны екі рет жіберіп алуы мүмкін. Хабарлама кеткенін жеке кабинеттегі чаттан тексеріңіз, содан кейін ғана қайта жіберіңіз.
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 Жіберушілер лимиті толып кетті.
90 date_from және date_to параметрлері берілмеген немесе YYYY-MM-DD пішімінде емес (статистика әдістері).
91 Кезең дұрыс емес: date_from date_to күнінен кейін, date_to бүгіннен кейін немесе кезең 31 күннен ұзақ (статистика әдістері).
92 Статистиканы алу мүмкін болмады. Сұрауды кейінірек қайталаңыз.

Webhook

Webhook сілтемесін API баптаулары бетінде баптауға болады

Барлық оқиғалар POST әдісімен Content-Type: application/json тақырыбымен сіз көрсеткен URL-ге жіберіледі. Баптауларда авторизация токені берілген болса, ол Authorization HTTP тақырыбында беріледі. Оқиға түрі callback_status өрісімен анықталады. transport, phone_id, user_id, add_date, reverse_date өрістері барлық оқиғада бар.

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 Хабарлама деректерінің массиві (соңғы хабарлама). Элемент өрістері:
ӨрісТүріСипаттама
message_idintХабарлама ID-і
message_routestringБағыты: inbox / outbox
message_typestringХабарлама түрі (message-chat, image, file және т.б.)
message_textstringХабарлама мәтіні
message_quotedstring|nullДәйексөз келтірілген хабарлама (бар болса)
phonestringКонтактінің телефон нөмірі
Нөмірін жасырған WhatsApp Business әңгімелесушісі нөмірмен емес, BSUID арқылы келеді (WhatsApp пайдаланушысының идентификаторы): whatsapp_biz_US.13491208655302741918 түріндегі контакт. Мұндай контактіге нөмірге жіберетіндей жібереді.
sp_numbintЖіберуші шлюз ID-і
file_urlstring|nullТіркемеге сілтеме (бар болса)
transportstringБайланыс арнасы
add_dateISODateХабарлама күні
referral object|null Жарнамадан өту: клиент Click-to-WhatsApp (Instagram, Facebook) хабарландыруын басып, жазды. null — хабарлама жарнамадан емес және барлық шығыс хабарламалар. Объект тек клиент жазысуды бастаған хабарламада болады (мәтін, фото, дауыстық); WhatsApp қосымшасы нөмірлерінде жүйе бөлек хабарлама ретінде қосатын хабарландыру суретінде ол жоқ — бір басу referral бар бір хабарламаға сәйкес келеді. Өріс атаулары — WhatsApp Cloud API Meta ішіндегі referral объектісіндегідей. Кез келген өріс null болуы мүмкін: WhatsApp оларды әрдайым толтырмайды. WhatsApp Business API (WABA) нөмірлерінде объект сол, деректерді Meta береді: source_app әрқашан null, ctwa_clid — WhatsApp мәртебелеріндегі жарнамада null.
ӨрісТүріСипаттама
source_typestring|nullӨту көзі: ad — хабарландыру
source_idstring|nullMeta ішіндегі хабарландыру ID-і (жол ретінде: 18 таңбалы сан)
source_urlstring|nullХабарландыруға немесе жазбаға сілтеме
source_appstring|nullХабарландыру қайда көрсетілді: instagram, facebook, whatsapp (WABA-да — әрқашан null)
ctwa_clidstring|nullХабарландыруды басу ID-і (Click-to-WhatsApp click ID)
headlinestring|nullХабарландыру тақырыбы
bodystring|nullХабарландыру мәтіні
media_typestring|nullХабарландыру медиасы: image немесе video
thumbnail_urlstring|nullХабарландыру суреті немесе бейненің алдын ала көрінісі (CDN Meta сілтемесі, уақыт өте ашылмай қалады)
"referral": {
  "source_type": "ad",
  "source_id": "120200000000000000",
  "source_url": "https://www.instagram.com/p/EXAMPLE/",
  "source_app": "instagram",
  "ctwa_clid": "ARAkExampleClickId...",
  "headline": "Напишите нам",
  "body": "Текст объявления",
  "media_type": "image",
  "thumbnail_url": "https://scontent.xx.fbcdn.net/..."
}
author object|null Топтық чаттағы хабарлама авторы: WhatsApp, Telegram, Instagram және MAX топтары, Instagram жазбаларына пікірлер. null — топ емес, шығыс хабарламалар және авторы жоқ топ хабарламасы. Өріс тек Webhook-та бар: whatsapp_message_list және whatsapp_message_get әдістерінде ол жоқ.
ӨрісТүріСипаттама
phonestring|nullАвтормен жеке хат алмасудың мекенжайы: WhatsApp тобы қатысушысының нөмірі, Telegram-да tg_ID, Telegram ботында telegram_ID, Instagram-да instagram_ID, MAX-та max_ID. null — мекенжай белгісіз
namestring|nullАвтордың аты — кабинеттегі оның контактісінің аты; Telegram ботында — Telegram профиліндегі аты. null — аты жоқ
"author": {
  "phone": "77001112233",
  "name": "Ivan Petrov"
}
user_id int Жүйедегі клиент ID-і
add_date ISODate Қосылған күні
reverse_date ISODate Қосылған күні
Жаңа шығыс хабарлама POST <Your webhook url>
Content-Type: application/json
Параметр Мән/Түрі Сипаттама
callback_status new_outbox_message Әрекет түрі. Жаңа шығыс хабарлама жіберілді
phone string Контактінің телефон нөмірі
transport string Байланыс арнасы (whatsapp / telegram / instagram және т.б.)
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 new_subscriber Әрекет түрі. Жаңа контакт/абонент пайда болды
phone string Контактінің телефон нөмірі
transport string Байланыс арнасы
phone_number string Жүйеге қосылған шлюз нөмірі
phone_id int Жүйеге қосылған шлюз ID-і
user_id int Жүйедегі клиент ID-і
add_date ISODate Қосылған күні
reverse_date ISODate Қосылған күні
Шлюз нөмірін ауыстыру POST <Your webhook url>
Content-Type: application/json
Параметр Мән/Түрі Сипаттама
callback_status whatsapp_change_gateway_ph_number Әрекет түрі. Шлюздің телефон нөмірі өзгерді
phone string Контактінің телефон нөмірі (қолданылса)
transport string Байланыс арнасы
phone_number string Жүйеге қосылған шлюздің жаңа нөмірі
phone_id int Жүйеге қосылған шлюз ID-і
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 Қосылған күні
Әңгімелесуші хабарламаны жойды POST <Your webhook url>
Content-Type: application/json

Әңгімелесуші өз хабарламасын жойды (немесе топ әкімшісі басқа біреудің хабарламасын жойды). Чаттағы хабарлама өзгеріссіз қалады, ал сол хат алмасуға жойылған хабарламаның дәйексөзі бар қызметтік кіріс хабарлама қосылады — оның мәтіні төмендегі мысалдағыдай әрқашан орыс тілінде. Қызметтік хабарлама үшін new_inbox_message оқиғасы жіберілмейді. Оқиғаны бөлек қосудың қажеті жоқ: ол басқа оқиғалармен бірге вебхук сілтемесіне келеді.

Параметр Мән/Түрі Сипаттама
callback_status message_deleted Әрекет түрі. Әңгімелесуші хабарламаны жойды
phone string Контактінің телефон нөмірі
transport string Байланыс арнасы (whatsapp / telegram / instagram және т.б.)
phone_number string Жүйеге қосылған шлюз нөмірі
phone_id int Жүйеге қосылған шлюз ID-і
message_id int Жою туралы қызметтік хабарламаның ID-і
deleted_message_id int Жойылған хабарламаның ID-і — ол туралы оқиғада келген сол message_id (мысалы, new_inbox_message)
message_data Array Қызметтік хабарлама деректерінің массиві (құрылымы — кіріс хабарламадағыдай): message_text — орыс тіліндегі хабарландыру мәтіні, message_quoted — жойылған хабарламаның мәтіні (мәтін болмаса, мысалы, сипаттамасыз файлда — null), phone — контактінің телефон нөмірі. Қызметтік хабарлама табылмаса, массивтің орнына 61 жауап коды бар JSON жолы келеді.
user_id int Жүйедегі клиент ID-і
add_date ISODate Қосылған күні
reverse_date ISODate Қосылған күні

Сұрау денесінің мысалы:

{
  "phone": "77011234567",
  "phone_number": "77000000000",
  "callback_status": "message_deleted",
  "transport": "whatsapp",
  "phone_id": 427,
  "user_id": 1234,
  "add_date": "2026-10-22T09:15:01.000Z",
  "reverse_date": "2026-10-22T09:15:01.000Z",
  "message_id": 5001,
  "deleted_message_id": 4999,
  "message_data": [
    {
      "message_id": 5001,
      "transport": "whatsapp",
      "message_route": "inbox",
      "message_type": "message-chat",
      "message_text": "Пользователь удалил это сообщение",
      "message_quoted": "Завтра в 10:00 подойдёт?",
      "phone": "77011234567",
      "sp_numb": 427,
      "file_url": null,
      "add_date": "2026-10-22T09:15:00.000Z",
      "referral": null,
      "author": null
    }
  ]
}
amoCRM мәмілелерінің оқиғалары (Meta Conversions API) POST <Your webhook url>
Content-Type: application/json
«Мәмілелер туралы вебхуктар» қосқышымен API баптаулары → AmoCRM бөлімінде қосылады. Вебхук сілтемесі мен токен «Вебхукты баптау» (SendAPI) бөлімінен алынады. Lead (мәміле жасау) және Purchase (сәтті мәміле) оқиғаларын Meta Conversions API-ге жіберуге ыңғайлы.
Параметр Мән/Түрі Сипаттама
callback_status deal_created / deal_status_changed Әрекет түрі. deal_created — мәміле жасалды. deal_status_changed — мәміле мәртебесі өзгертілді
phone string Мәміле контактісінің телефоны (Meta CAPI ішіндегі адаммен салыстыру үшін)
transport string sendapi (CRM оқиғасы, хабарлама арнасына байланбаған)
user_id int Жүйедегі клиент ID-і
hook_body_row json Мәміле деректері:
Өріс Түрі Сипаттама
crmstringӘрқашан "amocrm"
eventstringdeal_created / deal_status_changed
deal_idintamoCRM ішіндегі мәміле ID-і
pipeline_idint|nullСату сүзгісінің ID-і
status_idint|nullМәміленің ағымдағы мәртебесі
old_status_idint|nullБұрынғы мәртебе (тек deal_status_changed үшін)
pricenumber|nullМәміле сомасы
is_wonbooltrue, егер мәртебе = «сәтті іске асырылды» (142). Purchase белгісі
responsible_user_idint|nullЖауапты менеджердің ID-і
namestring|nullМәміле атауы
add_date ISODate Қосылған күні
reverse_date ISODate Қосылған күні
Жүктелуде...