Trimite SMS din n8n prin telefonul tău Android

Să zicem că ai un service auto sau un cabinet și folosești deja n8n: programările vin printr-un formular, se adună într-un tabel, iar fluxurile de lucru rulează singure. Lipsește un singur lucru: să-l anunți pe client printr-un SMS. Calea obișnuită e un cont la un furnizor de API SMS, un număr închiriat și un preț pentru fiecare mesaj.

Dacă ai un telefon Android cu SIM, drumul e mai scurt. Nodul SMSTunnel pentru n8n îi predă fiecare mesaj contului tău SMSTunnel, iar aplicația SMSTunnel de pe telefon îl trimite de pe numărul tău. Clientul vede un număr pe care îl cunoaște și îți poate răspunde direct. SMSTunnel nu taxează mesajele: un SMS te costă cât îți cere operatorul tău, după abonamentul pe care îl ai.

Mai jos pornim de la zero, pe planul Gratuit: legi telefonul, creezi o cheie, instalezi n8n-nodes-smstunnel și construiești trei fluxuri pe care le poți copia: confirmarea unei cereri trimise prin formular, o alertă când pică un flux și mementoul cu o zi înainte de programare.

Ce îți trebuie

• Un telefon Android 7.0 sau mai nou, cu un SIM care poate trimite SMS și cu internet (Wi-Fi sau date mobile). Poate fi și un telefon mai vechi, care stă la încărcat la birou.
• Un cont SMSTunnel gratuit. Planul Gratuit include 25 de mesaje pe zi și 500 pe lună, trimise exact cum le-ai scris, încă până la 25 de mesaje pe zi din software-ul tău care se încheie cu un scurt rând „free by smstunnel.io” și 50 de coduri de autentificare pe zi. Planurile plătite încep de la 9 $ pe lună, fără taxe; detalii pe pagina de prețuri.
• Un n8n în care poți instala noduri din comunitate (community nodes). Ghidul și videoclipul folosesc un n8n instalat pe serverul tău. Unde altundeva se pot instala nodurile din comunitate decide n8n, așa că verifică pagina lor despre community nodes. Dacă nu le poți instala, nodul HTTP Request face aceeași treabă, cu câteva câmpuri în plus (vezi mai jos).

Pasul 1: leagă telefonul

1. Creează un cont pe dashboard.smstunnel.io sau intră cu Google ori Facebook.
2. Instalează aplicația SMSTunnel din Google Play, autentifică-te cu același cont și apasă Pornește serviciul. Înainte ca Android să-ți ceară permisiunea de a trimite SMS, aplicația îți explică de ce are nevoie de ea.
3. Telefonul apare în dashboard la Phones. Îl poți lega și cu un cod QR: pe computer deschizi Phones → Add phone, iar în aplicație alegi Conexiuni → Conectează cu cod QR.

Înainte să deschizi n8n, trimite-ți un mesaj de probă din dashboard, cu Write a text. Dacă ajunge, restul ține doar de n8n. Documentația explică permisiunile aplicației și serviciul în fundal.

Pasul 2: creează o cheie pentru n8n

În dashboard deschizi Apps → Add an app, alegi n8n și copiezi cheia. Se afișează o singură dată, așa că lipește-o direct în n8n sau păstreaz-o într-un loc sigur. Cheia poate trimite mesaje și poate verifica dacă au plecat, nimic mai mult. Dacă vrei să-i tai accesul lui n8n, ștergi aplicația din aceeași listă.

O singură operație cere mai mult. Get Received citește mesajele primite de telefon, deci merge doar cu o cheie căreia i-ai dat voie explicit (Can also read received texts când o creezi, sau Allow reading received texts mai târziu). În plus, în aplicație trebuie pornită opțiunea Sincronizează mesajele primite. E oprită implicit, se copiază doar mesajele care sosesc după ce o pornești, iar mesajele vechi din telefon nu sunt citite niciodată.

Pasul 3: instalează n8n-nodes-smstunnel

În n8n:

1. Deschide Settings → Community Nodes.
2. Apasă Install și scrie n8n-nodes-smstunnel.
3. Confirmă că accepți riscurile nodurilor din comunitate și apasă Install.

Dacă preferi instalarea manuală, rulează în directorul în care e instalat n8n:

npm install n8n-nodes-smstunnel

Cu Docker, adaugi pachetul în imaginea ta sau îl montezi în ~/.n8n/custom. Nodul e open source, cu licență MIT.

Pasul 4: adaugă datele de acces

Creează în n8n credențiale noi de tipul SMSTunnel API:

Câmp	Ce pui acolo
API Key	Cheia de la pasul 2. n8n o trimite în antetul X-API-Key.
Base URL	https://smstunnel.io. O schimbi doar dacă SMSTunnel rulează pe serverul tău.

Apasă Test înainte să salvezi, ca să verifici cheia.

Pasul 5: confirmarea unei programări cerute prin formular

Acesta e fluxul din videoclip: cineva completează formularul de pe site și primește, în câteva secunde, un SMS de pe numărul tău.

1. Adaugă un n8n Form Trigger cu două câmpuri, Nume și Telefon.
2. Adaugă nodul SMSTunnel, cu resursa Message și operația Send.
3. Completează To și Message cu expresii:

To:      {{ $json["Telefon"] }}
Message: Bună, {{ $json["Nume"] }}! Am primit cererea ta de programare și te sunăm azi ca să stabilim ora.

4. La Additional Fields, setează Default Country Code la +40. Oamenii își scriu numărul cum sunt obișnuiți, 0722 123 456; un număr fără + sau 00 primește prefixul ales și pierde zeroul din față, deci mesajul pleacă spre +40722123456. Prefixul din nod are întâietate față de țara setată pentru telefon.
5. Deschide formularul, scrie-ți propriul număr și trimite-l. Mesajul vine de pe telefonul pe care l-ai legat.

