API v2 құжаттамасы
Жұмыс сызбасы
- Біз жүйеге хабарламалар жіберілетін телефон нөмірін қосамыз.
- Сіз тарифті таңдап, оған өзіңізге ыңғайлы тәсілмен төлейсіз.
- Біздің API арқылы хабарламаларыңызды таратасыз.
HTTP арқылы хабарлама жіберу мысалы:
Код мысалдары:
$data['json_data'] = json_encode([
"method" => "whatsapp_send",
"phone" => "77000000000",
"text" => "Сообщение",
"file_url" => "https://secure.gravatar.com/avatar/7cab71edb0a4c12a1e64bbfdf46a3c64",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
const data = {
json_data: JSON.stringify({
method: "whatsapp_send",
phone: "77000000000",
text: "Сообщение",
file_url: "https://secure.gravatar.com/avatar/7cab71edb0a4c12a1e64bbfdf46a3c64",
api_id: "<app id>"
})
};
fetch("https://api.sendapi.net", {
method: "POST",
headers: {
"Content-Type": "application/x-www-form-urlencoded"
},
body: new URLSearchParams(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error("Error:", error));
import requests
import json
data = {
'json_data': json.dumps({
'method': 'whatsapp_send',
'phone': '77000000000',
'text': 'Сообщение',
'file_url': 'https://secure.gravatar.com/avatar/7cab71edb0a4c12a1e64bbfdf46a3c64',
'api_id': '<app id>'
})
}
response = requests.post('https://api.sendapi.net', data=data)
result = response.json()
print(result)
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_send WhatsApp хабарламасын жіберу phone иә Алушының телефон нөмірі немесе 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 арқылы хабарлама жіберу мысалы:
Код мысалдары:
$data['json_data'] = json_encode([
"method" => "whatsapp_mailing",
"name" => "Рассылка из API",
"text" => "Тестовое сообщение",
"file_url" => "https://api.sendapi.net/img/kp6.png",
"filter" => ["phones" => [77000000000,77000000001]],
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
const data = {
json_data: JSON.stringify({
method: "whatsapp_mailing",
name: "Рассылка из API",
text: "Тестовое сообщение",
file_url: "https://api.sendapi.net/img/kp6.png",
filter: {
phones: [77000000000, 77000000001]
},
api_id: "<app id>"
})
};
fetch("https://api.sendapi.net", {
method: "POST",
headers: {
"Content-Type": "application/x-www-form-urlencoded"
},
body: new URLSearchParams(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error("Error:", error));
import requests
import json
data = {
'json_data': json.dumps({
'method': 'whatsapp_mailing',
'name': 'Рассылка из API',
'text': 'Тестовое сообщение',
'file_url': 'https://api.sendapi.net/img/kp6.png',
'filter': {
'phones': [77000000000, 77000000001]
},
'api_id': '<app id>'
})
}
response = requests.post('https://api.sendapi.net', data=data)
result = response.json()
print(result)
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_mailing WhatsApp таратылымын жіберу name иә Таратылым атауы text иә (file_url көрсетілмесе міндетті) UTF-8 кодтауындағы хабарлама мәтіні. Шектеу: 10-нан 2000 таңбаға дейін file_url иә (text көрсетілмесе міндетті) Файлға сілтеме filter иә Сүзгі, деректер JSON форматында, JSON бос болмауы керек. Қолжетімді параметрлер:
• phones - телефон нөмірлерінің массиві, ең аз саны 2 нөмір: [77010000000,77010000001];
• category - "all" немесе санат id-і;
• date_registration - нөмірдің қосылған күні JSON форматында: {"from":"2019-01-01 00:00:00","to":"2019-01-31 23:59:59"};
• date_active - нөмірдің белсенділік күні JSON форматында: {"from":"2019-01-01 00:00:00","to":"2019-01-31 23:59:59"};
phones параметрінің басымдығы жоғары, ол көрсетілсе, басқа параметрлер сүзгілеуге қатыспайды
Таратылым тек Жазылған мәртебесі бар нөмірлерге жіберіледі
Мысалдар:
{"category":"all","date_registration":{"from":"2019-01-01 00:00:00","to":"2019-01-31 23:59:59"}
{"phones":[77010000000,77010000001]}
{"category":"all"}send_date жоқ Таратылымды іске қосу қажет күн [формат: 2019-02-03 00:00:00]. Берілмесе, таратылым бірден іске қосылады api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
Сұрау сәтті болса, жіберілген хабарламаның ID қайтарылады, ол арқылы кейін оның мәртебесін алуға болады.
{ "result":0, "mailing_id":1 } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
Код мысалдары:
$file_path = 'абсолютті жол /12015426947.jpg';
if (function_exists('curl_file_create')) { // php 5.5+
$cFile = curl_file_create($file_path);
} else {
$cFile = '@' . realpath($file_path);
}
$data['json_data'] = json_encode([
'method' => 'whatsapp_send_contact_card',
'phone' => '77000000000',
'api_id' => '<app id>',
'contact_phone' => '77000000000',
'contact_name' => 'Имя контакта',
'file_url' => 'https://api.sendapi.net/img/kp6.png',
]);
$data['contact_logo_image'] = $cFile;
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
const formData = new FormData();
formData.append('json_data', JSON.stringify({
method: 'whatsapp_send_contact_card',
phone: '77000000000',
api_id: '<app id>',
contact_phone: '77000000000',
contact_name: 'Имя контакта',
file_url: 'https://api.sendapi.net/img/kp6.png'
}));
// Контакт логотипінің файлы болса
const fileInput = document.getElementById('logoInput');
if (fileInput && fileInput.files[0]) {
formData.append('contact_logo_image', fileInput.files[0]);
}
fetch('https://api.sendapi.net', {
method: 'POST',
body: formData
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error('Error:', error));
import requests
import json
data = {
'json_data': json.dumps({
'method': 'whatsapp_send_contact_card',
'phone': '77000000000',
'api_id': '<app id>',
'contact_phone': '77000000000',
'contact_name': 'Имя контакта',
'file_url': 'https://api.sendapi.net/img/kp6.png'
})
}
# Контакт логотипінің файлы болса
files = {}
logo_path = '/path/to/contact/logo.jpg' # логотип файлының жолы
try:
files['contact_logo_image'] = open(logo_path, 'rb')
except FileNotFoundError:
pass
response = requests.post('https://api.sendapi.net', data=data, files=files)
result = response.json()
print(result)
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- POST
- file параметрлері:
-
Жіберілетін файл деректері - json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_send_contact_card WhatsApp контактісін жіберу phone иә Алушының телефон нөмірі contact_phone иә Контактіде берілетін телефон нөмірі contact_name иә Контакт аты logo_id иә, contact_logo_image параметрі көрсетілмесе Логотип ID-і, ол логотипті contact_logo_image параметрі арқылы жүктегеннен кейін белгілі болады. [Параметр ескірді, file_url пайдаланыңыз] file_url иә, contact_logo_image параметрі көрсетілмесе Суретке Url. Сурет форматы jpg, jpeg, png. Мысал: https://api.sendapi.net/img/kp6.png api_id иә Сіздің API кілтіңіз - contact_logo_image параметрлері:
-
contact_logo_image иә, logo_id параметрі көрсетілмесе; logo_id параметрі көрсетілсе, жүктелетін файл ескерілмейді. Назар аударыңыз: жіберуге тек jpg, jpeg сурет форматына рұқсат етіледі. Файл жүктелуі тиіс параметр - Сәтті сұраудағы жауап:
-
Сәтті болса, тек жіберу мәртебесі қайтарылады.
{ "result":0, } - contact_logo_image берілген кездегі сәтті сұраудағы жауап:
-
Сәтті болса, жіберу мәртебесі және логотип ID-і қайтарылады, оны әрі қарай logo_id параметріне қоюға болады.
{ "result":0, "logo_id":"100" } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
HTTP арқылы хабарлама жіберу мысалы:
Код мысалдары:
$data['json_data'] = json_encode([
"method" => "whatsapp_send_geolocation",
"phone" => "77000000000",
"latitude" => "53.284461",
"longitude" => "69.378938",
"altitude" => "5.5",
"accurate" => "5.5",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
const data = {
json_data: JSON.stringify({
method: "whatsapp_send_geolocation",
phone: "77000000000",
latitude: "53.284461",
longitude: "69.378938",
altitude: "5.5",
accurate: "5.5",
api_id: "<app id>"
})
};
fetch("https://api.sendapi.net", {
method: "POST",
headers: {
"Content-Type": "application/x-www-form-urlencoded"
},
body: new URLSearchParams(data)
})
.then(response => response.json())
.then(result => console.log(result))
.catch(error => console.error("Error:", error));
import requests
import json
data = {
'json_data': json.dumps({
'method': 'whatsapp_send_geolocation',
'phone': '77000000000',
'latitude': '53.284461',
'longitude': '69.378938',
'altitude': '5.5',
'accurate': '5.5',
'api_id': '<app id>'
})
}
response = requests.post('https://api.sendapi.net', data=data)
result = response.json()
print(result)
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_send_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 арқылы хабарлама жіберу мысалы:
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 арқылы хабарлама жіберу мысалы:
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 арқылы хабарлама жіберу мысалы:
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 арқылы хабарлама жіберу мысалы:
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 арқылы хабарлама жіберу мысалы:
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "whatsapp_phone_get",
"phone" => "77000000000",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_phone_get Абонент деректерін алу phone иә Абонент нөмірі api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "result_data":[деректер массиві] } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
HTTP арқылы хабарлама жіберу мысалы:
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "whatsapp_unsubscribe",
"phone" => "77000000000",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_unsubscribe Абонентті таратылымнан шығару phone иә Абонент нөмірі api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "result_description":"Подписчик отписан." } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
HTTP арқылы хабарлама жіберу мысалы:
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_list",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_group_list whatsapp топтарының тізімін алу api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "groups": [ { "adminCheck":false, "admins":["77*********"], "subscribers":["77*********","77*********","77*********"], "group_id":"whatsapp_group_********-********", "name":"Тест группа" } ] } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
HTTP арқылы хабарлама жіберу мысалы:
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_get",
"group_id"=> "whatsapp_group_*******",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_group_get whatsapp тобын алу group_id иә топ id-і api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "group":{ "adminCheck":false, "admins":["77*********"], "subscribers":["77*********","77*********","77*********"], "group_id":"whatsapp_group_********-********", "name":"Тест группа" } } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_create",
"sp_numb" => "1",
"group_name" => "Тест группа",
"subscribers"=> ['7700*******'],
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_group_create whatsapp тобын жасау. Бұл әдіс топ жасау тапсырмасын құрады. Топ тек тапсырма орындалғаннан кейін пайда болады. Тапсырманың орындалу уақыты арнаның жүктемесіне байланысты. sp_numb иә арна id-і, оны whatsapp_sender_get әдісі арқылы алуға болады group_name иә Топ атауы subscribers иә Абоненттер массиві api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "result_description":"Задача на создание группы подана успешно. Ожидайте появления группы в списке групп." } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_contact_set",
"group_id" => "whatsapp_group_*******",
"subscribers"=> ['7700*******'],
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_group_contact_set Бұл әдіс абоненттерді топқа қосу тапсырмасын құрады. Абоненттер тек тапсырма орындалғаннан кейін пайда болады. Тапсырманың орындалу уақыты арнаның жүктемесіне байланысты. group_id иә топ id-і subscribers иә Абоненттер массиві api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "result_description":"Задача на добавление контактов в группу подана успешно." } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_contact_del",
"group_id" => "whatsapp_group_*******",
"subscribers"=> ['7700*******'],
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_group_contact_del Бұл әдіс абоненттерді топтан жою тапсырмасын құрады. Абоненттер тек тапсырма орындалғаннан кейін жойылады. Тапсырманың орындалу уақыты арнаның жүктемесіне байланысты. group_id иә топ id-і subscribers иә Абоненттер массиві api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "result_description":"Задача на удаление контактов из группу подана успешно." } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "whatsapp_group_contact_set_as_admin",
"group_id" => "whatsapp_group_*******",
"subscriber" => "7700*******",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_group_contact_set_as_admin Бұл әдіс абонентке топта әкімші құқығын беру тапсырмасын құрады. Тапсырманың орындалу уақыты арнаның жүктемесіне байланысты. group_id иә топ id-і subscriber иә Абонент нөмірі api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "result_description":"Задача на добавление прав админа подана успешно." } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
HTTP арқылы хабарлама жіберу мысалы:
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "contact_add",
"phone" => "77000000000",
"sp_numb" => "0",
"name" => "Имя",
"contact_company" => "0",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method contact_add Абонентті арнаны көрсете отырып қосу phone иә Абонент нөмірі sp_numb иә Арна Id-і, оны whatsapp_sender_get әдісі арқылы алуға болады name жоқ Абонент аты contact_company жоқ Компания контактісін пайдаланушыға жіберу немесе жібермеу. 1 - жіберу, 0 - жібермеу api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "phone" : "whatsapp_biz_77000000000", // Нөмірді арнаға байланысты форматта қайтарады "sp_numb" : 0, "result_description" : "Подписчик добавлен." } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
HTTP арқылы хабарлама жіберу мысалы:
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "whatsapp_sender_get",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method whatsapp_sender_get Арналар деректерін алу api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "result_data":[] } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
HTTP арқылы хабарлама жіберу мысалы:
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "chat_work_list",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method chat_work_list Жұмыстағы контактілер тізімін алу api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "result_data":[] } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
HTTP арқылы хабарлама жіберу мысалы:
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "chat_work_update",
"phone" => "77000000000",
"operator_id" => "10",
"action" => "chat_in_work"
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method chat_work_update Диалогты жұмысқа алу немесе жабу phone иә Контакт operator_id иә Оператор ID-і action иә chat_in_work - Жұмысқа алу, chat_out_of_work - диалогты жабу api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
HTTP арқылы хабарлама жіберу мысалы:
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "chat_operator_online",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method chat_operator_online Онлайн операторларды алу api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "result_data":[] } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
HTTP арқылы хабарлама жіберу мысалы:
PHP мысалы (curl модулі қосулы):
$data['json_data'] = json_encode([
"method" => "operation_mode",
"api_id" => "<app id>"
]);
$ch = curl_init("https://api.sendapi.net");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
$body = curl_exec($ch);
curl_close($ch);
- Мекенжай:
- https://api.sendapi.net
- Әдіс:
- GET, POST
- json_data параметрлері:
-
Параметр Міндетті Сипаттама method operation_mode Жұмыс режимін алу api_id иә Сіздің API кілтіңіз - Сәтті сұраудағы жауап:
-
{ "result":0, "result_data":[] } - Сәтсіз сұраудағы жауап (Толығырақ):
-
{ "result":1, "result_description":"Параметр method не передан." }
Кабинеттің «Статистика» бетіндегі сандармен бірдей. Кезең тәуліктері сервердің уақыт белдеуі бойынша есептеледі, ол timezone өрісінде келеді. Бүгінгі күннің деректері сұрау сәтінде есептеледі.
HTTP арқылы сұраныс мысалы:
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 арқылы сұраныс мысалы:
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 арқылы сұраныс мысалы:
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 арқылы хабарлама жіберу мысалы:
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 іске қосылатын әрекеттер: