SMS API pentru companii

SMS API pentru aplicaţia ta

Trimiţi SMS-uri către orice reţea mobilă din România printr-un simplu apel HTTP - fără librării speciale, fără platformă separată. Coduri de verificare, notificări de comandă, alerte şi remindere, direct din aplicaţia sau site-ul tău.

0,04 €/SMS
către reţelele mobile din România, fără abonament
HTTP POST
un singur request, răspuns JSON, fără SDK obligatoriu
Webhook
status de livrare (delivered/undelivered) pe URL-ul tău
Fără librării speciale Notificare status livrare Fără abonament, plăteşti pe SMS Şi din interfaţa web a contului Suport în limba română
Ce este

SMS-uri trimise programatic, dintr-un apel HTTP

SMS API ClickPhone este un serviciu care îţi permite să trimiţi mesaje SMS către orice număr de telefon mobil din România direct din codul aplicaţiei tale, printr-o cerere HTTP POST cu corp JSON către https://www.clickphone.ro/api/v2/sms, fără să instalezi o platformă de SMS separată sau o librărie specială. Autentificarea se face cu un token dedicat, trimis în antetul Authorization, pe care îl generezi din contul tău de telefonie ClickPhone, serviciul de telefonie cloud pentru companii operat de Caro Network SRL, furnizor autorizat de reţele şi servicii de comunicaţii electronice din România.

Un singur apel HTTP

POST cu token, număr de telefon şi text - JSON la dus, JSON la întors. Funcţionează din orice limbaj care poate face o cerere HTTP - PHP, Node.js, Python, aplicaţii mobile.

Confirmare de livrare

Trimiţi opţional un URL propriu, iar ClickPhone îl notifică prin POST cu statusul livrării (delivered/undelivered) când primeşte răspunsul de la operator.

Fără abonament

Plăteşti doar mesajele trimise, din creditul contului tău ClickPhone - nu există un cost fix lunar separat pentru API.

Pentru ce foloseşti

Cazuri de utilizare frecvente

Coduri de verificare (OTP)

Confirmarea numărului de telefon la înregistrare sau autentificare în doi paşi pentru aplicaţia sau site-ul tău.

Notificări de comandă

Confirmare comandă, status livrare sau programare, trimise automat din sistemul de gestiune sau magazinul online.

Alerte interne

Sisteme de monitorizare sau alarmă care trimit un SMS operatorului de gardă când apare un eveniment critic.

Remindere

Amintiri de programare, scadenţă de plată sau expirare abonament, trimise cu câteva zile înainte.

Confirmări şi rezervări

Confirmarea unei rezervări sau a unei programări făcute online, fără intervenţie manuală.

Informări scurte

Mesaje punctuale către clienţi sau colegi - de exemplu întreruperi programate sau schimbări de program.

Cum se integrează

De la contul tău la primul SMS trimis

Documentaţia completă, precompletată cu datele contului tău, e disponibilă în contul web la secţiunea API.

1

Ai un cont ClickPhone

Userul e contul tău ClickPhone, iar credenţiala e un token API pe care ţi-l generezi singur, în cont, la secţiunea API. E o credenţială numai pentru API, pe care o poţi regenera oricând.

2

Faci un POST către /api/v2/sms

Trimiţi tokenul în antetul Authorization şi telefonul + textul în corp JSON, către https://www.clickphone.ro/api/v2/sms, din orice limbaj de programare.

3

Primeşti răspuns JSON

Statusul HTTP îţi spune ce s-a întâmplat (200 a mers, 401/402/400 erori), iar corpul răspunsului conţine id, segmente şi cost - sau, la eroare, un cod stabil în eroare.cod pe care poţi ramifica direct în cod.

4

Afli statusul livrării (opţional)

Dacă trimiţi şi parametrul url, ClickPhone face un POST pe adresa ta cu SMSid şi SMSstatus când operatorul confirmă livrarea.

Autentificare şi parametri

Tokenul se trimite în antetul standard, nu în corpul cererii:

Authorization: Bearer TOKENUL_TAU
Câmp (corp JSON) Descriere
telefon Numărul de telefon destinatar, în format naţional - de exemplu 0720123456.
text Conţinutul mesajului, maxim 619 caractere (4 mesaje concatenate). Taxarea se face în funcţie de câte mesaje se concatenează.
url (opţional) Adresă proprie unde ClickPhone trimite prin POST statusul livrării (SMSid + SMSstatus).

