# Telefon Android ca gateway SMS (Beta) Folosește propriul tău telefon Android ca expeditor de SMS-uri. În loc să conectezi un cont Twilio, instalezi o mică aplicație open-source pe un telefon Android, o asociezi cu spațiul tău de lucru, iar mesajele tale sunt trimise și primite prin numărul și planul tarifar al acelui telefon. > **Canalul Beta.** Gateway-ul SMS pentru Android este acum disponibil tuturor celor care au un abonament cu alocare de canal, dar este încă nou — așteptați-vă la mici imperfecțiuni și rețineți că comportamentul și limitele se pot schimba pe măsură ce canalul se maturizează. Dacă ceva nu funcționează conform descrierii, anunțați echipa de asistență. --- ## De ce să folosești acest serviciu Gateway-ul Android este creat pentru **SMS-uri conversaționale cu volum redus** — răspunsuri către lead-uri, conversații AI și mesaje unu-la-unu. Este o alegere potrivită atunci când: - Vrei să continui să trimiți mesaje de pe **numărul tău personal sau de afaceri existent**. - Twilio este **prea complex sau prea scump** pentru țara ta sau pentru volumul tău de mesaje. - Preferi să folosești **abonamentul SMS existent al operatorului tău** în loc să plătești taxe per mesaj. - Vrei să **eviți birocrația legată de înregistrarea la operatori** (A2P 10DLC și altele similare) pe care Twilio o solicită. Acesta **nu** este creat pentru trimiterea de mesaje în masă (broadcast) — consultați [Limitări](#limitations) mai jos. > **Preferați Twilio pentru scalabilitate și fiabilitate.** Dacă trimiteți mesaje în volum mare, aveți nevoie de timp de funcționare garantat sau rulați campanii SMS în masă, conectați un număr Twilio — consultați [Mesagerie SMS](sms.md). Cele două sunt metode alternative de transport SMS; mesajele, contactele, AI-ul și căsuța de primire funcționează la fel în ambele cazuri. --- ## De ce aveți nevoie - **Un telefon Android** cu un SIM activ și un abonament SMS (se recomandă insistent un plan nelimitat sau generos de SMS-uri). - **Aplicația gratuită, open-source "SMS Gateway for Android"** de pe [sms-gate.app](https://sms-gate.app) — descărcați-o de pe site sau din [GitHub releases](https://github.com/capcom6/android-sms-gateway/releases/latest). Nu noi am creat această aplicație — este un proiect terț. - **Telefonul trebuie să rămână pornit, conectat la internet și fără restricții** — consultați [Menținerea fiabilității telefonului](#keeping-the-phone-reliable). - **Un plan plătit** — gateway-ul Android este inclus în alocarea canalului dumneavoastră. **Nu există o taxă per mesaj** pe platformă și nici factură Twilio — utilizați propriul plan tarifar al telefonului. Dacă AI-ul generează un răspuns, acel răspuns consumă credite AI, la fel ca pe orice alt canal. --- ## Configurarea aplicației Gateway 1. Instalați **SMS Gateway for Android** de pe [sms-gate.app](https://sms-gate.app) pe telefonul al cărui număr doriți să îl utilizați. 2. Deschideți aplicația. 3. Activați modul **Cloud Server** (cea mai simplă opțiune — acesta transmite datele prin serverul găzduit al proiectului, astfel încât telefonul nu are nevoie de o adresă publică). 4. Aplicația generează un **nume de utilizator** și o **parolă** pe ecranul principal. Le veți introduce în platformă în secțiunea următoare. 5. (Recomandat) În aplicație, deschideți **Settings → Webhooks**. Un webhook este o notificare automată pe care aplicația o trimite platformei ori de câte ori se întâmplă ceva — în acest caz, ori de câte ori sosește un mesaj. 6. Copiați **Signing Key**. Lipirea acesteia în platformă adaugă o verificare suplimentară a semnăturii pentru mesajele primite. > **Mod local (avansat).** Dacă preferi ca telefonul să comunice direct cu platforma prin propria rețea, în loc de releul cloud, aplicația suportă și modul Local Server. Va trebui să expui telefonul la o adresă HTTPS accesibilă și să introduci acea adresă ca URL de bază la conectare. Modul Cloud este recomandat pentru aproape toată lumea. --- ## Conectarea telefonului la platformă 1. În bara laterală din stânga, faceți clic pe **Settings** (Setări) aproape de partea de jos. 2. În meniul din stânga al paginii Settings, sub **Channels** (Canale), faceți clic pe **Channels**. 3. Găsiți cardul **Android SMS Gateway** și faceți clic pe **Connect** (Conectare). 4. Introduceți **Phone number** (Numărul de telefon) — numărul propriu al telefonului în format internațional (E.164), de ex. `+14155551234`. 5. Introduceți **Gateway username** (Nume utilizator gateway) și **Gateway password** (Parolă gateway) din ecranul principal al aplicației gateway. 6. Opțional, lipiți **Webhook signing key** (Cheia de semnare webhook) (recomandat) din setările Webhooks ale aplicației. 7. Faceți clic pe **Connect** (Conectare). Platforma validează credențialele, înregistrează webhook-urile pentru mesaje și livrare pe gateway pentru tine și schimbă starea în **Conectat**. Nu este nevoie să copiezi și să lipești URL-uri de webhook în aplicație — înregistrarea este automată. ### Verificarea stării Odată conectat, butonul cardului se schimbă din **Connect** în **Manage** (Gestionare). Faceți clic pe acesta pentru a redeschide panoul gateway-ului, unde veți găsi **Refresh status** (Reîmprospătare stare) în orice moment. Acesta verifică din nou dacă gateway-ul este accesibil și arată dacă telefonul este în prezent **online**. Dacă telefonul este în modul repaus sau offline, veți vedea un indicator clar de stare offline, astfel încât să știți că mesajele text nu vor fi trimise până când acesta nu revine online. ### Deconectarea Faceți clic pe **Manage** pe card pentru a redeschide panoul gateway-ului, apoi faceți clic pe **Disconnect** (Deconectare). Platforma elimină webhook-urile pe care le-a înregistrat pe gateway și șterge conexiunea. Mesajele dvs. text vor reveni apoi la Twilio dacă aveți un număr Twilio SMS conectat, sau funcția SMS va fi dezactivată dacă nu aveți. --- ## Cum circulă mesajele ### Primite 1. Cineva trimite un mesaj la numărul telefonului dvs. 2. Aplicația gateway de pe telefon detectează SMS-ul și notifică platforma. 3. Platforma creează un contact (dacă este nou), plasează mesajul în căsuța de primire și — dacă agentul AI relevant este activ — răspunde. ### Trimise 1. Dvs. sau AI-ul trimiteți un răspuns din platformă. 2. Platforma transmite mesajul către gateway-ul dvs. 3. Telefonul îl trimite ca un SMS normal de pe numărul dvs., prin operatorul de telefonie. 4. Pe măsură ce operatorul raportează starea, mesajul se actualizează la **Sent**, apoi **Delivered** (sau **Failed**). > **Gateway-ul Android are prioritate pentru trimitere.** Cât timp este conectat, răspunsurile unu-la-unu și cele AI sunt trimise prin telefonul tău. Dacă ai conectat și un număr SMS Twilio, deconectează gateway-ul Android pentru a trimite din nou prin Twilio. O excepție în ambele cazuri: **campaniile și mesajele SMS de tip broadcast sunt trimise întotdeauna prin numărul tău Twilio**, niciodată prin telefonul Android — trimiterea în masă de pe un dispozitiv personal este exact motivul pentru care numerele sunt blocate, așa că platforma nu permite acest lucru. --- ## Limitări Gateway-ul Android depinde de un telefon fizic pe care îl controlezi, deci vine cu limitări pe care nu le vei întâlni la Twilio. Revizuiește-le înainte de a te baza pe acesta pentru mesaje importante. - **Telefonul trebuie să rămână pornit și online.** Fără telefon, fără mesaje. Mențineți-l încărcat, conectat la Wi-Fi sau date mobile și exclus de la optimizarea bateriei. - **Doar volum redus.** Operatorii marchează și limitează telefoanele care trimit brusc multe mesaje. Acest canal este destinat conversațiilor și răspunsurilor unu-la-unu — **nu trimiterii de mesaje în masă**. - **Trimiterea de mesaje în masă (broadcast) nu este acceptată pe acest canal.** Trimiterea de SMS-uri în masă necesită un număr Twilio conectat; platforma vă va notifica dacă încercați să lansați o astfel de campanie fără Twilio. Rulați campaniile prin Twilio și păstrați gateway-ul Android pentru răspunsuri conversaționale. - **Doar text.** Trimiterea și primirea de MMS (media) nu este acceptată pe acest canal. - **Se aplică limitele operatorului.** Alocația de SMS-uri a planului dvs. tarifar, limitele de utilizare rezonabilă și orice taxe per mesaj sunt stabilite între dvs. și operatorul dvs. de telefonie. - **Confirmarea livrării depinde de operator.** Unii operatori raportează livrarea în mod fiabil; alții nu. O stare "Sent" înseamnă că telefonul a expediat mesajul. - **Riscuri legate de cont/număr.** Utilizarea unui număr personal pentru mesaje de afaceri automatizate poate încălca termenii operatorului dvs. și poate duce la limitarea sau suspendarea numărului în caz de abuz. Utilizați-l responsabil, obțineți consimțământul și includeți instrucțiuni de dezabonare. --- ## Menținerea fiabilității telefonului Pentru a menține mesajele în flux fără întrerupere: - **Dezactivează optimizarea bateriei** pentru aplicația SMS Gateway (Setări Android → Aplicații → SMS Gateway → Baterie → Nerestricționat). În caz contrar, Android o poate închide în fundal. - **Păstrează ecranul accesibil / aplicația permisă să ruleze în fundal.** Un telefon dedicat lăsat conectat la priză este ideal. - **Rămâi pe o conexiune Wi-Fi sau de date stabilă.** Dacă telefonul pierde conectivitatea, mesajele se pun la coadă sau eșuează până când revine. - **Păstrează cartela SIM activă și în stare bună** la operatorul tău. --- ## Depanare ### "Nu s-au putut valida credențialele gateway-ului" - Verifică din nou **numele de utilizator** și **parola** comparându-le cu ecranul principal al aplicației gateway — acestea se regenerează dacă reinstalezi sau resetezi aplicația. - Confirmă că telefonul are internet și că modul **Cloud Server** este activat în aplicație. ### Starea arată offline / mesajele nu se trimit - Deschideți aplicația pe telefon și confirmați că rulează și că este conectată la serverul cloud. - Verificați dacă telefonul nu este în modul Doze / economisire baterie și că aplicația este exclusă de la optimizarea bateriei. - Apăsați **Refresh status** pe card după ce ați readus telefonul online. ### Mesajele text primite nu apar - Confirmați că starea conexiunii este în continuare **Connected** (Conectat) (atingeți **Refresh status**). - Trimiteți un mesaj text de test către numărul telefonului de pe un alt telefon. - Asigurați-vă că aplicația implicită de mesaje a telefonului nu blochează sau filtrează expeditorul. ### Un mesaj text afișează „Failed” (Eșuat) - Operatorul l-a respins — verificați dacă numărul destinatarului este valid și în format internațional. - Confirmați că SIM-ul dvs. mai are credit pentru SMS-uri și că numărul nu este suspendat. - Ratele de trimitere foarte mari pot declanșa limitarea impusă de operator; reduceți viteza și mențineți volumul scăzut. --- ## Ai nevoie de ajutor? Gateway-ul Android SMS este în versiune **Beta**. Dacă întâmpinați o problemă care nu este acoperită aici, contactați hi@youraiconnector.com cu: - Numărul de telefon pe care l-ați conectat (nu parola). - Dacă aplicația gateway apare ca fiind online pe telefon. - O descriere a problemei și momentul în care a avut loc. Vom analiza situația cât mai curând posibil.