SMS API ინტერფეისი

გამოყენების სფეროები

ყველაზე ხშირად, SMS API დაკავშირება გამოიყენება:

• მომხმარებლის რეგისტრაციის დაკავშირება კონკრეტულ სააბონენტო ნომერზე SMS-ის საშუალებით.

• საბანკო ანგარიშების ტრანზაქციების შეტყობინება.

• მომხმარებლების შეტყობინება შეკვეთის სტატუსის, აქციების, ახალი პროდუქტების, ნებისმიერი SMS რეკლამის შესახებ.

როგორ დავიწყო

გაიარეთ ავტორიზაცია

შეავსეთ ბალანსი

გააქტიურეთ API სერვისი

მესიჯის გაგზავნა

სავალდებულო პარამეტრები

`key`	საიდუმლო API გასაღები სისტემასთან დასაკავშირებლად. გასაღების ნახვა და მართვა შესაძლებელია კომპანიის პარამეტრებში.
`brandID`	ბრენდნეიმის უნიკალური ID სისტემაში.
`numbers`	მძიმით გამოყოფილი მობილური ნომრები. ნომრები უნდა იყოს საერთაშორისო ფორმატში, 00 და + გარეშე.
`text`	შეტყობინების ტექსტი. დასაშვებია ნებისმიერი Unicode სიმბოლო.

არასავალდებულო პარამეტრები

`stopList`	`stopList=false` — სტოპ სიაში შემოწმების გათიშვა. მესიჯი გაიგზავნება იმ შემთხვევაშიც, თუ მიმღები ნომერი სტოპ სიაშია.
`otp`	`otp=true` — ერთჯერადი ავტორიზაციის კოდებისთვის (OTP / verification code) განკუთვნილი SMS. იგზავნება უმაღლესი პრიორიტეტით. გამოიყენეთ მხოლოდ ავტორიზაციის პროცესში. სხვა ტიპის შეტყობინებებისთვის გამოყენება დაუშვებელია.
`sendTime`	მესიჯის დაგეგმილი გაგზავნის დრო. ფორმატი: `Y-m-d H:i` (მაგ: `2026-02-01 23:30`) მითითებული დრო უნდა იყოს მიმდინარე დროის შემდეგ. თუ პარამეტრი არ არის გადმოცემული, მესიჯი იგზავნება დაუყოვნებლივ.

მესიჯის სტატუსის ავტომატურად მიღება (Callback)

SMS API საშუალებას გაძლევთ ავტომატურად მიიღოთ გაგზავნილი შეტყობინებების სტატუსი თქვენს სერვერზე Callback მექანიზმის საშუალებით.

როდესაც მესიჯის სტატუსი იცვლება (გაგზავნილია, მიწოდებულია, ვერ გაიგზავნა და ა.შ.), სისტემა აგზავნის GET მოთხოვნას თქვენს მითითებულ HTTPS მისამართზე.

Callback URL-ის მოთხოვნები:

მისამართი უნდა იწყებოდეს https://-ით
მეთოდი: GET
Callback URL ინიშნება კომპანიის პარამეტრებში

GET მოთხოვნის მაგალითი

გადმოცემული პარამეტრები

`key`	Callback ვალიდაციის გასაღები, თქვენი სერვერისთვის
`smsID`	მესიჯის უნიკალური იდენტიფიკატორი
`number`	მიმღების მობილური ნომერი (საერთაშორისო ფორმატში)
`statusID`	მესიჯის მიმდინარე სტატუსის კოდი
`date`	სტატუსის განახლების დრო (`Y-m-d H:i:s`)

სტატუსების მნიშვნელობა

SMS სტატუსები (statusID)

statusID	აღწერა
`0`	გაგზავნილია
`1`	მიღებულია
`2`	ვერ გაიგზავნა
`3`	მოლოდინში
`4`	შეცდომა

Callback-ის დამუშავების მაგალითი (PHP)

Callback მაგალითი

<?php
$key      = $_GET['key'] ?? null;
$smsID    = $_GET['smsID'] ?? null;
$number   = $_GET['number'] ?? null;
$statusID = $_GET['statusID'] ?? null;
$date     = $_GET['date'] ?? null;

// ვალიდაცია: დარწმუნდით, რომ key ემთხვევა თქვენს callback გასაღებს
if ($key !== 'YourCallbackKey') {
    http_response_code(403);
    echo 'Forbidden';
    exit;
}

// აქ დაამუშავეთ მიღებული სტატუსი თქვენს სისტემაში

http_response_code(200);
echo 'OK';
?>

Callback ჩაითვლება წარმატებულად, თუ თქვენი სერვერი დააბრუნებს HTTP 200–299 სტატუს კოდს.

UBill API-ს სრული დოკუმენტაცია