Exemplu de trimitere SMS

<?php
$token   = "TOKENUL_TAU";  // tokenul tau API, generat in cont
$telefon = "07xxxxxxxx";                 // numărul destinatarului
$text    = "Comanda ta a fost expediata."; // textul mesajului

$curl = curl_init();
curl_setopt_array($curl, array(
    CURLOPT_URL            => "https://www.clickphone.ro/api/v2/sms",
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => array("Authorization: Bearer $token", "Content-Type: application/json"),
    CURLOPT_POSTFIELDS     => json_encode(array("telefon" => $telefon, "text" => $text)),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
));
$raspuns = json_decode(curl_exec($curl), true);
$http    = curl_getinfo($curl, CURLINFO_HTTP_CODE);

if ($http === 200) {
    echo "Trimis, SMSid=" . $raspuns["id"] . ", cost " . $raspuns["cost"] . " EUR";
} else {
    echo "Eroare [" . $raspuns["eroare"]["cod"] . "]: " . $raspuns["eroare"]["mesaj"];
}
?>

Răspuns

{
    "ok": true,
    "id": "ea847924f40339",
    "segmente": 1,
    "cost": 0.04,
    "moneda": "EUR"
}

id e identificatorul mesajului - acelaşi pe care îl primeşti înapoi în SMSid la notificarea livrării. La eroare, ok devine false şi apare un obiect eroare cu un cod stabil (credit_insuficient, numar_invalid, gateway_esuat ...), pe care ramifici în cod - mesaj e doar pentru oameni.

Documentaţia completă (inclusiv trimiterea în listă către mai multe numere şi verificarea statusului livrărilor) e disponibilă autentificat, în cont, la secţiunea API - precompletată cu tokenul tău.

Fără cod

Sau trimiţi manual, din interfaţa web

Nu ai nevoie de integrare pentru fiecare SMS - din contul web ClickPhone poţi trimite mesaje manual, către un singur număr sau către o listă întreagă încărcată dintr-un fişier, cu costul afişat înainte de trimitere. Vezi pagina SMS bulk - trimitere în masă din interfaţa web.

Iar dacă lucrezi cu un asistent AI (Claude, ChatGPT, Cursor), îi poţi da direct conectorul MCP ClickPhone: o singură adresă, după care asistentul citeşte singur tarifele, pachetele şi ghidurile de instalare, cu URL-ul sursă în răspuns.

Întrebări frecvente

Ce ne întreabă cel mai des clienţii

Ce este SMS API şi cum se integrează?

SMS API ClickPhone este un serviciu de trimitere de mesaje SMS printr-o cerere HTTP POST cu corp JSON către https://www.clickphone.ro/api/v2/sms, cu tokenul trimis în antetul Authorization şi numărul de telefon + textul mesajului în corp. Se integrează din orice limbaj de programare care poate face o cerere HTTP - fără librărie sau SDK special - şi foloseşte acelaşi cont ca telefonia ClickPhone.

Am nevoie de un cont separat pentru SMS API?

Nu. Foloseşti contul tău ClickPhone existent, cu un token API pe care ţi-l generezi singur, în cont la secţiunea API, şi pe care îl trimiţi în antetul Authorization. Tokenul se poate regenera sau şterge oricând, din cont.

Pot primi SMS-uri pe numerele ClickPhone?

Nu, numerele ClickPhone nu pot primi mesaje SMS. API-ul este doar pentru trimitere către reţelele mobile din România.

Cum aflu dacă mesajul a fost livrat?

Trimiţi opţional parametrul url cu adresa ta - când operatorul confirmă livrarea, ClickPhone face un POST către acel URL cu SMSid-ul mesajului şi statusul (delivered/undelivered).

Câte caractere poate avea un mesaj?

Maxim 619 caractere, concatenate din până la 4 mesaje SMS (primul cu 160 de caractere, următoarele cu câte 153). Taxarea se face pe numărul de mesaje concatenate.

Cât costă un SMS trimis prin API?

0,04 €/SMS către reţelele mobile din România, fără TVA şi fără abonament lunar - plăteşti din creditul contului tău.

Vrei să integrezi SMS API în aplicaţia ta?

Spune-ne ce vrei să trimiţi şi câte mesaje estimezi lunar - te ajutăm cu integrarea.

Sunt interesat