MANUAL DE UTILIZARE

Platforma SMS Newsletter - ansamblul de aplicatii software interconectate care permit trimiterea unui newsletter prin SMS, online, prin intermediul site-ului www.smsnewsletter.ro, folosind ca gateway pentru trimiterea SMS-urilor dispozitivele utilizatorilor precum si seviciile GSM contractate de acestia.

Operator de tlefonie mobila - societate comerciala ce ofera de servicii GSM, inclusiv SMS-uri, care se ocupa si de facturarea acestora.

SMS - abreviere de la englezescul Short Message Service, este un serviciu GSM oferit de operatorii de telefonie mobila, ce consta in transmiterea de informatii de tip text intre emitator si receptor.

Mesaj - text creat de emitator pentru a fi trimis receptorului. In cadrul platformei SMS Newsletter livrarea finala a mesajelor de la emitator la receptor se face prin unul sau mai multe SMS-uri.

Device - orice dispozitiv electronic care poate fi folosit pentru accesarea platformei SMS Newsletter. Ex: PC, tableta, telefon mobil.

Gateway - orice dispozitiv electronic cu sistem de operare Android, compatibil cu aplicatia SMS Newsletter pentru mobil, capabil sa transmite SMS-uri. Cel mai adease acesta este un telefon mobil. Daca telefonul mobil are mai multe cartele SIM-uri acestea vor fi considerate in platforma SMS Newsletter ca gateway-uri separate.

Alias - sau Gateway alias - este denumirea pe care utilizatorul o asociaza unui gateway pentru a-l identifica usor in platforma SMS Newsletter si de a decide numarul de telefon de pe care vor fi trimise mesajele. Daca, la trimitere, alias-ul este necompletat mesajele vor fi trimise de pe oricare gateway care este conectat.

Pachet - optiune pentru achizitionarea de servicii cu anumite beneficii si limitari.

Pentru crearea unui nou cont completeaza datele din formularul Cont nou.
Datele trebuie completate corect, cu litere majuscule acolo unde este cazul. Completarea gresita a datelor poate duce la anularea contului.
Dupa completarea datelor, apasa casuta din fata textului "I'm not a robot". Dupa apasare este posibil sa ti se puna si alte intrebari care sa demonstreze ca esti utilizator real.
Apoi apsa butonul "+ Creare cont".

Vei primi un email de confirmare, pe adresa de email furnizata.
Pentru activarea contului urmeaza link-ul din acest email. Gata! Contul este confirmat si te poti autentifica.

Pentru autentificare si utilizarea platformei SMS Newsletter completeaza formularul Autentificare.
Dupa completarea datelor, apasa casuta din fata textului "I'm not a robot". Dupa apasare este posibil sa ti se puna si alte intrebari care sa demonstreze ca esti utilizator real.
Apoi apsa butonul "Autentificare".
Daca datele de autentificare sunt corecte poti incepe sa folosesti platforma SMS Newsletter. Daca sunt gresite sau contul nu este activat vei primi un mesaj de eroare.
Pentru ca mesajele sa se transforme in SMS-uri este nevoie sa instalezi aplicatia pentru mobil. Urmareste sectiunea "Instalarea aplicatiei pentru mobil" din acest manual.

Daca ai uitat parola completeaza datele din formularul Resetare parola.
Dupa completarea datelor, apasa casuta din fata textului "I'm not a robot". Dupa apasare este posibil sa ti se puna si alte intrebari care sa demonstreze ca esti utilizator real.
Apoi apsa butonul "Resetare parola".

Daca datele introduse sunt corecte, vei primi un email de confirmare, pe adresa de email furnizata.
Pentru activarea noii parole urmeaza link-ul din acest email.
Cererea este valabila 24 de ore. Daca nu ai initiat tu resetarea parolei, nu iti face griji, este deajuns sa nu urmezi link-ul trimis.

La finalizarea sesiunii de lucru adu-ti aminte cat de sesnibile sunt informatiile pe care le ai si ca oricine poate trimite mesaje in numele tau. Inchide sesiunea de lucru urmand link-ul Iesire.
Pentru instalarea aplicatiei ai nevoie de un device care ruleaza platforma Android in versiunea 4.4 sau superioara.
Cauta in magazinul Play aplicatia "SMS Newsletter" sau urmeaza link-ul Resetare parola. Aplicatia este valabila doar in Romania.
Aplicatia noastra este creata de "SPARK CODE".

Apasa butonul instalare. Apoi acorda toate drepturile de utlizare aplicatiei. Fara aceste drepturi aplicatia nu poate rula.

