ვერიფიკაციის კოდი (OTP) Numer-ში — ტელეფონის დადასტურება WhatsApp-ით თქვენს საიტზე

ვერიფიკაციის კოდი (OTP) — ტელეფონის დადასტურება WhatsApp-ით თქვენს საიტზე

რეგისტრაციის ან შესვლის დროს მომხმარებლის ტელეფონის ნომრის დადასტურება დღეს ნებისმიერი ონლაინ მაღაზიისა თუ ვებ სერვისის აუცილებელი ნაწილია — ყალბი პროფილების, სპამისა და უსაფრთხოების რისკების შესამცირებლად. Numer-ში ახალი ვერიფიკაციის კოდის (OTP) ინტეგრაცია გაძლევთ შესაძლებლობას, კოდი მომხმარებელს WhatsApp-ით მიუვიდეს თქვენივე დაკავშირებული ნომრიდან — დამატებითი SMS სერვისის, კარიბჭისა და ხარჯების გარეშე.

როგორ მუშაობს?

მომხმარებელი თქვენს საიტზე რეგისტრაციის ფორმაში წერს ტელეფონის ნომერს → თქვენი საიტი Numer-ის API-ს სთხოვს კოდს → Numer აგენერირებს უსაფრთხო კოდს და აგზავნის WhatsApp შეტყობინებას თქვენი მოწყობილობიდან → მომხმარებელი ჩაწერს კოდს ფორმაში → თქვენი საიტი ამოწმებს მას Numer-ის API-ით და მხოლოდ წარმატების შემდეგ ასრულებს რეგისტრაციას.

უსაფრთხოებაზე ზრუნავს თავად სისტემა:

• კოდი ბაზაში მხოლოდ დაჰეშილი ინახება — ღია კოდს ვერც სისტემა ხედავს და ვერც ჟურნალებში იწერება
• კოდი ერთჯერადია და მოქმედებს ნაგულისხმევად 10 წუთი
• მცდარი მცდელობების ლიმიტი — 5, მისი ამოწურვის შემდეგ კოდი უქმდება
• ახალი კოდის გაგზავნა ავტომატურად აუქმებს წინა გამოუყენებელ კოდს იმავე ნომერზე
• ყოველი გაგზავნილი კოდი 1 შეტყობინებად ითვლება თქვენს თვიურ ლიმიტში და ჩანს დაფის ინბოქსში

რომელი ნომრიდან იგზავნება კოდი?

კოდი იგზავნება თქვენს მიერ Numer-ში დაკავშირებული WhatsApp მოწყობილობიდან. მოწყობილობის არჩევა ორნაირად შეგიძლიათ:

• ნაგულისხმევად — ინტეგრაციის გვერდზე მიუთითებთ, რომელი მოწყობილობიდან გაიგზავნოს კოდები;
• მოთხოვნაში device_id-ით — თუ ერთ ანგარიშზე რამდენიმე მოწყობილობა გაქვთ, საიტს შეუძლია თითოეულ გაგზავნაზე სხვა ნომერი აირჩიოს (მოწყობილობების სია ხელმისაწვდომია API-ით: GET numer.ge/api/v1/devices).

როგორ დავუკავშიროთ?

1. დაფაზე გადადით ინტეგრაციები → ვერიფიკაციის კოდი (OTP) (numer.ge/dashboard/integrations/otp).
2. დააჭირეთ დაკავშირებას და აირჩიეთ ნაგულისხმევი მოწყობილობა (სურვილისამებრ — შეტყობინების საკუთარი ტექსტიც შეგიძლიათ ჩაწეროთ).
3. გვერდზე API გასაღებები შექმენით გასაღები (მაგ: „რეგისტრაციის ვერიფიკაცია") — მას მოთხოვნებზე Header-ით გადასცემთ: Authorization: Bearer was.XXXX.
4. საიტის კოდში ჩასვით ქვემოთ მოცემული მაგალითი.

API ორი მოთხოვნა

1) კოდის გაგზავნა — POST numer.ge/api/v1/otp/send

{
  "phone": "+995599123456"
}

სურვილისამებრ შეგიძლიათ გადასცეთ: device_id (მოწყობილობა), length (4–8, ნაგულისხმევი 6), expires_in (წამები, ნაგულისხმევი 600) და message (საკუთარი ტექსტი {{code}} / {{ttl_minutes}} ცვლადებით). პასუხში კოდი არ ბრუნდება — ის მხოლოდ მომხმარებელს უნდა მიუვიდეს.

2) კოდის დადასტურება — POST numer.ge/api/v1/otp/check

{
  "phone": "+995599123456",
  "code": "482913"
}

პასუხი: {"success": true, "data": {"valid": true, "status": "valid", "attempts_remaining": 5}}. რეგისტრაცია დაასრულეთ მხოლოდ მაშინ, როცა valid არის true.

მზა კოდი პროექტებისთვის

WordPress (functions.php):

function numer_otp_send($phone) {
    $r = wp_remote_post('https://numer.ge/api/v1/otp/send', [
        'headers' => ['Authorization' => 'Bearer was.YOUR_API_KEY',
                      'Content-Type' => 'application/json'],
        'body' => wp_json_encode(['phone' => $phone]),
    ]);
    return ! is_wp_error($r);
}

function numer_otp_check($phone, $code) {
    $r = wp_remote_post('https://numer.ge/api/v1/otp/check', [
        'headers' => ['Authorization' => 'Bearer was.YOUR_API_KEY',
                      'Content-Type' => 'application/json'],
        'body' => wp_json_encode(['phone' => $phone, 'code' => $code]),
    ]);
    $body = json_decode(wp_remote_retrieve_body($r), true);
    return ! empty($body['data']['valid']);
}

Laravel:

use Illuminate\Support\Facades\Http;

$api = Http::withToken(config('services.numer.api_key'));

// გაგზავნა რეგისტრაციის ფორმაზე
$api->post('https://numer.ge/api/v1/otp/send', ['phone' => $validated['phone']]);

// დადასტურება მომხმარებლის მიერ კოდის შეყვანის შემდეგ
$result = $api->post('https://numer.ge/api/v1/otp/check', [
    'phone' => $validated['phone'],
    'code' => $request->input('code'),
])->json('data');

abort_unless($result['valid'] ?? false, 422, 'კოდი არასწორია.');

სად გამოგადგებათ?

• რეგისტრაცია და შესვლა — ტელეფონის ნომრის დადასტურება რეალური მომხმარებლის გარანტიით
• პაროლის აღდგენა — კოდი SMS-ის ნაცვლად, WhatsApp-ით
• მგრძნობიარე მოქმედებები — გადახდის, პროფილის შეცვლის, ადმინ ჩანაწერზე შესვლის დამატებითი დადასტურება (2FA)
• შეკვეთის გაფორმება — ტელეფონის ნომრის ვალიდაცია მიწოდების სანდოობისთვის

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

ყველა პარამეტრის, პასუხისა და სტატუსის დეტალური აღწერა, ასევე PHP/WordPress/Laravel-ის სრული მაგალითები განთავსებულია ინტეგრაციის გვერდზე — numer.ge/dashboard/integrations/otp.