Funcții

Cum conectezi SMSAPI cu easySales: ghid complet de configurare

De echipa easySales · Actualizat 1 octombrie 2026 · 4 min citire

Cum conectezi SMSAPI cu easySales: ghid complet de configurare

Trimite-le clienților SMS-uri despre comenzi prin SMSAPI (smsapi.ro): tokenul API, callback-ul de livrare, testarea conexiunii, numele de expeditor, regulile de notificare și mesajele returnate de SMSAPI.

Ce îți aduce conectarea SMSAPI

SMSAPI este un serviciu de SMS preplătit. Conectat la easySales, le trimite clienților tăi mesaje text despre comenzile lor: confirmarea comenzii, AWB-ul cu link de urmărire, factura, anularea, un retur. Mesajele pleacă automat când are loc evenimentul, dintr-un flux de automatizare sau manual, din pagina comenzii.

Ghidul acesta descrie cardul SmsApi Romania, pentru conturile SMSAPI de pe portal.smsapi.ro.

Două lucruri de știut înainte să începi:

  • Adaugă adresa de callback a easySales în portalul SMSAPI. Prin callback, SMSAPI îi spune easySales dacă fiecare SMS a fost livrat. Fără el, Istorie SMS nu îți arată niciodată mesajele ca livrate.
  • Mesajele folosesc numele de expeditor și creditul contului tău SMSAPI. easySales nu alege un expeditor: SMS-ul pleacă sub numele de expeditor implicit al contului tău SMSAPI, iar fiecare mesaj se plătește din soldul acestuia.

Înainte să începi

✓

Un cont SMSAPI pe portal.smsapi.ro

Cu credit în el.

✓

Un token API

Creat în portalul SMSAPI, fără expirare — vezi pasul 1.

✓

Un nume de expeditor

Înregistrat în portalul SMSAPI și aprobat de SMSAPI.

Pasul 1 — Creează un token API în portalul SMSAPI

  1. În portal.smsapi.ro, mergi la API Settings → API tokens (OAuth) și apasă Generate access token.
  2. Dă-i un nume pe care îl recunoști, de exemplu SmsApi Romania easySales.
  3. La data de expirare a tokenului alege Never și activează toate permisiunile.
  4. Copiază tokenul: îl lipești în easySales la pasul 3.

Pasul 2 — Adaugă adresa de callback

  1. În portal.smsapi.ro, mergi la Callback URLs și apasă Add callback address.
  2. La Type, alege Callback address - SMS DLR.
  3. La URL, introdu exact https://easy-sales.com/services/sms/external-webhooks/smsapi-ro/status-update — cu https și fără bară la final.

Pasul 3 — Conectează SMSAPI în easySales

Mergi la Integrări → Servicii SMS și apasă Conectează pe cardul SmsApi Romania — sau Editează, dacă l-ai mai conectat înainte.

Pagina Servicii SMS din easySales, cu ambele carduri SMSAPI conectate: cel cu steagul României (SmsApi Romania) și cel fără steag.
Integrări → Servicii SMS.

Completează un Nume Conexiune pe care îl recunoști, lipește tokenul la Token și apasă Salvare.

Conexiunea SmsApi Romania: Nume Conexiune „SMSAPI Magazin Demo” și Token-ul mascat, cu butoanele Testează conexiunea, Șterge și Salvare.
Lipește tokenul din portalul SMSAPI.

Salvare păstrează tokenul fără să îl verifice. Ca să îl verifici, deschide conexiunea salvată și apasă Testează conexiunea: introdu numărul tău de mobil cu prefixul țării, doar cifre — de exemplu 40722123456 — și apasă Continuă. easySales trimite un SMS real, plătit din soldul tău SMSAPI; când ajunge, conexiunea funcționează. Dacă SMSAPI refuză, vezi în schimb motivul dat de SMSAPI. SMS-ul de test nu apare în Istorie SMS.

Pasul 4 — Numele tău de expeditor

Clienții văd SMS-ul venind de la numele de expeditor implicit al contului tău SMSAPI. Ca să trimiți sub numele magazinului tău, înregistrează-l în portalul SMSAPI, la Sender names, și setează-l ca implicit după ce SMSAPI l-a aprobat. Un nume de expeditor are între 4 și 11 caractere — litere, cifre și câteva semne, precum ., &, @ sau spațiul. Clienții nu pot răspunde la un nume de expeditor.