Fiecare mesaj trimis de nod are un singur destinatar. Dacă zece oameni completează formularul, n8n rulează nodul de zece ori și fiecare primește mesajul lui.

Încă două fluxuri utile

Un SMS când pică un flux

Un SMS ajunge la tine chiar dacă telefonul din buzunar nu are date mobile în acel moment.

1. Creează un flux care începe cu nodul Error Trigger.
2. Adaugă SMSTunnel → Message → Send, cu numărul tău la To și cu mesajul:

Fluxul {{$json["workflow"]["name"]}} a picat: {{$json["execution"]["error"]["message"]}}

3. În setările fiecărui flux pe care vrei să-l urmărești, alege-l pe acesta ca flux de erori (error workflow).

Mementoul de cu o zi înainte

Un Schedule Trigger pornește fluxul în fiecare zi la 18:00. Un nod de bază de date, Google Sheets sau HTTP Request aduce programările de mâine, iar SMSTunnel → Send îi scrie fiecărui client, cu To setat la {{ $json.phone }}. Un mesaj tipic: „Bună ziua! Vă așteptăm mâine la ora 10:00 la service pentru revizie. Dacă nu puteți ajunge, răspundeți la acest mesaj.” Pentru că vine de pe numărul tău, clientul răspunde direct, iar răspunsul ajunge pe telefonul tău. Dacă ții programările într-un tabel sau în calendar, ghidul pentru Google Sheets și Google Calendar arată și altă cale.

Coduri de autentificare, starea mesajelor și răspunsuri

Nodul nu doar trimite:

• Send 2FA Code trimite un cod de autentificare generat de fluxul tău. Mesajul trebuie să conțină codul — între 4 și 10 cifre de sine stătătoare, ca 482913 sau 12-345678, ori două grupuri de câte trei cifre, ca 123-456 — și poate avea cel mult 320 de caractere. Codurile au o limită zilnică separată: 50 pe zi în planul Gratuit, fără limită zilnică în planurile plătite. SMSTunnel doar livrează codul; fluxul tău îl generează și îl verifică. Mai multe în ghidul despre coduri de autentificare prin SMS fără Twilio.
• Get Status primește ID-ul mesajului și îți spune dacă e în așteptare (pending), trimis (sent) sau eșuat (failed). Un mesaj eșuat marcat „unconfirmed” a plecat cel mai probabil, așa că nu-l retrimite automat.
• Get Received aduce mesajele primite de telefon, cu permisiunea și sincronizarea de la pasul 2. Un flux programat le poate prelua, de exemplu ca să-ți semnaleze anulările.
• Get Usage arată cât ai trimis azi și cât mai ai, iar Device → Get Many îți arată telefoanele și care dintre ele sunt conectate.

Același mesaj pentru câțiva oameni

Uneori același mesaj trebuie să ajungă la câțiva colegi, de exemplu la cei de gardă săptămâna asta. Send to Several Recipients primește până la 100 de numere, despărțite prin virgulă, punct și virgulă sau rând nou, iar fiecare destinatar primește propriul mesaj. Operația cere ca telefonul să fie conectat când rulează. Un Send simplu către un telefon deconectat așteaptă și pleacă atunci când telefonul revine, în cel mult 3 zile.

Folosește-o în locul unei bucle de Send: SMSTunnel acceptă 30 de cereri de trimitere pe minut, iar nodul nu reîncearcă după un răspuns „too many requests”. Mai e bine de știut:

• Un mesaj poate avea până la 1600 de caractere, pe care telefonul le trimite ca până la 10 SMS-uri unite.
• Un apel eșuat oprește fluxul. Pornește Continue On Fail ca elementul să primească un câmp error și să-l tratezi în nodul următor.

Trimite doar mesaje pe care oamenii le așteaptă de la tine: alerte, mementouri, răspunsuri, coduri.

Fără noduri din comunitate? Nodul HTTP Request

Dacă n8n-ul tău nu poate instala noduri din comunitate, nodul HTTP Request poate apela direct API-ul SMSTunnel:

• metoda POST și adresa https://smstunnel.io/api/v1/sms/send;
• antetul X-API-Key cu cheia ta, păstrată într-o credențială n8n, de exemplu Header Auth, nu scrisă în nod;
• un corp JSON cu un singur destinatar:

{
  "to": "+40722123456",
  "message": "Comanda ta #1042 a fost expediată."
}

Răspunsul conține un messageId cu care poți verifica starea mai târziu. Câmpuri opționale: deviceId (care dintre telefoanele tale trimite) și defaultCountryCode. Referința API descrie toate apelurile și erorile, iar pagina integrării n8n adună toate câmpurile nodului.

Întrebări frecvente

Merge pe planul Gratuit?

Da. Nodul e gratuit, iar pe planul Gratuit până la 25 de mesaje pe zi și 500 pe lună pleacă exact cum le-ai scris; încă până la 25 pe zi se încheie cu scurtul rând „free by smstunnel.io”. Planurile plătite nu adaugă nimic la mesaje.

Ce număr văd clienții?

Numărul cartelei SIM din telefonul care trimite. Răspunsurile ajung pe telefonul acela ca orice alt SMS, iar cu sincronizarea pornită le vezi și în dashboard.

Ce se întâmplă dacă telefonul e offline?

Un mesaj trimis cu Send așteaptă în contul tău și pleacă atunci când telefonul revine online, în cel mult 3 zile. Send to Several Recipients are nevoie de telefonul conectat.