Dupa instalare, deschide aplicatia. La deschidere initala a aplicatiei apare formularul "Aduaga cont".
Datele de autentificare sunt cele folosite la crearea contului pe site-ul www.smsnewsletter.ro
Alege un nume (Alias) pentru aceast telefon (Gateway). Cu acest nume il vrei regasi in platforma SMS Newsletter.
Daca telefonul tau are mai multe SIM-uri, opteaza pentru SIM-ul pe care vrei sa il folosesti.
Apasa butnonul "Adauga cont".
Daca datele de autentificare au fost corecte, vei fi redirectionat catre sectiunea "Home" a aplicatiei. Pentru a porni serviciul apasa butonul "On" din dreptul Alias-ului creat.
Acum aplicatia ruleaza si va putea trimite mesaje.

Daca doresti sa ai acces la contactele si mesajele tale apasa butonul "On" din drepeptul sectiunii "Activeaza sincronizare".

Daca doresti sa modifci un cont apsa butonul "Setari". Daca doresti sa adaugi un cont (device-ul tau are mai multe SIM-uri), apsa butonul meniu, apoi alege "Adauga cont".
Din sectiunea Newsletter poti trimite in cel mai simplu mod mesaje.
Introdu mesajul.
Apoi introdu numerele de telefon catre care se va trimite mesajul. Numerele de telefon trebuie despartite prin virgula sau enter.
Pentru a impiedica abuzurile nu sunt trimise mesaje fara continut (goale) sau catre numere scurte.
Poti accesa sectiunea "Optiuni avansate", de unde poti alege daca mesajele primesc confirmare sau nu, daca campania este nationala sau internationala si poti seta Gateway-ul care va trimite mesajele, specificand Alias-ul acestuia.
Apasa butonul "Verifica si trimite".

In pagina care se deschide vei vedea numerele de telefon catre care urmeaza sa fie trimis mesajul, precum si numerele care au fost excluse de la trimitere si motivul excluderii.
Daca vrei sa trimiti mesajele apesi butonul "Trimite", daca vrei sa revii asupra informatiilor apesi butonul "Inapoi".
Din sectiunea Newsletter personalizat poti trimite mesaje cu continut individualizat.
Pentru utilizarea sectiunii trebuie sa folosesti Microsoft Excel 2007+ sau un program compatibil.
Descarci modelul de fisier.
Completezi datele in fisier, fara a altera primul rand: Telefon, Gateway (optional), Mesaj. Daca lasi campul Gateway necompletat mesajele vor fi trimise prin oricare Gateway, indiferent de Alias-ul acestuia.
Apasa butonul "Incarca fisierul cu mesaje" si alege fisierul completat. Asigura-te ca ai salvat ultima versiune a fisierului.
Pentru a impiedica abuzurile nu sunt trimise mesaje fara continut (goale) sau catre numere scurte.
Poti accesa sectiunea "Optiuni avansate", de unde poti alege daca mesajele primesc confirmare sau nu, daca campania este nationala sau internationala. Gateway-ul pentru acest tip de campanie este setat individual in fisierul incarcat.
Apasa butonul "Verifica si trimite".

In pagina care se deschide vei vedea mesajele ce urmeaza sa fie trimise, precum si numerele care au fost excluse de la trimitere si motivul excluderii.
Daca vrei sa trimiti mesajele apesi butonul "Trimite", daca vrei sa revii asupra informatiilor apesi butonul "Inapoi".
Din sectiunea Newsletter agenda poti trimite mesaje contactelor tale.
Pentru utilizarea sectiunii trebuie sa apesi butonul "On" din sectiunea "Activeaza sincornizare" a aplicatiei de mobil, de pe device-ul tau.
Odata sincronizate contactele vor aparea in lista. Pentru a alege un contact trebuie sa faci click pe numele lui. Pentru a cauta contacte te poti folosi de sectiunea "Cautare". Pentru a impiedica abuzurile nu sunt trimise mesaje fara continut (goale) sau catre numere scurte.
Poti accesa sectiunea "Optiuni avansate", de unde poti alege daca mesajele primesc confirmare sau nu, daca campania este nationala sau internationala si poti seta Gateway-ul care va trimite mesajele, specificand Alias-ul acestuia.
Apasa butonul "Verifica si trimite".