Pasul 5 — Alege ce mesaje pleacă

Regulile de notificare trimit un SMS când se întâmplă ceva cu o comandă: se generează un AWB, comanda este creată, facturată, anulată sau finalizată, se schimbă statusul livrării, se creează un retur. Scrie mai întâi mesajul în Clienți → Șabloane, pe tabul Sms, apoi creează regula în Clienți → Notificări, la evenimentul dorit.

Regula de notificare „SMS - comanda expediata”, pentru generarea AWB-ului, care trimite prin SmsApi Romania, cu trei magazine bifate la Trimite mesaj pentru următoarele canale și șablonul SMS „SMS comanda expediata”.
O regulă trimite prin serviciul pe care îl selectezi, pentru canalele pe care le bifezi.
  • Selectează un serviciu — serviciul SMS prin care trimite regula: SmsApi Romania și conexiunea, după Nume Conexiune.
  • Trimite mesaj pentru următoarele canale — bifează fiecare marketplace și magazin ale cărui comenzi trebuie să primească SMS-ul. Comenzile dintr-un canal nebifat nu primesc nimic.
  • Selectează șablonul corespunzător — textul SMS-ului.

Mesajele pot pleca și dintr-un flux de automatizare, cu acțiunea Trimite o notificare prin sms, sau manual, din pagina comenzii, cu Notifică client. SMS-ul ajunge la numărul de telefon al clientului, scris în format internațional după țara adresei de livrare.

Verifică ce s-a trimis

Fiecare mesaj apare în Clienți → Istorie SMS, cu statusul, comanda, clientul și textul. După ce ai pus callback-ul, statusul trece în Livrat când SMS-ul ajunge pe telefonul clientului sau în Nelivrat când rețeaua nu l-a putut livra.

Când un SMS nu pleacă

Mesajele pe care le vei vedea cel mai des, la Testează conexiunea sau în Istorie SMS:

Mesaj Ce faci
Cannot send sms, account balance is low Creditul tău SMSAPI s-a terminat. Reîncarcă soldul în portalul SMSAPI.
Sending date does not fulfill the time limit set on your account Contul tău SMSAPI permite trimiterea doar în anumite ore. Schimbă orele de trimitere în contul SMSAPI sau amână notificarea, ca să plece în intervalul permis.
No correct phone numbers Comanda nu are un număr de telefon utilizabil — lipsește sau este ascuns de marketplace. Adaugă numărul de telefon al clientului pe comandă.
Message is too long. Textul are nevoie de mai multe părți SMS decât permite contul tău SMSAPI. Scurtează șablonul și renunță la diacritice și caractere speciale.
Mesaje pe care le poți vedea

Întrebări frecvente

Din portal.smsapi.ro, la API Settings → API tokens (OAuth), cu Generate access token. Alege Never ca dată de expirare și activează toate permisiunile.

SMSAPI raportează livrările către easySales prin adresa de callback. Adaug-o în portalul SMSAPI, la Callback URLs, ca Callback address - SMS DLR, cu adresa exactă de la pasul 2.

Deschide conexiunea salvată, apasă Testează conexiunea, introdu numărul tău de mobil cu prefixul țării, doar cifre, și apasă Continuă. Dacă SMS-ul de test ajunge, funcționează.

Da. Este un SMS real, plătit din soldul tău SMSAPI.

Numele de expeditor implicit al contului tău SMSAPI. Înregistrează numele magazinului la Sender names în portalul SMSAPI și setează-l ca implicit după ce SMSAPI l-a aprobat.

Creditul tău SMSAPI s-a terminat. Reîncarcă soldul în portalul SMSAPI; următoarele mesaje pleacă normal.

Conectarea singură nu trimite nimic. Creează un șablon SMS în Clienți → Șabloane, apoi o regulă în Clienți → Notificări care îl folosește, cu serviciul SmsApi Romania selectat și canalele tale de vânzare bifate.

Un caracter din afara alfabetului SMS standard — diacriticele ă, â, î, ș, ț, un emoji, litere chirilice sau chinezești — trece SMS-ul în Unicode, unde un mesaj are 70 de caractere în loc de 160. Scrie șabloanele fără diacritice și fără astfel de caractere, și păstrează-le scurte.

A fost util acest ghid?