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.

Sunt interesat Vezi documentaţia

0,04 €/SMS

către reţelele mobile din România, fără abonament

HTTP POST

un singur apel, răspuns XML, 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 către https://www.clickphone.ro/api/sms, fără să instalezi o platformă de SMS separată sau o librărie specială. Foloseşte acelaşi cont şi aceleaşi credenţiale ca telefonia ClickPhone.

Un singur apel HTTP

POST cu user, parolă, număr de telefon şi text. 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.

Ai un cont ClickPhone

Userul şi parola API sunt aceleaşi cu contul tău ClickPhone - parola API este hash-ul MD5 al parolei, afişat în cont la secţiunea API.

Faci un POST către /api/sms

Trimiţi user, parola, telefon şi text către https://www.clickphone.ro/api/sms, din orice limbaj de programare.

Primeşti răspuns XML

Serverul răspunde imediat cu result (success/failed) şi description - costul sau SMSid-ul mesajului, ori textul erorii.

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.

Parametrii cererii

Parametru	Descriere
user	Userul tău ClickPhone.
parola	Hash-ul MD5 al parolei tale ClickPhone (afişat în cont, la secţiunea API).
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, urlencoded, unde ClickPhone trimite prin POST statusul livrării (SMSid + SMSstatus).

Exemplu de trimitere SMS

<?php
$user    = "USERUL_TAU";      // userul tău ClickPhone
$parola  = "HASH_MD5_PAROLA";  // hash MD5 al parolei tale
$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/sms",
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => "user=$user&parola=$parola&telefon=$telefon&text=" . urlencode($text),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
));
$result = curl_exec($curl);

$response = new SimpleXMLElement($result);
if ($response->result == 'failed') {
    echo "Eroare: " . $response->description;
} else {
    echo "Trimis, SMSid=" . $response->description;
}
?>

const user    = "USERUL_TAU";      // userul tău ClickPhone
const parola  = "HASH_MD5_PAROLA";  // hash MD5 al parolei tale
const telefon = "07xxxxxxxx";                 // numărul destinatarului
const text    = "Comanda ta a fost expediata."; // textul mesajului

const res = await fetch("https://www.clickphone.ro/api/sms", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ user, parola, telefon, text }),
});
const xml = await res.text();

const descriere = xml.match(/<description>(.*?)<\/description>/)[1];
if (xml.includes("<result>failed</result>")) {
  console.log("Eroare: " + descriere);
} else {
  console.log("Trimis, SMSid=" + descriere);
}

import requests
import xml.etree.ElementTree as ET

user    = "USERUL_TAU"       # userul tău ClickPhone
parola  = "HASH_MD5_PAROLA"   # hash MD5 al parolei tale
telefon = "07xxxxxxxx"                  # numărul destinatarului
text    = "Comanda ta a fost expediata." # textul mesajului

r = requests.post("https://www.clickphone.ro/api/sms", data={
    "user": user, "parola": parola, "telefon": telefon, "text": text,
}, timeout=30)

raspuns = ET.fromstring(r.text)
descriere = raspuns.findtext("description")

if raspuns.findtext("result") == "failed":
    print("Eroare: " + descriere)
else:
    print("Trimis, SMSid=" + descriere)

String user    = "USERUL_TAU";      // userul tău ClickPhone
String parola  = "HASH_MD5_PAROLA";  // hash MD5 al parolei tale
String telefon = "07xxxxxxxx";                 // numărul destinatarului
String text    = "Comanda ta a fost expediata."; // textul mesajului

String body = "user=" + user + "&parola=" + parola
    + "&telefon=" + telefon
    + "&text=" + URLEncoder.encode(text, StandardCharsets.UTF_8);

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://www.clickphone.ro/api/sms"))
    .header("Content-Type", "application/x-www-form-urlencoded")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

user    := "USERUL_TAU"      // userul tău ClickPhone
parola  := "HASH_MD5_PAROLA"  // hash MD5 al parolei tale
telefon := "07xxxxxxxx"                 // numărul destinatarului
text    := "Comanda ta a fost expediata." // textul mesajului

form := url.Values{}
form.Set("user", user)
form.Set("parola", parola)
form.Set("telefon", telefon)
form.Set("text", text)

resp, _ := http.PostForm("https://www.clickphone.ro/api/sms", form)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)

var raspuns struct {
    Result      string `xml:"result"`
    Description string `xml:"description"`
}
xml.Unmarshal(body, &raspuns)

if raspuns.Result == "failed" {
    fmt.Println("Eroare: " + raspuns.Description)
} else {
    fmt.Println("Trimis, SMSid=" + raspuns.Description)
}

curl -X POST https://www.clickphone.ro/api/sms \
  --data-urlencode "user=USERUL_TAU" \
  --data-urlencode "parola=HASH_MD5_PAROLA" \
  --data-urlencode "telefon=07xxxxxxxx" \
  --data-urlencode "text=Comanda ta a fost expediata."

Documentaţia completă (inclusiv API-ul de trimitere în listă către mai multe numere şi verificarea statusului) e disponibilă autentificat, în cont, la secţiunea API - precompletată cu userul şi hash-ul parolei tale.

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ă, şi poţi vedea istoricul mesajelor trimise şi costul fiecăruia.

Tarife

Plăteşti doar mesajele trimise

Destinaţie	Tarif
SMS - reţele mobile din România	0,04 €/SMS

Tarifele nu includ TVA. Numerele ClickPhone nu pot primi mesaje SMS - API-ul e doar pentru trimitere. Lista completă de tarife e pe pagina de tarife voce şi SMS.

Î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 către https://www.clickphone.ro/api/sms, cu userul, parola, numărul de telefon şi textul mesajului. 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 userul şi parola contului tău ClickPhone existent - parola API este hash-ul MD5 al parolei, afişat în cont la secţiunea API.

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