In pagina care se deschide vei vedea numerele de telefon catre care urmeaza sa fie trimis mesajul, precum si numerele care au fost excluse de la trimitere si motivul excluderii.
Daca vrei sa trimiti mesajele apesi butonul "Trimite", daca vrei sa revii asupra informatiilor apesi butonul "Inapoi".
Din sectiunea Newsletter lista predefinita poti trimite mesaje catre liste de numere de telefon predefinite.
Listele se aduga, inlocuiesc sau sterg in sectiunea Liste predefinite. Incarcarea unei liste cu acelasi nume cu una existenta va duce la inlocuirea acesteia.
Pentru a impiedica abuzurile nu sunt trimise mesaje fara continut (goale) sau catre numere scurte.
Poti accesa sectiunea "Optiuni avansate", de unde poti alege daca mesajele primesc confirmare sau nu, daca campania este nationala sau internationala. Gateway-ul pentru acest tip de campanie este setat la incarcarea listei.
Apasa butonul "Verifica si trimite".

In pagina care se deschide vei vedea numerele de telefon catre care urmeaza sa fie trimis mesajul, precum si numerele care au fost excluse de la trimitere si motivul excluderii.
Daca vrei sa trimiti mesajele apesi butonul "Trimite", daca vrei sa revii asupra informatiilor apesi butonul "Inapoi".
In sectiunea Inbox poti vedea ultimele 100 mesaje primite.
Pentru utilizarea sectiunii trebuie apesi butonul "On" din sectiunea "Activeaza sincronizare" a aplicatiei de mobil, de pe device-ul tau.
Tot de aici poti da replay unui numar de telefon, sau poti sa il adaugi in "Black list".
In sectiunea Liste predefinite poti aduga, modifica sau sterge liste de numere de telefon catre care vei putea trimite mesaje din sectiuna Newsletter lista predefinita.
Pentru utilizarea sectiunii trebuie sa folosesti Microsoft Excel 2007+ sau un program compatibil.
Descarci modelul de fisier.
Completezi datele in fisier, fara a altera primul rand: Telefon, Nume (optional), Prenume (optional), Gateway (optional). Daca lasi campul Gateway necompletat mesajele vor fi trimise prin oricare Gateway, indiferent de Alias-ul acestuia.
Apasa butonul "Incarca fisierul cu contacte" si alege fisierul completat. Asigura-te ca ai salvat ultima versiune a fisierului.
Apasa butonul "Salveaza".
In sectiunea Black list creezi o lista cu numere de telefon catre care nu vor fi trimise niciodata mesaje din platforma SMS Newsletter.
Spre exemplu, dar fara a se limita la aceasta, poti aduga in Black list contactele care au cerut dezabonarea.
Apasa butonul "+ Adaugare". In fromularul nou deschis completeaza telefonul si motivul pentru care acesta a ajuns in Black list. Apasa butonul "Adaugare in Black List".
Api-ul poate fi accesat prin doua metode.

Direct URL

Adresa ce trebuie incarcata: https://www.smsnewsletter.ro/smsapirest/CHEIE-API/TELEFON/MESAJ/
unde
CHEIE-API: cheia pe care o gasesti in sectiunea API
TELEFON: orice numar de telefon de minim 9 cifre
MESAJ: mesajul ce va fi trimis, restrictionat la urmatorul set de caractere: .,!?-, caracterele alfabetului si numere
Atentie! adresa URL trebuie sa respecte standardul RFC 1738: URL Encoding.
Lungimea maxima a unui URL este de 2083 caractere. Lungimea maxima a unui mesaj transmis prin aceasta metoda este egala cu 2083 - numarul de caractere ce formeaza adresa, fara caracterele mesajului.

Folosind metoda POST

Adresa cererii: https://www.smsnewsletter.ro/smsapi/
Variabile POST: apikey si mesaje
1. apikey: cheia pe care o gasesti in sectiunea API
2. messages: un array in format JSON cu mesajele ce va respecta urmatoarea structura de date:
message: tip sting, mesajul ce va fi trimis
phone: tip sting, numarul de telefon catre care va fi trimis mesajul
alias: tip sting, numele Gateway-ul preferential pentru mesaj, este optional
start: tip intreg, unix timestamp cu primul moment din care poate fi trimis mesajul, este optional
stop: tip intreg, unix timestamp cu ultimul moment din care poate fi trimis mesajul, este optional
Exemplu de variabila messages:
[{"message": "Hello SMS Newsletter","phone": "+40775258303","alias": "","start": 0,"stop": 0},{"message": "Hello SMS Newsletter folosind gateway-ul preferential Digi","phone": "+40775258303","alias": "Digi","start": 1496275200,"stop": 1496361600}]

Gateway-ul preferential poate lipsi prin omiterea variabilei alias sau setarea la valoare vida ("") a acesteia.
Momentele de start si de stop, in care poate fi trimis un mesaj, sunt optionale. Omiterea lor, sau setarea la valoarea 0 va duce la trimitere imediata.