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.
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.
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.
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.
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.
Plăteşti doar mesajele trimise, din creditul contului tău ClickPhone - nu există un cost fix lunar separat pentru API.
Confirmarea numărului de telefon la înregistrare sau autentificare în doi paşi pentru aplicaţia sau site-ul tău.
Confirmare comandă, status livrare sau programare, trimise automat din sistemul de gestiune sau magazinul online.
Sisteme de monitorizare sau alarmă care trimit un SMS operatorului de gardă când apare un eveniment critic.
Amintiri de programare, scadenţă de plată sau expirare abonament, trimise cu câteva zile înainte.
Confirmarea unei rezervări sau a unei programări făcute online, fără intervenţie manuală.
Mesaje punctuale către clienţi sau colegi - de exemplu întreruperi programate sau schimbări de program.
Documentaţia completă, precompletată cu datele contului tău, e disponibilă în contul web la secţiunea API.
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.
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.
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.
Dacă trimiţi şi parametrul url, ClickPhone face un POST pe adresa ta cu SMSid şi SMSstatus când operatorul confirmă livrarea.
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). |
<?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"];
}
?>
const token = "TOKENUL_TAU"; // tokenul tau API, generat in cont
const telefon = "07xxxxxxxx"; // numărul destinatarului
const text = "Comanda ta a fost expediata."; // textul mesajului
const res = await fetch("https://www.clickphone.ro/api/v2/sms", {
method: "POST",
headers: {
"Authorization": `Bearer ${token}`,
"Content-Type": "application/json",
},
body: JSON.stringify({ telefon, text }),
});
const date = await res.json();
if (res.ok) {
console.log(`Trimis, SMSid=${date.id}, cost ${date.cost} EUR`);
} else {
console.log(`Eroare [${date.eroare.cod}]: ${date.eroare.mesaj}`);
}
import requests
token = "TOKENUL_TAU" # tokenul tau API, generat in cont
telefon = "07xxxxxxxx" # numărul destinatarului
text = "Comanda ta a fost expediata." # textul mesajului
r = requests.post(
"https://www.clickphone.ro/api/v2/sms",
headers={"Authorization": f"Bearer {token}"},
json={"telefon": telefon, "text": text},
timeout=30,
)
date = r.json()
if r.status_code == 200:
print(f"Trimis, SMSid={date['id']}, cost {date['cost']} EUR")
else:
print(f"Eroare [{date['eroare']['cod']}]: {date['eroare']['mesaj']}")
String token = "TOKENUL_TAU"; // tokenul tau API, generat in cont
String telefon = "07xxxxxxxx"; // numărul destinatarului
String text = "Comanda ta a fost expediata."; // textul mesajului
String body = "{\"telefon\":\"" + telefon + "\",\"text\":\"" + text + "\"}";
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://www.clickphone.ro/api/v2/sms"))
.header("Authorization", "Bearer " + token)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
token := "TOKENUL_TAU" // tokenul tau API, generat in cont
telefon := "07xxxxxxxx" // numărul destinatarului
text := "Comanda ta a fost expediata." // textul mesajului
payload, _ := json.Marshal(map[string]string{"telefon": telefon, "text": text})
req, _ := http.NewRequest("POST", "https://www.clickphone.ro/api/v2/sms", bytes.NewBuffer(payload))
req.Header.Set("Authorization", "Bearer "+token)
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
var raspuns struct {
Id string `json:"id"`
Cost float64 `json:"cost"`
}
json.Unmarshal(body, &raspuns)
if resp.StatusCode == 200 {
fmt.Printf("Trimis, SMSid=%s, cost %.2f EUR\n", raspuns.Id, raspuns.Cost)
} else {
fmt.Println("Eroare: " + string(body))
}
curl -X POST https://www.clickphone.ro/api/v2/sms \
-H "Authorization: Bearer TOKENUL_TAU" \
-H "Content-Type: application/json" \
-d '{"telefon":"07xxxxxxxx","text":"Comanda ta a fost expediata."}'
{
"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.
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.
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.
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.
Nu, numerele ClickPhone nu pot primi mesaje SMS. API-ul este doar pentru trimitere către reţelele mobile din România.
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).
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.
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.
Spune-ne ce vrei să trimiţi şi câte mesaje estimezi lunar - te ajutăm cu integrarea.