API v2 құжаттамасы


API әдістері бойынша жылдам навигация

Кіріспе

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

  1. Біз жүйеге хабарламалар жіберілетін телефон нөмірін қосамыз.
  2. Сіз тарифті таңдап, оған өзіңізге ыңғайлы тәсілмен төлейсіз.
  3. Біздің 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 иә Алушының телефон нөмірі немесе WhatsApp тобының ID
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 кілтіңіз
Сәтті сұраудағы жауап:

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

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

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

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

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

{
  "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,
              "referral":null}]
}

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

Сәтсіз сұраудағы жауап (Толығырақ):
{
  "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":[деректер массиві]
}

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

Сәтсіз сұраудағы жауап:
{
  "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 - Вебхук мәртебесін жаңарту

Бұл әдіс 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 кодтары) қайталау әрекеттерін іске асырыңыз
  • Сұраныс жібермес бұрын берілетін параметрлердің дұрыстығын тексеріңіз

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

Жауап Сипаттама
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 баптаулары бетінде баптауға болады

Барлық оқиғалар 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Контактінің телефон нөмірі
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/..."
}
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 Қосылған күні
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 Қосылған күні
Жүктелуде...