Până acum, mesajele de pe computer le scriai în dashboard, într-un tab din browser. Aplicația desktop face același lucru, dar ca o aplicație adevărată: stă în zona de notificare, poate porni odată cu computerul și te anunță când sosește un mesaj.

Ce face aplicația desktop

• Conversațiile tale, după număr. Cu căutare, marcaj pentru mesajele necitite și starea fiecărui mesaj: trimis, livrat sau netrimis.
• Scrii, iar telefonul tău trimite. Scrii pe computer, iar telefonul tău trimite mesajul de pe numărul tău, așa că oamenii văd un număr cunoscut și îți pot răspunde. Fiecare mesaj merge la un singur număr.
• Notificări. Cu sincronizarea pornită în aplicația de pe telefon, fiecare mesaj primit de telefon apare ca notificare, cu textul lui sau doar „Mesaj nou”.
• Zona de notificare. Închizi fereastra, iar SMSTunnel rămâne pornit, ca mesajele noi să apară în continuare. Poate porni odată cu computerul.
• Toate telefoanele tale. Vezi care sunt conectate și alegi care trimite. Pe un telefon cu două SIM-uri, răspunsul pleacă de pe SIM-ul care a primit mesajul.
• Actualizări. Se actualizează singur și instalează numai actualizări semnate de SMSTunnel.
• Luminos sau întunecat, în română sau în engleză, ca pe computerul tău.

Cum începi

1. Instalează aplicația SMSTunnel pe telefonul tău Android din Google Play și intră cu contul tău SMSTunnel. Ține telefonul online, cu aplicația pornită: telefonul e cel care trimite mesajele.
2. Descarcă aplicația desktop pentru Windows (10 sau 11, pe 64 de biți) sau Linux (AppImage, .deb sau .rpm) și instaleaz-o.
3. Deschide-o și intră cu același cont SMSTunnel. Telefonul tău apare singur.
4. Ca să vezi și mesajele primite de telefon, pornește în aplicația de pe telefon Setări › Mesaje primite › Sincronizează mesajele primite.

Dacă intri cu Google sau Facebook, setează mai întâi o parolă în dashboard, la Account › Security, apoi intră pe computer cu emailul.

Pe Windows, cel mai simplu e din Microsoft Store: SMSTunnel se instalează fără niciun avertisment, iar Microsoft Store îl ține la zi. Dacă folosești instalatorul de pe pagina de descărcare, prima dată când îl deschizi Windows poate spune că a protejat computerul: acel instalator nu e semnat încă cu un certificat de semnare a codului. Apasă Mai multe informații (More info), apoi Rulați oricum (Run anyway). Pagina de descărcare are detaliile și sumele de control cu care verifici fișierul descărcat.

Mesajele tale și confidențialitatea

Iată cum circulă azi mesajele, în aplicația desktop ca și în dashboard:

• Mesajele pe care le scrii ajung prin contul tău SMSTunnel la telefon, iar telefonul le trimite.
• Mesajele primite de telefon ajung pe computer numai cât timp sincronizarea e pornită în aplicația de pe telefon. Se sincronizează doar mesajele care sosesc după ce o pornești, iar mesajele existente din telefon nu sunt citite niciodată.
• În contul tău, mesajele sunt păstrate în formă lizibilă, ca dashboard-ul și aplicația desktop să le poată afișa. Nu sunt criptate end-to-end.
• O excepție: lacătul de lângă caseta de text, „Criptează pentru telefonul meu”, criptează mesajul pe computer, așa că doar telefonul tău îl poate citi. smstunnel.io vede în continuare numărul și ora.
• Pe computer, aplicația nu păstrează mesaje. Intrarea în cont rămâne în depozitul de parole al sistemului (Windows Credential Manager sau portofelul de chei din Linux), parola nu e păstrată niciodată, iar aplicația nu are reclame, statistici sau urmărire.

În curând: mesaje private end-to-end

Pregătim mesaje private end-to-end pentru aplicația desktop, în toate planurile. Mesajele tale vor putea fi citite doar pe telefon și pe computerele tale: smstunnel.io va păstra doar copii criptate, pe care nu le poate citi. Scriem aici când sunt gata.

Criptarea privește drumul prin SMSTunnel. Înainte să ajungă la telefonul tău și după ce telefonul îl trimite, un mesaj circulă prin rețeaua mobilă ca orice alt SMS.

Mesajele trimise de software-ul tău au deja propria opțiune: criptarea end-to-end, inclusă în toate planurile, prin care software-ul tău criptează fiecare mesaj pentru telefonul tău, iar SMSTunnel nu-l poate citi. Vezi articolul despre SMS-urile criptate end-to-end.

Dashboard-ul și când îl alegi

Dashboard-ul merge în orice browser și nu cere nimic instalat, inclusiv pe Mac, până apare versiunea pentru macOS. Aplicația desktop adaugă notificările, zona de notificare și pornirea odată cu computerul. Amândouă arată același cont și aceleași mesaje, așa că folosești ce ai la îndemână.

Întrebări frecvente

Aplicația desktop e gratuită?

Da, pe Windows și pe Linux. Planul tău SMSTunnel stabilește câte mesaje poți trimite pe zi, iar operatorul tău mobil taxează fiecare mesaj ca pe orice SMS trimis de pe telefon.

Pe ce sisteme merge?

Pe Windows 10 și 11 (64 de biți), din Microsoft Store sau cu instalatorul de pe pagina de descărcare, și pe Linux de 64 de biți: un AppImage, un .deb pentru Ubuntu, Debian și Mint și un .rpm pentru Fedora și openSUSE. Versiunea pentru macOS vine mai târziu.

Poate SMSTunnel să citească mesajele pe care le primesc?

Mesajele sincronizate sunt păstrate în contul tău în formă lizibilă, ca dashboard-ul și aplicația să le poată afișa; încă nu sunt criptate end-to-end. Echipa noastră nu se uită la mesajele tale decât atunci când e nevoie ca să răspundă unei cereri de asistență trimise de tine sau ca să investigheze un abuz. Mesajele private end-to-end pentru aplicația desktop, pe care smstunnel.io nu le va putea citi, vin în curând, în toate planurile.

Mai am nevoie de telefon?

Da. Aplicația desktop citește și trimite mesaje prin telefonul tău, iar fiecare mesaj pleacă de pe numărul tău. Telefonul trebuie să fie online, cu aplicația SMSTunnel pornită; dacă e offline, mesajul așteaptă și pleacă atunci când telefonul revine, timp de cel mult 3 zile.

Să luăm un program de facturare folosit de câteva sute de firme mici. Când una dintre ele emite o factură, clientul ei primește un mesaj: „Dental Plus: Factura nr. DP-2087 a fost emisă. Total: 1.249,50 lei.” Cu planul Enterprise al SMSTunnel, mesajul pleacă de pe telefonul Android al firmei Dental Plus, de pe numărul ei. Clientul știe cine îi scrie, iar dacă răspunde sau sună înapoi, ajunge la Dental Plus, nu la tine.

În ghidul de mai jos vezi tot fluxul: aplicația ta conectează telefonul fiecărui client printr-un cod QR, primește singură cheia acelui client și îi predă mesajele telefonului lui. Găsești codul cu SDK-ul pentru Node.js, ce îți arată dashboard-ul, un exemplu real și o comparație corectă cu soluțiile folosite de obicei.

De ce contează numărul fiecărui client

• Oamenii recunosc numărul. Un mesaj de la firma cu care lucrează zilnic e citit ca un mesaj de la firma aceea, pentru că exact asta este.
• Răspunsurile ajung unde trebuie. Când un client răspunde, mesajul ajunge pe telefonul firmei. Nu ajungi tu să răspunzi în locul clienților tăi.
• Fiecare firmă folosește SIM-ul și abonamentul ei. SMSTunnel nu ia bani pe mesaj, așa că mesajele trimise de telefonul unei firme intră pe abonamentul ei, la tarifele operatorului ei.
• Nu închiriezi și nu înregistrezi numere. Firmele au deja un telefon și un număr. Aplicația ta doar le conectează.

Cum funcționează pe planul Enterprise

Sunt cinci pași, iar clientul tău participă la unul singur:

1. Creezi o aplicație Enterprise în dashboard-ul SMSTunnel și primești cheia ei. Cheia are permisiunea enterprise:saas, cea care conectează clienți; celelalte chei primesc 403.
2. Serverul tău pornește conectarea unui client cu activateEnterpriseClient(): numele clientului, id-ul lui din sistemul tău (externalId) și o adresă de callback. SMSTunnel îi face clientului un cont (sau îl refolosește pe cel existent) și îți întoarce un cod QR și cheia API a clientului.
3. Clientul scanează codul QR. Instalează aplicația SMSTunnel din Google Play pe telefonul lui Android, deschide Conexiuni, apasă Conectează cu cod QR și scanează codul afișat de aplicația ta.
4. SMSTunnel îți apelează adresa de callback cu evenimentul pairing_completed, tokenul din codul QR și cheia clientului.
5. Aplicația ta trimite mesajele clientului cu cheia lui. Fiecare mesaj ajunge la telefonul lui, care îl trimite de pe numărul lui. Cu getEnterpriseClient(externalId) afli oricând dacă telefonul e conectat și online.

Clientul tău nu copiază nicio cheie API și nu intră în dashboard-ul SMSTunnel: instalează aplicația și scanează un cod.

Pas cu pas, cu SDK-ul pentru Node.js

Funcțiile pentru Enterprise sunt în SDK-ul oficial, @narcisbodea/smstunnel-sdk, atât în clientul simplu pentru Node.js, cât și în modulul pentru NestJS.

npm install @narcisbodea/smstunnel-sdk

1. Creezi aplicația Enterprise

Pe planul Enterprise, dashboard-ul are o secțiune în plus, Company. La Company → Apps alegi Add an app: câte o aplicație pentru fiecare produs al tău care are clienți. Copiezi cheia și o ții într-o variabilă de mediu pe server, niciodată în cod care rulează în browser sau într-o aplicație mobilă.

2. Pornești conectarea unui client

Când un client activează mesajele în aplicația ta, serverul îi cere SMSTunnel codul QR pentru el:

import { SmsTunnelNodeClient } from '@narcisbodea/smstunnel-sdk/node';

// Cheia aplicației tale Enterprise (Company → Apps).
const company = new SmsTunnelNodeClient({ apiKey: process.env.SMSTUNNEL_ENTERPRISE_API_KEY! });

const activation = await company.activateEnterpriseClient({
  clientName: 'Dental Plus SRL',                                // apare în aplicație și în dashboard
  externalId: 'firma-42',                                       // id-ul clientului în sistemul tău
  callbackUrl: 'https://facturare.example.ro/smstunnel/callback',
});

// Le păstrezi în baza ta de date, lângă client:
const clientKey = activation.apiKey.key;      // trimite mesaje după ce telefonul s-a conectat
const pairingToken = activation.pairingToken; // tokenul pe care îl va aduce callback-ul
const qrData = activation.activation.qrData;  // îl afișezi ca cod QR

Cheia clientului e secretă, ca orice cheie API: o ții doar pe server.

3. Afișezi codul QR

Desenezi qrData cu orice bibliotecă de coduri QR, pe pagina din care clientul activează mesajele. El îl scanează cu aplicația SMSTunnel, iar aplicația îi arată numele trimis de tine, ca să știe ce conectează.

4. Primești confirmarea

Când telefonul se conectează, SMSTunnel trimite pairing_completed la callbackUrl, care trebuie să fie o adresă https pe un server public. Accepți confirmarea doar dacă tokenul ei e unul primit de tine la pasul 2:

app.post('/smstunnel/callback', express.json(), async (req, res) => {
  const { event, token, apiKey } = req.body;
  const firma = await db.firme.findOne({ smstunnelPairingToken: token }); // baza ta de date
  if (event !== 'pairing_completed' || !firma) return res.sendStatus(404);

  await db.firme.update(firma.id, { smstunnelKey: apiKey, smsActiv: true });
  res.sendStatus(200);
});

5. Trimiți mesajele de pe telefonul clientului

Mesajele fiecărei firme pleacă printr-un client SDK creat cu cheia ei. Un mesaj merge la un singur număr:

import { SmsTunnelNodeClient, SmsTunnelApiError } from '@narcisbodea/smstunnel-sdk/node';

async function anuntaFacturaEmisa(firma, factura) {
  const sms = new SmsTunnelNodeClient({ apiKey: firma.smstunnelKey });
  try {
    await sms.sendSms(
      factura.telefonClient, // format internațional, de exemplu +40712345678
      `${firma.nume}: Factura nr. ${factura.numar} a fost emisă. Total: ${factura.total} lei.`,
    );
  } catch (error) {
    if (error instanceof SmsTunnelApiError) console.error(error.status, error.message);
    else throw error;
  }
}

6. Verifici dacă telefonul clientului e conectat și online

const { activation } = await company.getEnterpriseClient('firma-42');
// activation?.status: 'pending' | 'connected' | 'expired' | 'cancelled'
// activation?.isOnline: dacă telefonul e online chiar acum

Arată starea asta lângă client, în aplicația ta, ca firma să știe dacă mesajele merg înainte să se bazeze pe ele.

Cu NestJS

Dacă serverul tău e în NestJS, modulul din SDK are un mod Enterprise: îi dai cheia Enterprise și id-ul organizației curente, iar SmsTunnelService se ocupă de conectare și de trimitere pentru organizația respectivă.

SmsTunnelModule.forRootAsync({
  useFactory: (settingsModel, tenantService) => ({
    storage: new MongoSmsTunnelStorage(settingsModel),
    callbackBaseUrl: process.env.CALLBACK_URL,
    displayName: 'Aplicația mea',
    enterpriseApiKey: process.env.SMSTUNNEL_ENTERPRISE_API_KEY,
    externalId: tenantService.getCurrentTenantId(),
  }),
  inject: [getModelToken('Settings'), TenantService],
})

Apoi await smsTunnelService.getEnterpriseClientStatus() îți spune dacă telefonul organizației s-a conectat și e online. Celelalte variante de stocare (Prisma, un fișier JSON) sunt în README-ul SDK-ului.

Ce vezi în dashboard

Secțiunea Company are cinci taburi: Overview, Clients, Phones, Apps și Invitations. Între clienți și telefoane relația e de tip mulți la mulți: un client poate conecta mai multe telefoane, iar un telefon poate trimite pentru mai mulți clienți. Așa poate trimite și o firmă care nu are un telefon al ei: la Phones poți împărți cu clienții tăi unul dintre telefoanele tale. Fiecare client și fiecare telefon are pagina lui, cu mesajele trimise în ultimele 30 de zile și cu cele care încă așteaptă un telefon.

Nici nu ai nevoie de cod pentru fiecare client. La Invitations creezi un cod QR pentru un client, i-l trimiți sau i-l arăți, iar el îl scanează în aplicația SMSTunnel și telefonul lui se leagă de contul firmei tale. O aplicație cu cheie proprie îți trebuie doar dacă software-ul tău conectează singur clienții.

Un exemplu real: câte un centru în fiecare județ

Una dintre aplicațiile construite pe acest flux deservește o rețea publică din educație, cu câte un centru în fiecare județ. Aplicația are o singură cheie Enterprise în setări. Fiecare centru județean e un client, cu externalId-ul lui; cineva de la centru scanează o singură dată codul QR cu telefonul centrului, iar de atunci aplicația trimite mesajele acelui centru de pe numărul lui. Oamenii primesc mesaje de la centrul din județul lor, iar când sună înapoi, ajung tot acolo.

Ce trebuie să știi înainte să construiești

• Un destinatar pe mesaj. Fiecare apel trimite un mesaj, de până la 1600 de caractere, către un singur număr. Pentru mai mulți oameni faci câte un apel pentru fiecare.
• Trimite în ritmul potrivit. API-ul primește 30 de cereri de trimitere pe minut pentru fiecare cheie API, pe fiecare endpoint de trimitere (toate cheile unui cont, împreună, de trei ori mai mult). Dacă serverul tău trimite pentru mulți clienți deodată, pune mesajele la coadă și, la un 429, reîncearcă după timpul din antetul Retry-After.
• Un telefon poate fi offline. Dacă telefonul unui client e închis sau fără internet, mesajele lui așteaptă și pleacă atunci când revine, timp de cel mult 3 zile; după aceea sunt marcate ca eșuate.
• Poți reconecta fără grijă. Un nou apel activateEnterpriseClient() pentru același externalId înlocuiește activarea și cheia de dinainte, iar un telefon deja conectat rămâne conectat. Două apeluri suprapuse pentru același client pot primi 409, cu code: 'CONCURRENT_ACTIVATION' sau 'ALREADY_CONNECTED'.
• Cu modulul NestJS, un cod QR nou începe o conectare nouă. Din SDK 2.2.0, createPairingToken() șterge cheia salvată a organizației până când telefonul ei scanează codul nou, deci mesajele ei se opresc între timp. Oferă un cod QR doar cât timp niciun telefon nu e conectat (îți spune getEnterpriseClientStatus()).
• Firmele rămân stăpâne pe telefoanele lor. Proprietarul unui telefon îl poate deconecta din aplicație sau din dashboard.
• Confidențialitate, dacă ai nevoie. Aplicația ta poate cripta fiecare mesaj end-to-end pentru telefonul care îl trimite, iar planul Enterprise include și confidențialitatea maximă, în care și numărul e sigilat.

Cum se compară cu alte variante

Alte unelte care trimit SMS de pe un telefon Android, cum sunt httpSMS și textbee, sunt gândite în jurul unui singur cont, cu telefoanele lui. Din paginile noastre de comparație, verificate în noiembrie 2026:

• httpSMS: cheile de telefon pun mai multe telefoane într-un singur cont, iar fiecare cheie se creează de mână în dashboard-ul lui. Vezi SMSTunnel vs httpSMS.
• textbee: telefoanele aparțin unui singur cont, 1, 5 sau 15, în funcție de plan, fără conturi pentru clienții tăi. Vezi SMSTunnel vs textbee.

Cu oricare dintre ele, soluția obișnuită pentru o aplicație cu mulți clienți e să ceri fiecărei firme să-și facă propriul cont, să-și conecteze telefonul acolo, să creeze o cheie API și s-o lipească în aplicația ta. Merge, dar fiecare firmă trebuie să înțeleagă ce e o cheie API, echipa ta de suport trebuie să explice asta mereu, iar telefoanele clienților nu le vezi niciodată într-un singur loc.

Furnizorii de API SMS, cum e Twilio, rezolvă altă problemă: trimit de pe numere pe care le închiriezi de la ei. Asta se potrivește pentru volume mari și multe țări, dar mesajele nu pleacă de pe numerele clienților tăi.

Cât costă

Planul Enterprise costă 99 $ pe lună sau 990 $ pe an, fără taxe. Clienții din România primesc factura fiscală în lei, la cursul BNR, prin e-Factura. Planul nu are limită zilnică (trimiterea are o limită de ritm, ca să protejeze SIM-urile) și include coduri de autentificare fără limită zilnică, chei API separate pentru fiecare aplicație a ta, confidențialitate maximă și suport dedicat. SMSTunnel nu adaugă taxe pe mesaj: fiecare mesaj intră pe abonamentul telefonului care îl trimite. Toate planurile sunt pe pagina de prețuri, iar comparația de costuri îți arată cât costă un SIM propriu față de un API SMS.

Vrei să încerci mai întâi partea de telefon? Orice plan, inclusiv cel Gratuit, îți permite să-ți conectezi propriul telefon și să trimiți din propriul software. Când vrei să conectezi și telefoanele clienților tăi, planul Enterprise adaugă secțiunea Company și funcțiile de mai sus, iar dacă vrei ajutor la conectarea propriilor sisteme, scrie-ne.

Criptarea e opțională și e inclusă în toate planurile, chiar și în cel Gratuit. Mai jos vezi cum funcționează, ce integrări o au, cum o pornești și, la fel de important, ce nu acoperă. O criptare despre care nu poți spune exact ce protejează nu valorează mare lucru, așa că limitele ei sunt aici la vedere, nu într-o notă de subsol.

Cum funcționează

Sunt trei pași, iar mesajul poate fi citit doar la primul și la ultimul:

1. Software-ul tău criptează. Încuie mesajul cu cheia publică a telefonului tău, pe serverul tău, înainte să plece ceva de acolo. Fiecare telefon are propria pereche de chei RSA-2048: cheia privată nu iese niciodată de pe telefon, iar SMSTunnel păstrează doar cheia publică.
2. SMSTunnel transportă. Serverele noastre doar transmit mai departe textul criptat și îl șterg după ce a fost trimis. Nu putem citi mesajul.
3. Telefonul tău trimite. Doar telefonul tău are cheia privată. Decriptează textul și îl trimite ca SMS obișnuit, de pe numărul tău.

Ce vedem în continuare, cu criptarea pornită: contul tău, telefonul tău și ora fiecărui mesaj, plus numărul la care merge mesajul, dacă nu folosești confidențialitatea maximă (o găsești mai jos).

Ce e criptat și ce nu

Toate conexiunile către SMSTunnel sunt criptate (TLS 1.2 sau mai nou), indiferent dacă mesajul e criptat end-to-end sau nu. Tabelul arată cine poate citi textul după ce ajunge la destinație.

Despre mesajele primite: lucrăm la criptarea lor end-to-end, astfel încât să poată fi citite doar pe telefonul tău și într-o aplicație desktop care urmează.

Pornești criptarea în WordPress

Pluginul SMSTunnel pentru WordPress criptează mesajele site-ului pentru telefonul tău înainte să plece din WordPress. Are nevoie o singură dată de cheia publică a telefonului, pe care o primește printr-un cod QR:

1. În WordPress, mergi la SMSTunnel → Encryption Settings.
2. Pornește conectarea pentru criptare, ca să apară un cod QR.
3. Scanează codul QR cu aplicația SMSTunnel de pe telefon.
4. Gata: mesajele site-ului tău sunt acum criptate end-to-end.

La conectare, telefonul trimite doar cheia lui publică. Cheia privată nu pleacă de pe telefon, așa că SMSTunnel păstrează doar text criptat, pe care nu-l poate citi. Ține minte excepția din tabel: codurile de autentificare pentru conectarea în WordPress nu sunt criptate.

În aplicația de pe telefon, opțiunea apare la Setări ca Criptare end-to-end, „pentru mesajele predate de aplicațiile tale (nu și pentru mesajele primite)”.

Criptezi din propriul cod

Cu SDK-ul pentru Node.js

SDK-ul oficial face totul într-un singur apel: ia cheia publică a telefonului, criptează numărul și textul și trimite rezultatul.

import { SmsTunnelNodeClient } from '@narcisbodea/smstunnel-sdk/node';

const client = new SmsTunnelNodeClient({ apiKey: process.env.SMSTUNNEL_API_KEY! });

// Criptează { to, message } cu cheia publică a telefonului, apoi trimite.
await client.encryptAndSendSms(
  '+40712345678',
  'Bună ziua, rezultatele analizelor dumneavoastră sunt gata.',
  'id-telefon',
);

id-telefon e telefonul care va trimite mesajul: client.getDevices() îți dă lista telefoanelor, cu id-urile lor. În modulul pentru NestJS, smsTunnelService.encryptAndSendSms(to, message) face schimbul de chei cu telefonul la prima folosire și criptează de atunci încolo.

Criptarea se face pe serverul tău. Din browser nu se poate cu SDK-ul, iar cheia API oricum nu are ce căuta într-un browser.

Cu API-ul REST, în orice limbaj

Fără SDK, pașii sunt aceiași:

1. Iei cheia publică a telefonului cu GET /api/v1/devices/{deviceId}/public-key.
2. Criptezi cu ea JSON-ul {"to": "+40712345678", "message": "…"}, pe serverul tău.
3. Trimiți rezultatul la POST /api/v1/sms/send, ca encryptedPayload (base64), cu "encrypted": true, cu deviceId și, în plus, cu to, ca numărul să apară în lista ta de mesaje.

{
  "to": "+40712345678",
  "deviceId": "671fe0d9c3b2a1f0e9d8c7b6",
  "encrypted": true,
  "encryptedPayload": "BASE64_AL_JSON-ULUI_CRIPTAT"
}

Nu trebuie să descoperi singur formatul criptării: când adaugi o aplicație în dashboard și alegi criptarea end-to-end, primești cod gata scris pentru PHP, Node.js, Python și C#. Detaliile sunt în referința API.

O diferență practică: un mesaj criptat intră în limita zilnică a planului și e refuzat după ce o depășești, pentru că nu poate primi scurtul rând „free by smstunnel.io” pe care planul Gratuit îl adaugă mesajelor în plus din ziua respectivă.

Afli când se schimbă cheia telefonului

Dacă aplicația SMSTunnel e reinstalată, telefonul își face o pereche nouă de chei. GET /api/v1/devices/{deviceId}/e2e-status îți spune dacă criptarea e pornită, dacă există o cheie publică, amprenta ei (primele 16 caractere hexazecimale ale unui hash SHA-256) și când a fost creată. Păstrezi amprenta după prima conectare și o compari înainte să trimiți:

const rezultat = await client.verifyDeviceKey('id-telefon', amprentaSalvata);
if (rezultat.needsRePairing) {
  // Aplicația a fost reinstalată și cheia s-a schimbat: conectează din nou înainte să trimiți.
}

Confidențialitate maximă: ascunzi și numărul

Criptarea end-to-end ascunde textul. În planurile Profesional și Enterprise, confidențialitatea maximă ascunde și numărul, așa că nu putem vedea cui îi e adresat mesajul.

Funcționează cu un certificat privat creat de tine, protejat de o parolă pe care o știi doar tu. Pui certificatul în software-ul tău și pe telefon, cheia nu trece niciodată prin serverele noastre, iar de atunci telefonul refuză orice mesaj care nu e sigilat cu el, inclusiv mesajele scrise în dashboard.

1. Creezi certificatul

În dashboard: Apps → Add an app → Encrypt end to end → Maximum privacy, unde primești și cod gata scris pentru PHP, Node.js, Python și C#. Sau îl creezi pe propriul computer, de unde nu pleacă nimic:

npx -p @narcisbodea/smstunnel-sdk smstunnel-make-certificate

Comanda îți cere o parolă de cel puțin 12 caractere și salvează fișierul smstunnel-certificate.json.

2. Îl pui pe telefon

În aplicația SMSTunnel (versiunea 1.0.9 sau mai nouă), deschizi Setări → Certificat privat și lipești conținutul fișierului. Dacă preferi să scanezi un cod QR, dashboard-ul îți arată unul la Apps → Maximum privacy → „I already have one”.

3. Trimiți mesaje sigilate

import { readFileSync } from 'node:fs';
import { SmsTunnelNodeClient, openCertificate } from '@narcisbodea/smstunnel-sdk/node';

const client = new SmsTunnelNodeClient({ apiKey: process.env.SMSTUNNEL_API_KEY! });
const certificat = openCertificate(
  readFileSync('smstunnel-certificate.json', 'utf8'),
  process.env.SMSTUNNEL_CERT_PASSWORD, // parola stă în mediu, nu în cod
);

await client.sendSealedSms('+40712345678', 'Rezultatele sunt gata.', 'id-telefon', certificat);

Prin API-ul REST, un mesaj sigilat se trimite ca encryptedPayload, cu "encrypted": true și deviceId, fără to.

Ce trebuie să știi înainte să-l pornești:

• Vedem în continuare contul tău, telefonul tău și ora fiecărui mesaj.
• Dacă sincronizezi în cont mesajele primite, un răspuns arată numărul de la care a venit.
• Software-ul tău are nevoie de certificat și de parola lui ca să trimită. Ține parola în afara codului, de exemplu într-o variabilă de mediu.
• Nu putem recupera un certificat sau o parolă pierdută. Dacă pierzi una dintre ele, faci un certificat nou și îl pui din nou pe telefon și în software.
• În celelalte planuri, un mesaj fără to sau unul sigilat cu un certificat e refuzat, cu codul 403.

Cum se compară

Dintre uneltele care trimit SMS de pe propriul telefon Android, httpSMS are și el criptare end-to-end opțională: pui o cheie în aplicația lui și aceeași cheie în codul tău, pentru mesajele trimise și pentru cele primite. Pentru textbee, nu am găsit criptare end-to-end în documentație, care spune că traficul API folosește HTTPS și că mesajele sunt păstrate pe serverele lui. SMSTunnel folosește câte o pereche de chei pentru fiecare telefon, așa că cheia care îți descuie mesajele nu pleacă niciodată de pe telefon, și adaugă confidențialitatea maximă pentru număr în planurile Profesional și Enterprise.

Întrebări frecvente

Poate SMSTunnel să-mi citească mesajele criptate?

Nu. Avem doar cheia publică a telefonului, care poate încuia un mesaj, dar nu îl poate descuia, iar textul criptat îl ștergem după ce a fost trimis.

E criptat SMS-ul și pe drumul până la destinatar?

Nu. Aici, end-to-end înseamnă de la software-ul tău până la telefonul tău. După ce telefonul îl trimite, e un SMS obișnuit în rețeaua mobilă.

Costă în plus criptarea?

Nu. E inclusă în toate planurile, inclusiv în cel Gratuit. Confidențialitatea maximă vine cu Profesional (39 $ pe lună) și Enterprise (99 $ pe lună), fără taxe; vezi pagina de prețuri.

O pot folosi într-o aplicație cu mulți clienți?

Da. Pe Enterprise, fiecare client își conectează propriul telefon, iar aplicația ta poate cripta fiecare mesaj pentru telefonul care îl va trimite.

Mai jos vezi ce intră în fiecare factură, cu un calcul pe care îl poți refolosi pentru cifrele tale. Prețurile furnizorilor sunt cele din SUA, notate de paginile noastre de comparație în noiembrie 2026. Ele arată cum se construiește factura, dar pentru România prețurile sunt altele, așa că verifică lista fiecărui furnizor la țara România. Planurile SMSTunnel sunt cele de pe pagina de prețuri.

Înainte de cifre, o precizare cinstită: cele două variante nu fac aceeași treabă. Un API SMS livrează fiecare mesaj prin rețelele operatorilor, iar prețul pe mesaj plătește exact asta. Cu SMSTunnel, livrarea o face telefonul tău, deci fiecare mesaj e plătit prin abonamentul tău, nu de SMSTunnel.

Ce plătești la un API SMS

Factura unui furnizor are mai multe rânduri:

• Prețul pe segment. Un segment are cel mult 160 de caractere. În SUA, Twilio cere 0,0083 $ pe segment trimis sau primit, Vonage 0,0086 $ pe mesaj trimis, iar Plivo 0,0077 $ pe segment, dar oferă SMS doar în planul Enterprise, de la 1.000 $ pe lună.
• Numărul de pe care trimiți. De obicei se închiriază lunar: la Twilio, un număr local din SUA costă 1,15 $ pe lună. Un nume de expeditor, cum ar fi numele magazinului, se poate folosi doar în țările care îl permit.
• Taxele operatorilor. În SUA, operatorii adaugă o taxă pentru fiecare mesaj trimis, între 0,0035 $ și 0,005 $, pe care furnizorul ți-o trece în factură.
• Înregistrarea. În SUA, firma și tipul mesajelor trebuie înregistrate (A2P 10DLC): la Twilio plătești o dată 4,50 $ sau 46 $ pentru firmă și 15 $ pentru fiecare tip de mesaje, apoi între 1,50 $ și 10 $ pe lună.
• Răspunsurile. Fiecare răspuns al clienților e un mesaj primit și se plătește și el.

De ce contează diacriticele

Un singur caracter din afara alfabetului GSM de bază, cum sunt ă, â, î, ș, ț sau majoritatea emoji-urilor, reduce de obicei segmentul de la 160 la 70 de caractere. Un mesaj de 120 de caractere cu diacritice înseamnă, de regulă, două segmente; fără diacritice, unul singur. La un API plătești fiecare segment, iar abonamentul tău numără de obicei la fel părțile unui mesaj lung.

Concluzia practică: ține mesajele scurte. „Comanda ta #1042 a fost expediată. Total: 249,90 lei.” are 53 de caractere și încape într-un singur SMS chiar și cu diacritice. Dacă ai nevoie de un text mai lung și vrei să rămână un singur SMS, îl poți scrie fără diacritice.

Ce plătești când trimite telefonul tău

SMSTunnel are un preț fix, lunar sau anual, fără nimic pe mesaj, pe număr sau pentru înregistrare:

Plata anuală costă cât zece luni: 90 $, 190 $, 390 $ sau 990 $ pe an. Prețurile sunt în dolari americani, fără taxe. Clienții din România primesc factura fiscală în lei, la cursul BNR, prin e-Factura, iar NARBOWEB SRL este neplătitor de TVA. Nu semnezi niciun contract: planul e lunar sau anual și renunți oricând. La plan se numără doar mesajele pe care le trimiți, nu și cele pe care le primește telefonul.

Apoi vine abonamentul tău. Mesajele pleacă de pe SIM-ul tău, deci se aplică SMS-urile incluse sau tarifele operatorului tău, inclusiv pentru mesajele către alte țări. Multe abonamente de la operatorii din România includ SMS-uri nelimitate, dar un abonament personal poate interzice folosirea în scop comercial. Verifică ce scrie în contract înainte ca magazinul tău să le scrie clienților de pe el; pentru mesajele firmei, un abonament pe firmă e de obicei alegerea potrivită.

Un calcul pentru magazinul tău

Pentru un API, formula e simplă: numărul de mesaje × segmentele fiecărui mesaj × prețul pe segment pentru România, plus numărul sau numele de expeditor și eventualele taxe lunare. Iată calculul cu prețurile din SUA, ca să vezi ordinul de mărime.

1.000 de mesaje pe lună

Un magazin online cu 1.000 de comenzi pe lună trimite câte un mesaj la fiecare comandă, de un segment. La Twilio, în SUA:

• 1.000 × 0,0083 $ = 8,30 $ pentru mesaje;
• între 3,50 $ și 5 $ taxele operatorilor;
• 1,15 $ numărul;
• între 1,50 $ și 10 $ pe lună înregistrarea, după 19,50–61 $ plătiți o singură dată.

Asta înseamnă cam 14,45–24,45 $ pe lună, fără răspunsuri.

Cu SMSTunnel, 1.000 de mesaje pe lună înseamnă cam 33 pe zi, peste cele 25 din planul Gratuit, deci alegi Starter: 9 $ pe lună sau 90 $ pe an, plus abonamentul tău. Ghidul pentru WooCommerce arată configurarea pas cu pas pentru un magazin.

10.000 de mesaje pe lună

Cu aceleași prețuri din SUA, doar mesajele costă 83 $, taxele operatorilor adaugă 35–50 $, iar numărul și înregistrarea încă câțiva dolari: cam 120–145 $ pe lună.

Cu SMSTunnel, 10.000 de mesaje pe lună înseamnă cam 330 pe zi, peste cele 300 din Starter, deci planul Standard, la 19 $ pe lună, plus abonamentul tău. La un asemenea volum, verifică dacă abonamentul permite atâtea mesaje și ține cont că un telefon trimite în ritmul lui.

Codurile de autentificare

Twilio Verify trimite codurile și le verifică în locul tău: 0,05 $ pentru fiecare verificare reușită, plus 0,0083 $ pe mesaj, în SUA. Vonage Verify cere 0,06084 $ pe verificare reușită plus mesajul, iar Plivo Verify nu are taxă de verificare, plătești doar mesajul. Cu SMSTunnel, aplicația ta generează și verifică singură codul, iar SMSTunnel trimite mesajul, cu o cotă separată: 50 de coduri pe zi în planul Gratuit și fără limită zilnică în planurile plătite. Detaliile sunt în ghidul despre codurile de autentificare.

Alte unelte care trimit de pe telefon

SMSTunnel nu e singura unealtă care trimite de pe un telefon Android. textbee are un plan gratuit cu 50 de mesaje pe zi (300 pe lună) pe un singur telefon, în care se numără și mesajele primite, apoi Pro la 14,99 $ și Scale la 29,99 $ pe lună. httpSMS are 200 de mesaje gratuite pe lună, trimise și primite la un loc, și planuri plătite între 10 $ și 350 $ pe lună. Ca și SMSTunnel, niciuna nu te taxează pe mesaj: plătești tarifele operatorului tău. Amândouă sunt open source, le poți instala pe serverul tău și se instalează pe telefon dintr-un fișier APK, nu din Google Play.

Când merită un API SMS

Un API SMS e alegerea mai bună când:

• trimiți volume mari: numerele înregistrate și numerele scurte trimit multe mesaje pe secundă, pe când SMSTunnel trimite cât poate un telefon;
• ai nevoie de un număr scurt, de un număr gratuit (toll-free) sau de un nume de expeditor în locul unui număr de telefon;
• livrarea nu are voie să depindă de un telefon pornit și conectat la internet;
• trimiți în multe țări și nu vrei câte un SIM pentru fiecare;
• vrei MMS, WhatsApp sau RCS din același API, ori un serviciu care verifică singur codurile de autentificare;
• nu ai un telefon Android pe care să-l ții pornit și conectat.

Poți folosi și ambele variante: numerele de la furnizor funcționează în continuare, iar mesajele de zi cu zi pleacă de pe numărul tău.

Limitele unui singur telefon

Un plan fix nu transformă telefonul într-un operator. Ține cont de aceste limite:

• Ritmul. API-ul primește 30 de cereri de trimitere pe minut, pe fiecare endpoint de trimitere.
• Limitele zilnice. Gratuit, Starter și Standard au limite zilnice. Profesional și Enterprise nu au, dar au o limită de ritm, ca să-ți protejeze SIM-ul.
• Un destinatar pe mesaj. Fiecare om primește propriul mesaj.
• Un telefon pornit. Dacă telefonul e offline, mesajul așteaptă și pleacă atunci când revine, timp de cel mult 3 zile; după aceea e marcat ca eșuat.
• Starea mesajului. Afli dacă e în așteptare, trimis sau eșuat, așa cum raportează telefonul tău.

Dacă aplicația ta trimite mesaje pentru mai mulți clienți, fiecare de pe telefonul și numărul lui, ai nevoie de planul Enterprise: vezi articolul despre SMS de pe numărul fiecărui client.

Întrebări frecvente

Plătesc ceva pe mesaj la SMSTunnel?

Nu. Planurile au preț fix, iar mesajele pleacă de pe SIM-ul tău, deci se aplică SMS-urile incluse sau tarifele obișnuite ale operatorului tău.

Primesc factură în lei?

Da. Prețurile sunt în dolari americani, fără taxe, iar clienții din România primesc factura fiscală în lei, la cursul BNR, prin e-Factura. NARBOWEB SRL este neplătitor de TVA.

Îmi ajunge planul Gratuit?

Pentru teste și volume mici, da, și nu cere card bancar: 25 de mesaje pe zi și 500 pe lună, trimise exact cum le-ai scris, plus 50 de coduri de autentificare pe zi. Mesajele pe care software-ul tău le trimite peste această limită, până la încă 25 pe zi, se încheie cu rândul „free by smstunnel.io”. Planurile plătite nu adaugă nimic.

Într-un magazin online din România, telefonul sună des cu aceeași întrebare: „Ați primit comanda mea?” sau „Când vine curierul?”. Un SMS scurt, trimis exact când se schimbă starea comenzii, răspunde la întrebare înainte să fie pusă. Contează mai ales la comenzile cu plata ramburs, unde clientul vrea să știe că totul e în regulă și să aibă banii pregătiți când vine curierul.

De obicei, pentru asemenea mesaje îți faci cont la un furnizor de API SMS, cum e Twilio: închiriezi un număr de la el și plătești fiecare mesaj. Pentru multe magazine mici există o cale mai simplă. Magazinul tău WooCommerce îi predă fiecare mesaj contului tău SMSTunnel, iar aplicația SMSTunnel de pe telefonul tău Android îl trimite de pe numărul tău, cu SIM-ul și abonamentul tău. Clientul vede numărul magazinului, la care poate suna sau răspunde, iar SMSTunnel nu cere bani pentru fiecare mesaj.

Mai jos configurezi totul de la zero, cu două pluginuri gratuite de pe WordPress.org: pluginul de bază SMSTunnel, care leagă site-ul de telefon, și SMSTunnel for WooCommerce, care adaugă mesajele pentru comenzi.

Cum funcționează

1. În magazin se întâmplă ceva: un client plasează o comandă sau tu treci o comandă în starea Finalizată (Completed).
2. Add-on-ul scrie mesajul după șablonul tău și îl predă contului tău SMSTunnel.
3. Aplicația SMSTunnel de pe telefonul tău îl trimite ca SMS obișnuit, de pe numărul tău.

Fiecare mesaj merge la un singur număr: telefonul de facturare al comenzii. Dacă telefonul tău e offline o vreme, mesajele așteaptă în cont și pleacă atunci când revine online, timp de cel mult 3 zile.

De ce ai nevoie

• WordPress 5.0 sau mai nou, PHP 7.4 sau mai nou și WooCommerce 5.0 sau mai nou
• Un telefon Android (Android 7.0 sau mai nou) cu SIM, care rămâne pornit și conectat la internet; poate fi chiar telefonul firmei, cu numărul pe care clienții îl știu deja
• Aplicația SMSTunnel din Google Play, autentificată în contul tău SMSTunnel (planul Gratuit nu cere card bancar)
• Pluginul de bază SMSTunnel și SMSTunnel for WooCommerce, ambele gratuite pe WordPress.org

Pasul 1: leagă site-ul de telefon

Instalează întâi pluginul de bază: în administrarea WordPress mergi la Module → Adaugă modul, cauți SMSTunnel, apeși Instalează acum și apoi Activează.

Deschide SMSTunnel → Quick Setup. În aplicația SMSTunnel de pe telefon intri la Conexiuni → Conectează cu cod QR, scanezi codul și aprobi conexiunea pe telefon. Conexiunea o poți elimina oricând din aplicație, de la Conexiuni.

Dacă preferi o cheie API, o creezi în dashboard, la Apps → Add an app, și o folosești în WordPress la SMSTunnel → Settings → Connect with API Key.

Pasul 2: instalează SMSTunnel for WooCommerce

Tot din Module → Adaugă modul cauți SMSTunnel for WooCommerce, apeși Instalează acum și Activează. Setările lui sunt în WooCommerce → Setări → SMS.

Add-on-ul merge atât cu blocul Checkout, cât și cu pagina clasică de finalizare a comenzii, și e compatibil cu High-Performance Order Storage (HPOS).

Pasul 3: alege la ce stări pleacă un mesaj

În tab-ul SMS, fiecare mesaj pentru client are propriul comutator: „New Order (Pending)” (comanda așteaptă plata, de exemplu cât timp clientul plătește pe alt site), „Order Processing”, „Order Completed”, „Order On Hold”, „Order Cancelled”, „Order Refunded” și „Shipment Tracking” (numărul de urmărire al coletului).

Primele trei sunt pornite implicit, iar add-on-ul urmează tab-ul de la început, chiar dacă nu l-ai salvat niciodată. Așa că deschide tab-ul imediat după activare și debifează ce nu vrei.

La plasarea comenzii, clientul primește un singur mesaj. Dacă comanda încă așteaptă plata, de exemplu cât timp clientul plătește cu cardul pe site-ul procesatorului de plăți, pleacă „New Order (Pending)”. Altfel pleacă mesajul pentru starea pe care o are comanda în acel moment, de exemplu „Order Processing” la plata ramburs.

Captura vine dintr-o versiune mai veche, care avea sus o bifă „Enable WooCommerce 2FA”. Bifa nu făcea nimic și a fost scoasă în versiunea 1.0.5: codurile de autentificare pentru „Contul meu” vin din pluginul de bază (vezi întrebările de la final).

Pasul 4: scrie mesajele în română

Mesajele implicite sunt în engleză, așa că le rescrii la SMS Message Templates, cu variabilele add-on-ului:

Câteva variante în română:

• Comandă nouă: „Bună, {customer_first_name}! Am primit comanda #{order_id} ({order_total}) pe {site_name}. Te anunțăm când pleacă spre tine.”
• Comandă în procesare: „Comanda ta #{order_id} e confirmată și o pregătim de livrare.”
• Comandă finalizată: „Comanda #{order_id} a fost finalizată. Îți mulțumim că ai cumpărat de pe {site_name}!”

Mesajul pentru „Order Processing” pleacă și la comenzile cu plata ramburs, și la cele plătite online, așa că nu scrie în el ceva valabil doar pentru unele dintre ele.

Mesaje pentru tine: comenzi noi și stoc redus

În același tab pui numărul tău la Admin Phone Number (un singur număr, cu +40 în față) și pornești:

• Notify Admin on New Order: un mesaj pentru fiecare comandă plasată, chiar dacă mesajul pentru client e oprit sau clientul nu și-a lăsat numărul
• Low Stock Alert: un mesaj când un produs are stoc redus sau epuizat

Numărul de urmărire (AWB)

Mesajul „Shipment Tracking” pleacă atunci când adaugi un număr de urmărire cu pluginul gratuit Advanced Shipment Tracking, câte un mesaj pentru fiecare număr. Celelalte pluginuri de urmărire nu anunță alte pluginuri când adaugă un număr, așa că nu sunt acceptate direct.

Dacă AWB-urile tale vin din pluginul unui curier, un dezvoltator poate trimite mesajul din cod, declanșând acțiunea pe care o ascultă add-on-ul:

do_action( 'woocommerce_shipment_tracking_number_added', $order_id, $tracking_number, $tracking_provider );

Cere numărul cu +40 la finalizarea comenzii

Mesajele pentru client merg la telefonul de facturare, exact cum l-a scris clientul. Add-on-ul nu verifică și nu completează numărul, iar unul fără + și prefixul țării poate ajunge în altă țară. Comenzile fără telefon nu primesc niciun mesaj.

Mulți clienți scriu din obișnuință „0721 123 456”. Spune-le clar pe pagina de finalizare a comenzii, în eticheta câmpului sau într-o notă scurtă, că numărul trebuie scris cu prefixul țării: „+40 721 123 456”.

În pagina comenzii ai și o casetă Send SMS, pentru un mesaj ocazional către client, iar mesajele trimise la schimbarea stării apar în notele comenzii.

Câte mesaje trimite magazinul tău?

Socotește două-trei mesaje pe comandă (unul la plasare, unul la finalizare, poate unul cu AWB-ul), plus unul pentru tine, dacă ai pornit alerta de comandă nouă.

• Gratuit: 25 de mesaje pe zi și 500 pe lună, trimise exact cum le-ai scris; site-ul mai poate trimite până la 25 pe zi, care se încheie cu un scurt rând „free by smstunnel.io”.
• Starter, 9 $ pe lună: 300 de mesaje pe zi și 5.000 pe lună.
• Standard, 19 $ pe lună: 2.000 de mesaje pe zi și 30.000 pe lună.

Un magazin cu câteva comenzi pe zi se descurcă pe planul Gratuit. Unul cu zece comenzi pe zi și trei mesaje pe comandă trimite cam 30 de mesaje pe zi și are nevoie de Starter. Prețurile sunt în dolari, fără taxe, iar clienții din România primesc factura fiscală în lei, la cursul BNR, prin e-Factura. Mesajele pleacă prin abonamentul tău, deci se aplică tarifele operatorului pentru SMS sau SMS-urile incluse în abonament; verifică dacă abonamentul permite folosirea în scop comercial. Detalii pe pagina de prețuri și în comparația dintre SIM-ul propriu și un API SMS.

Când rămâne Twilio alegerea mai bună

Telefonul tău e potrivit pentru mesajele pe care un telefon le trimite fără efort: stări de comandă, mementouri, coduri de autentificare. Un furnizor de API SMS se potrivește mai bine dacă trimiți volume mari, vrei un nume de expeditor în locul unui număr, ai nevoie de coduri scurte sau scrii clienților din multe țări. Comparația completă e pe SMSTunnel vs Twilio, iar cele două pot merge și împreună.

Întrebări frecvente

Pot clienții să răspundă?

Da. Mesajele pleacă de pe numărul tău, așa că răspunsurile ajung pe telefonul tău ca orice alt SMS. Dacă pornești în aplicație sincronizarea mesajelor primite, le poți citi și poți răspunde la ele și de pe computer.

Pot pune coduri de autentificare prin SMS la „Contul meu”?

Da, din pluginul de bază: pornești WordPress Login 2FA la SMSTunnel → Settings, iar opțiunea acoperă și autentificarea din „Contul meu” WooCommerce. Pașii sunt în ghidul despre coduri de autentificare prin SMS fără Twilio.

Merge și cu pluginurile de abonamente?

Mesajele de stare urmează orice schimbare de stare a unei comenzi WooCommerce, inclusiv pe cele făcute de pluginurile de abonamente.

Pot cripta mesajele despre comenzi?

Da, opțional. Pornești criptarea end-to-end în setările pluginului de bază, iar site-ul criptează fiecare mesaj pentru telefonul tău înainte să plece din WordPress, așa că SMSTunnel nu poate citi textul. Un mesaj criptat intră în limita zilnică și e refuzat peste ea, pentru că nu poate purta rândul „free by smstunnel.io”. Ce se criptează și ce nu, în articolul despre SMS criptat end-to-end.

Codurile de autentificare prin SMS sunt, de obicei, primul motiv pentru care un proiect își face cont la un API de SMS. Închiriezi un număr, îl înregistrezi acolo unde țara destinatarilor o cere și plătești pentru fiecare mesaj și pentru fiecare verificare. Dacă utilizatorii aplicației tale sunt mai ales în România, există o cale mai simplă: codurile pleacă de pe un telefon Android pe care îl ai deja, cu abonamentul pe care îl plătești deja.

Asta face SMSTunnel. Platforma ta de autentificare generează și verifică în continuare codurile, exact ca acum. Un pachet mic, @narcisbodea/smstunnel-otp, predă fiecare cod contului tău SMSTunnel, iar aplicația SMSTunnel de pe telefon îl trimite de pe SIM-ul tău. Utilizatorii primesc codul de la un număr pe care îl recunosc și la care pot răspunde.

Mai jos găsești cele patru platforme la care pachetul se leagă în câteva rânduri de cod (Supabase Auth, Auth0, Clerk și Better Auth), Ory, care nu are nevoie de cod deloc, autentificarea în WordPress și limitele pe care e bine să le știi înainte să treci pe telefonul tău.

Cum funcționează

1. Un utilizator cere un cod: se conectează cu numărul de telefon, își adaugă unul sau confirmă autentificarea în doi pași.
2. Platforma ta generează codul și apelează hook-ul, Action-ul, webhook-ul sau funcția ta, în locul furnizorului de SMS.
3. Pachetul trimite mesajul la endpoint-ul SMSTunnel pentru coduri, POST /api/v1/sms/send-2fa, cu cheia ta API.
4. Contul tău SMSTunnel îi predă mesajul telefonului, iar telefonul îl trimite de pe numărul tău.
5. Utilizatorul tastează codul, iar platforma ta îl verifică, la fel ca până acum.

SMSTunnel nu verifică niciodată codurile. Spre deosebire de Twilio Verify, nu le generează și nu le validează: de asta se ocupă platforma ta, iar SMSTunnel doar livrează mesajul. Codurile au și o limită zilnică proprie, separată de celelalte mesaje, așa că o dimineață cu multe conectări nu consumă din notificările despre comenzi sau din mementouri.

Pachetul nu are dependențe la rulare (folosește doar Fetch și WebCrypto), deci merge în Node 18+, Deno (Supabase Edge Functions), Bun, Cloudflare Workers și Auth0 Actions.

Înainte să începi

1. Instalează aplicația SMSTunnel din Google Play pe telefonul tău Android și autentifică-te. Intră în dashboard cu același cont: telefonul apare la Phones.
2. În dashboard, deschide Apps → Add an app, alege Website or web app, dă-i un nume și apasă Create the key. Copiază cheia imediat, pentru că apare o singură dată. Păstreaz-o în secretele platformei, niciodată în cod care rulează în browser.
3. Folosește coduri de 4 până la 10 cifre. Codurile implicite de 6 cifre ale platformelor de mai jos sunt în regulă; cele cu litere nu sunt acceptate.

Apoi instalează pachetul:

npm install @narcisbodea/smstunnel-otp

Supabase Auth: hook-ul Send SMS

În locul furnizorului de SMS integrat, Supabase poate apela un endpoint HTTPS cu numărul utilizatorului și codul. Pachetul îți dă acest endpoint, cu tot cu verificarea semnăturii Standard Webhooks. Creează supabase/functions/send-sms/index.ts:

import { createSupabaseSendSmsHook } from 'npm:@narcisbodea/smstunnel-otp@^1.0.0';

Deno.serve(
  createSupabaseSendSmsHook({
    apiKey: Deno.env.get('SMSTUNNEL_API_KEY')!,
    hookSecret: Deno.env.get('SEND_SMS_HOOK_SECRETS')!, // v1,whsec_...
    template: 'Codul tău Acme este {code}', // opțional
  }),
);

Publică funcția fără verificarea JWT, pentru că o protejează semnătura:

supabase functions deploy send-sms --no-verify-jwt

În Supabase Dashboard, deschide Authentication → Hooks → Add a new hook → Send SMS hook, alege HTTPS, scrie https://<project-ref>.supabase.co/functions/v1/send-sms, apoi apasă Generate secret și Create. Salvează cele două secrete:

supabase secrets set SMSTUNNEL_API_KEY=... SEND_SMS_HOOK_SECRETS='v1,whsec_...'

La final, pornește furnizorul din Authentication → Sign In / Providers → Phone. Câmpurile pentru furnizorul de SMS nu se mai folosesc cât timp hook-ul e pornit. Lasă confirmarea automată a telefonului oprită, altfel înscrierile nu mai cer niciun cod.

Hook-ul trimite codul la numărul primit de la Supabase și adaugă semnul + pe care Supabase îl omite. Dacă SMSTunnel e ocupat sau nu poate fi contactat, răspunde cu 429 sau 503 și retry-after, iar Supabase reîncearcă în cele cinci secunde pe care le are la dispoziție. Pașii compleți, cu configurarea pentru dezvoltare locală, sunt pe pagina Supabase Auth.

Auth0: o Action de tip Custom Phone Provider

Auth0 își poate preda mesajele pentru telefon unei Action. Declanșatorul custom-phone-provider e cel recomandat de Auth0: un singur furnizor pentru MFA, conectare fără parolă prin SMS și înscriere cu numărul de telefon.

1. Deschide Branding → Phone Provider → Custom și alege metoda de livrare Text.
2. În editorul de Action, adaugă dependența @narcisbodea/smstunnel-otp și secretul SMSTUNNEL_API_KEY, apoi lipește:

const { createAuth0CustomPhoneProvider } = require('@narcisbodea/smstunnel-otp');

const sendWithSmsTunnel = createAuth0CustomPhoneProvider();

exports.onExecuteCustomPhoneProvider = async (event, api) => {
  await sendWithSmsTunnel(event, api);
};

3. Salvează și folosește Send Test Message. Pentru MFA, pornește și Use Tenant-Level Messaging Provider din Security → Multi-factor Auth → Phone Message.

Codurile pleacă cu textul generat de Auth0, adică cu șablonul tău, în limba utilizatorului. Notificările fără cod, cum ar fi un cont blocat sau o parolă compromisă, pleacă drept mesaje obișnuite sau sunt ignorate dacă dai opțiunea { nonCodeMessages: 'skip' }. SMSTunnel trimite doar mesaje text, așa că o livrare prin apel vocal e refuzată, cu motivul explicat. Dacă îți trebuie doar MFA, merge și declanșatorul mai vechi Send Phone Message; ambele variante sunt pe pagina Auth0.

Clerk: webhook-ul sms.created

Când oprești Delivered by Clerk pentru un șablon de SMS, Clerk nu mai trimite el mesajul și îți trimite în schimb un webhook sms.created. În Next.js, ajunge fișierul app/api/webhooks/clerk-sms/route.ts:

import { createClerkSmsWebhook } from '@narcisbodea/smstunnel-otp';

export const POST = createClerkSmsWebhook({
  apiKey: process.env.SMSTUNNEL_API_KEY!,
  signingSecret: process.env.CLERK_SMS_WEBHOOK_SIGNING_SECRET!, // whsec_...
});

1. În Clerk Dashboard, deschide Webhooks → Add Endpoint, scrie adresa ta, abonează-te la sms.created și copiază Signing Secret.
2. La Customization → SMS, deschide fiecare șablon pe care vrei să-l trimiți de pe telefon (Verification code, Reset password code…) și oprește Delivered by Clerk. Setarea se face separat pentru fiecare șablon.
3. Lasă ruta publică în middleware-ul Clerk: webhook-urile nu au sesiune.

Handlerul verifică semnătura Svix și trimite textul generat de Clerk, după ce se asigură că acesta conține codul. Pentru Express și alte framework-uri, vezi pagina Clerk.

Better Auth: pluginul phoneNumber

Pluginul phoneNumber din Better Auth te întreabă cum să-și trimită codurile, iar smstunnelSendOTP() îi răspunde:

import { betterAuth } from 'better-auth';
import { phoneNumber } from 'better-auth/plugins';
import { smstunnelSendOTP } from '@narcisbodea/smstunnel-otp';

const apiKey = process.env.SMSTUNNEL_API_KEY!;

export const auth = betterAuth({
  plugins: [
    phoneNumber({
      sendOTP: smstunnelSendOTP({ apiKey, template: 'Codul tău Acme este {code}' }),
      sendPasswordResetOTP: smstunnelSendOTP({ apiKey, template: 'Codul Acme pentru resetarea parolei este {code}' }),
    }),
  ],
});

Better Auth rulează sendOTP în fundal când poate, așa că autentificarea nu așteaptă trimiterea. Utilizatorii din România își scriu adesea numărul ca 0721 123 456, fără prefixul țării. Pentru ei, adaugă opțiunea defaultCountryCode: '40', sau verifică numerele cu phoneNumberValidator din plugin. Celelalte opțiuni sunt pe pagina Better Auth.

Ory, WordPress și orice altă platformă

Ory (Kratos găzduit la tine sau Ory Network) nu are nevoie de pachet: canalul HTTP al curierului său apelează direct SMSTunnel, cu câteva rânduri de configurare. Vezi pagina Ory.

Site-urile WordPress primesc coduri de autentificare din pluginul SMSTunnel: SMSTunnel → Settings → Two-Factor Authentication (2FA), apoi WordPress Login 2FA. Acoperă și autentificarea din „Contul meu” al magazinelor WooCommerce, pentru rolurile pe care le alegi, iar codurile sunt valabile implicit 5 minute.

Orice altă platformă poate folosi sendCode() din același pachet:

import { sendCode, SmsTunnelOtpError } from '@narcisbodea/smstunnel-otp';

await sendCode({
  apiKey: process.env.SMSTUNNEL_API_KEY!,
  to: '+40712345678',
  code: '123456',
  template: 'Codul tău Acme este {code}', // sau message: 'textul întreg'; codul e adăugat dacă lipsește
  // deviceId, defaultCountryCode, serverUrl, timeoutMs (implicit 10000)
});

Când ceva nu merge, aruncă o eroare SmsTunnelOtpError, cu status (codul HTTP), un code precum RATE_LIMITED și retryable: true pentru erorile la care merită să reîncerci.

Ce înseamnă „cod” pentru SMSTunnel

Endpoint-ul pentru coduri refuză mesajele fără cod:

• Un cod are între 4 și 10 cifre de sine stătătoare (482913, Cod: 1234, G-123456) sau două grupuri de câte 3 cifre legate prin cratimă (123-456).
• Nu sunt coduri: combinațiile cu litere, numerele de 11 cifre sau mai lungi, cifrele scrise imediat după + (un număr de telefon) și cifrele lipite de altele prin ., ,, : sau /, cum ar fi prețurile, orele și datele.
• Un mesaj poate avea cel mult 320 de caractere. Pachetul refuză unul mai lung înainte să apeleze SMSTunnel.

Un mesaj fără cod e refuzat cu eroarea 400. Mesajele care nu conțin coduri pleacă prin endpoint-ul obișnuit de trimitere.

Limite și când se potrivește mai bine un API de SMS

Înainte să treci pe telefonul tău, e bine să știi câteva lucruri:

• Un singur număr pe mesaj. Fiecare cod merge la o singură persoană.
• 30 de trimiteri pe minut. Peste această limită, SMSTunnel răspunde cu 429, iar pachetul marchează eroarea ca una la care se poate reîncerca.
• Telefonul trebuie să fie pornit și conectat la internet. Dacă e offline, codul așteaptă și pleacă imediat ce telefonul revine. Un cod care așteaptă prea mult poate expira până ajunge, așa că ține telefonul încărcat și conectat.
• Limita zilnică. Planul Gratuit include 50 de coduri de autentificare pe zi. Începând cu planul Starter, de 9 $ pe lună, codurile de autentificare nu mai au limită zilnică. Prețurile sunt în dolari, fără taxe, iar clienții din România primesc factura fiscală în lei, la cursul BNR, prin e-Factura.
• Se aplică condițiile operatorului tău, pentru că mesajele pleacă prin abonamentul tău de telefonie mobilă.

Ca reper, paginile Twilio indicau, când le-am verificat în noiembrie 2026, 0,05 $ pentru fiecare verificare reușită prin Twilio Verify, plus 0,0083 $ pentru fiecare SMS în SUA, iar prețurile diferă de la o țară la alta. Twilio sau un alt furnizor de API pentru SMS rămâne alegerea mai bună dacă trimiți volume mari, ai nevoie de numere scurte (short codes), de un nume de expeditor în locul numărului, de numere 10DLC în SUA sau de multe țări. Le poți folosi și pe amândouă: vezi SMSTunnel comparat cu Twilio și cât costă SMS-urile trimise de pe SIM-ul tău.

Întrebări frecvente

Trebuie să schimb felul în care platforma generează sau verifică codurile?

Nu. Supabase, Auth0, Clerk, Better Auth și Ory generează, păstrează și verifică în continuare codurile. Se schimbă doar livrarea.

Pot scrie eu textul mesajului?

Da. Dă o opțiune template cu {code} în locul în care vrei codul, de exemplu „Codul tău Acme este {code}”. Fără ea, Auth0 și Clerk trimit textul generat din propriile șabloane.

Pot trimite coduri de pe mai multe telefoane?

Poate trimite oricare dintre telefoanele legate de contul tău. sendCode() și smstunnelSendOTP() primesc un deviceId ca să alegi unul, iar Action-ul din Auth0 îl citește din secretul SMSTUNNEL_DEVICE_ID. Fără el, trimite telefonul tău implicit.

Rămâne codul scris undeva în jurnale?

Pachetul nu scrie în jurnale nici codurile, nici cheile. Fiecare handler de webhook ține minte și ID-urile webhook-urilor recente (în instanța care rulează), așa că un webhook reîncercat nu trimite același cod de două ori.

Un cabinet stomatologic, un service auto sau un salon primesc multe cereri prin formularul de pe site: o programare, o cerere de ofertă, o întrebare despre preț. Pluginul de formulare trimite de obicei cererea pe email, iar emailul așteaptă până se uită cineva în căsuță. Între timp, clientul poate să fi sunat deja la altcineva.

Un SMS ajunge pe telefonul pe care îl ai oricum la tine. Iar omul care a completat formularul vrea să știe că cererea a ajuns: un mesaj scurt de confirmare, de pe un număr la care poate suna sau răspunde, îl liniștește mai bine decât o pagină de „Mulțumim” pe care o închide imediat.

SMSTunnel face amândouă lucrurile pentru cinci pluginuri de formulare: Contact Form 7, WPForms, Gravity Forms, Fluent Forms și Forminator. Site-ul tău îi predă fiecare mesaj contului tău SMSTunnel, iar aplicația SMSTunnel de pe telefonul tău Android îl trimite de pe numărul tău. Mai jos găsești pașii comuni, apoi setările fiecărui plugin. Pluginurile SMSTunnel sunt doar în engleză, așa că numele setărilor apar mai jos exact ca pe ecran; dacă WordPress-ul tău e în română, unele meniuri ale pluginurilor de formulare pot apărea traduse.

Două mesaje pentru fiecare formular

Fiecare integrare de mai jos are aceleași două mesaje, pe care le folosești separat sau împreună:

• Un mesaj pentru tine sau pentru echipă, când cineva trimite formularul. Poți trece mai multe numere, iar fiecare primește propriul mesaj. În text pui răspunsurile din formular: numele, telefonul, ce a scris omul.
• O confirmare pentru cel care a completat formularul, la numărul trecut chiar de el. Add-on-urile îi spun SMS (2) sau Autoresponder.

Mesajele pleacă după fiecare formular trimis cu succes. Dacă telefonul tău e offline o vreme, ele așteaptă și pleacă atunci când revine.

Întâi, leagă site-ul de telefon

Toate cele cinci au nevoie de pluginul de bază SMSTunnel, gratuit, legat de telefonul tău:

1. Instalează aplicația SMSTunnel din Google Play pe telefonul tău Android și autentifică-te.
2. În WordPress, mergi la Module → Adaugă modul, caută SMSTunnel, apoi Instalează acum și Activează.
3. Deschide SMSTunnel → Quick Setup. În aplicație intri la Conexiuni → Conectează cu cod QR, scanezi codul și aprobi conexiunea pe telefon.

Merge și cu o cheie API, la SMSTunnel → Settings → Connect with API Key, ca în videoclipul de mai sus. Înainte să treci mai departe, trimite-ți un mesaj de test din SMSTunnel → Send SMS: dacă ajunge, restul ține doar de setările formularului. Despre pluginul de bază, inclusiv codurile de autentificare prin SMS la autentificarea în WordPress, afli mai multe pe pagina pluginului.

Contact Form 7

Instalează SMSTunnel for CF7 din Module → Adaugă modul. Apoi mergi la Contact → Contact Forms, editezi formularul și deschizi tab-ul SMS (îl văd doar administratorii).

• Bifezi Send SMS notification when this form is submitted, treci numărul tău (sau mai multe, separate prin virgulă) la Recipient Phone Number(s) și scrii mesajul la Message Body.
• Pentru confirmare bifezi Use SMS (2). La Recipient Phone Number e trecut implicit [your-phone], adică telefonul completat de vizitator; schimbă eticheta dacă la tine câmpul are alt nume.

În mesaj poți folosi orice câmp al formularului, ca [your-name] sau [your-message], plus [_date], [_time], [_site_title], [_site_url], [_post_title] și [_post_url]. Alte etichete speciale nu sunt înlocuite. Un exemplu pentru un cabinet: primul mesaj e pentru tine, al doilea e confirmarea pentru pacient.

Programare nouă de la [your-name]: [your-message]. Telefon: [your-phone]

Bună, [your-name]! Am primit cererea ta de programare și te sunăm în cel mult o zi lucrătoare.

Toate detaliile sunt pe pagina Contact Form 7 (în engleză).

WPForms

Instalezi SMSTunnel for WPForms. E făcut pentru WPForms Lite, varianta gratuită, deci nu ai nevoie de WPForms Pro. Deschizi formularul în editorul WPForms și mergi la Settings → SMS.

• Pornești Enable SMS notification when form is submitted, treci numerele la Recipient Phone Number(s) și modifici Message Body. Implicit, mesajul începe cu „New form submission from {field_id="1"}” și continuă cu toate răspunsurile, prin {all_fields}; îl poți rescrie în română.
• Pornești Enable SMS (2) Autoresponder, pui la Recipient Phone Number eticheta câmpului de telefon, de exemplu {field_id="3"}, și scrii Confirmation Message.

Pe lângă {field_id="X"} și {all_fields} merg {site_name}, {site_url}, {admin_email}, {user_ip}, {entry_id} și {date format="d.m.Y"}. Câteva etichete WPForms, ca {form_name} și {page_title}, nu sunt înlocuite. Detalii pe pagina WPForms.

Gravity Forms

Instalezi SMSTunnel Notifications for Gravity Forms, editezi formularul și deschizi Settings → SMS. Fiecare formular are propriile setări:

• Enable trimite un mesaj la fiecare formular completat, către Recipient Phone Number(s). Acolo merge și o etichetă de câmp, ca {Phone:5}.
• Message Body pornește cu „New form submission:” urmat de {all_fields}. Merge orice etichetă Gravity Forms, ca {Name (First):1.3} sau {entry_id}.
• SMS (2) - Autoresponder are propria bifă Enable, un singur Recipient Phone Number și un Confirmation Message.

La final apeși Save SMS Settings. Nu există logică condițională: mesajele pleacă după fiecare formular trimis. Mai multe pe pagina Gravity Forms.

Fluent Forms, inclus în SMSTunnel

Pentru Fluent Forms nu instalezi nimic în plus: din versiunea 1.0.13, pluginul de bază adaugă mesajele imediat ce Fluent Forms e activ, și merge cu varianta gratuită.

Deschizi formularul și mergi la Settings & Integrations → Configure Integrations → Add New Integration. Alegi SMSTunnel SMS (mesajul pentru tine) sau SMSTunnel SMS (2) Autoresponder (confirmarea). Îi dai un nume, treci numerele sau alegi câmpul de telefon din formular, de exemplu {inputs.phone}, scrii mesajul și apeși Save Feed.

În mesaj folosești etichetele din meniul de lângă el, ca {inputs.name}; {all_data} pune toate răspunsurile, câte unul pe rând, sub forma „Etichetă: valoare”. Fiecare mesaj are comutatorul Enable this text, iar din Fluent Forms → Integrations poți opri mesajele SMSTunnel pentru toate formularele. Detalii pe pagina Fluent Forms.

Forminator, inclus și el

Și Forminator merge doar cu pluginul de bază, inclusiv în varianta gratuită. Activezi SMSTunnel o singură dată la Forminator → Integrations: îl găsești la Available Apps, apeși + și Activate.

Apoi deschizi formularul, mergi la tab-ul Integrations și apeși + lângă SMSTunnel. Dai un nume mesajului, alegi la Who gets this text? între SMSTunnel SMS și SMSTunnel SMS (2) Autoresponder, apeși Next, treci numerele sau alegi câmpul de telefon, scrii mesajul și apeși Save. Un formular poate avea mai multe mesaje.

Mesajul folosește etichetele câmpurilor, ca {name-1} sau {textarea-1}, plus {all_fields}, {all_non_empty_fields}, {form_name} și {submission_id}. La câmpul Phone din formular, alege la Validation opțiunea International. Detalii pe pagina Forminator.

Numerele de telefon: cu +40 în față

Aici e capcana: oamenii scriu din obișnuință „0744 123 456”. Fiecare număr trebuie să aibă + și prefixul țării: „+40 744 123 456”. Cere asta clar în formular, în eticheta câmpului sau în textul ajutător, pentru că pluginurile nu adaugă prefixul în locul tău:

• Contact Form 7, WPForms și Gravity Forms acceptă spații, sar peste numerele locale care încep cu 0 și citesc un număr fără + ca și cum ar începe cu prefixul țării.
• Fluent Forms și Forminator sar peste numerele fără prefixul țării.
• Toate sar peste numerele cu suprataxă; Fluent Forms și Forminator sar și peste numerele scurte.

Mesajele mai lungi de 1.600 de caractere sunt tăiate, așa că {all_fields} dintr-un formular foarte lung s-ar putea să nu încapă.

Alte pluginuri de formulare

Add-on-urile SMSTunnel pentru Elementor Forms (widgetul Form din Elementor Pro), Ninja Forms și Formidable Forms urmează să apară pe WordPress.org; fiecare pagină îți spune cum le poți primi mai repede. Dacă ai un magazin, vezi și ghidul despre notificări SMS în WooCommerce.

Întrebări frecvente

Plătesc pentru fiecare mesaj?

Nu către SMSTunnel. Mesajele pleacă de pe SIM-ul tău, deci se aplică tarifele operatorului tău pentru SMS sau SMS-urile incluse în abonament. Planul Gratuit acoperă 25 de mesaje pe zi și 500 pe lună, trimise exact cum le-ai scris, iar planurile plătite încep de la 9 $ pe lună. Vezi prețurile.

Pot trimite un mesaj tuturor celor care au completat vreodată formularul?

Nu asta fac integrările. Fiecare formular trimis declanșează propriile mesaje: unul pentru tine sau pentru echipă și o confirmare pentru omul care tocmai l-a completat. Scrie doar oamenilor care așteaptă un mesaj de la tine.

Pot fi criptate mesajele?

Da, opțional. Pornești criptarea end-to-end în setările pluginului de bază, iar site-ul își criptează mesajele pentru telefonul tău înainte să plece din WordPress. Ce vede și ce nu vede SMSTunnel afli din ghidul despre SMS criptat end-to-end.

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:

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.

Ai Home Assistant la apartament sau la casa de la țară și notificările push merg bine, până în ziua în care contează. Telefonul din buzunar nu are date mobile, economisirea bateriei e pornită sau Android a oprit pe ascuns aplicația, iar alerta despre țeava spartă din baie nu mai apare. Un SMS nu are nevoie de nimic din toate astea: ajunge pe telefonul tău prin rețeaua mobilă, cu sau fără date.

Integrarea SMSTunnel îi dă lui Home Assistant serviciul notify.smstunnel. Automatizările tale predau fiecare alertă contului tău SMSTunnel, iar aplicația SMSTunnel de pe telefonul tău Android o trimite ca SMS obișnuit, de pe numărul tău, cu SIM-ul tău. Nu există un furnizor de SMS terț la mijloc, iar SMSTunnel nu ia bani pe mesaj: plătești doar ce-ți cere operatorul pentru SMS, după abonamentul pe care îl ai.

Mai jos ajungi de la zero la patru automatizări care merg — inundație, pană de curent, frig la casa de la țară și ușa de la intrare deschisă când nu e nimeni acasă — plus setările care împiedică un senzor capricios să-ți trimită mesaje toată noaptea.

Cum se leagă lucrurile

• Telefonul care trimite e un Android 7.0 sau mai nou, cu SIM și cu aplicația SMSTunnel, conectat prin Wi-Fi sau date mobile. Merge foarte bine un telefon vechi care stă acasă, la încărcat: alertele ajung apoi pe telefonul pe care îl porți la tine, ca SMS obișnuit.
• Home Assistant predă alerta contului tău SMSTunnel prin internet, iar aplicația de pe telefon o trimite.
• Destinatarii sunt numerele pe care le alegi tu: al tău, al partenerului, al vecinului care are cheie. Fiecare primește propriul mesaj.

O limită, spusă cinstit: și Home Assistant, și telefonul care trimite au nevoie de internet ca să predea alerta. Dacă vrei mesaje și când pică internetul sau curentul acasă, pune-le o rezervă: date mobile pe telefon și un UPS (sau un router cu date mobile) pentru Home Assistant și pentru router. La casa de vacanță, unde nu e nimeni să observe pana, rezerva asta face diferența.

Pasul 1: leagă telefonul și creează o cheie

1. Creează un cont pe dashboard.smstunnel.io sau intră cu Google ori Facebook.
2. Pe telefonul care va trimite, instalează aplicația SMSTunnel din Google Play, autentifică-te cu același cont și apasă Pornește serviciul. Telefonul apare în dashboard la Phones; îl poți lega și cu codul QR de la Phones → Add phone, pe care îl scanezi din aplicație, la Conexiuni → Conectează cu cod QR.
3. În dashboard deschizi Apps → Add an app, alegi Home Assistant și copiezi cheia. Se afișează o singură dată. Dacă ștergi aplicația mai târziu, Home Assistant nu mai poate trimite.

Trimite-ți un mesaj de probă din dashboard, cu Write a text. Dacă ajunge, partea de telefon e gata. Documentația explică permisiunile aplicației și serviciul în fundal.

Pasul 2: instalează integrarea

Varianta recomandată e HACS:

1. În HACS, deschide meniul cu trei puncte și alege Custom repositories.
2. Adaugă https://github.com/narcisbodea/hass-smstunnel, cu categoria Integration.
3. Instalează SMSTunnel și repornește Home Assistant.

Fără HACS, copiezi folderul custom_components/smstunnel din acel repository în folderul config/custom_components/ al lui Home Assistant și repornești.

Pasul 3: adaugă SMSTunnel în Home Assistant

Mergi la Settings → Devices & Services → Add Integration → SMSTunnel și completezi formularul:

Setările nu se pot modifica ulterior. Ca să schimbi ceva, ștergi integrarea și o adaugi din nou.

Ca test, deschide Developer tools, apelează notify.smstunnel cu un mesaj scurt și așteaptă SMS-ul pe telefon. De acum, orice automatizare sau script îl poate folosi.

Patru automatizări de copiat

Exemplele folosesc aceeași sintaxă ca README-ul integrării. Din Home Assistant 2024.8, editorul scrie apelul ca action: notify.smstunnel în loc de service: notify.smstunnel; e același serviciu. Înlocuiește ID-urile entităților cu ale tale.

Inundație în baie

Cazul clasic, în care fiecare minut costă:

automation:
  - alias: "SMS la inundație în baie"
    trigger:
      - platform: state
        entity_id: binary_sensor.inundatie_baie
        to: "on"
    action:
      - service: notify.smstunnel
        data:
          title: "Casa"
          message: "Apă pe jos în baie! Închide robinetul principal."

SMS-ul nu are un câmp separat pentru titlu, așa că mesajul ajunge ca „Casa: Apă pe jos în baie! Închide robinetul principal.”

Frig la casa de la țară

Iarna, la casa în care nu stă nimeni, un senzor de temperatură îți arată la timp că se răcește casa, înainte să înghețe țevile. Senzorul trebuie să arate sub 8 °C timp de 30 de minute, iar pauza de la final, împreună cu mode: single, înseamnă cel mult un mesaj la două ore:

automation:
  - alias: "SMS când se răcește casa de la țară"
    mode: single
    trigger:
      - platform: numeric_state
        entity_id: sensor.temperatura_living
        below: 8
        for: "00:30:00"
    action:
      - service: notify.smstunnel
        data:
          message: "Casa de la țară: doar {{ states('sensor.temperatura_living') }} °C în living. Verifică centrala!"
      - delay: "02:00:00"

Pană de curent

O integrare de UPS anunță când casa rămâne fără curent. Numele entității depinde de UPS-ul tău, iar linia for: așteaptă un minut, ca o întrerupere de o clipă să nu-ți trimită mesaj. Ține și routerul pe UPS, altfel alerta nu are pe unde să plece.

automation:
  - alias: "SMS la pană de curent"
    trigger:
      - platform: state
        entity_id: binary_sensor.ups_pe_baterie
        to: "on"
        for: "00:01:00"
    action:
      - service: notify.smstunnel
        data:
          message: "Pană de curent acasă: UPS-ul merge pe baterie."

Ușa de la intrare, când nu e nimeni acasă

Acest mesaj merge la două numere, nu la destinatarii salvați: target primește un număr sau o listă și îi înlocuiește pe cei salvați doar pentru acest apel. Condiția folosește zona „home”, a cărei stare e numărul de persoane aflate acasă.

automation:
  - alias: "SMS când se deschide ușa și nu e nimeni acasă"
    trigger:
      - platform: state
        entity_id: binary_sensor.usa_intrare
        to: "on"
    condition:
      - condition: state
        entity_id: zone.home
        state: "0"
    action:
      - service: notify.smstunnel
        data:
          message: "S-a deschis ușa de la intrare și nu e nimeni acasă."
          target:
            - "+40712345678"
            - "+40787654321"

Pentru un singur apel poți alege și alt telefon sau alt prefix, în câmpul data al serviciului:

service: notify.smstunnel
data:
  message: "Test de pe telefonul din garaj"
  data:
    device_id: "id-ul-telefonului"
    default_country_code: "+40"

Un senzor capricios nu trebuie să-ți scrie toată noaptea

Un senzor care sare între „on” și „off” poate porni o automatizare de zeci de ori în câteva minute, iar fiecare rulare înseamnă un SMS. Așa îți termini repede mesajele din plan și îți pui la încercare și relația cu operatorul. Trei obiceiuri te scapă:

• Adaugă for: la declanșator, ca starea să se mențină o vreme înainte să plece ceva.
• Adaugă o condiție, ca alerta să treacă doar când contează, ca verificarea casei goale de mai sus.
• Pune o pauză cu mode: single și un delay la final, ca în exemplul cu casa de la țară.

Cifrele de reținut: planul Gratuit trimite 25 de mesaje pe zi și 500 pe lună exact cum le-ai scris, iar încă până la 25 pe zi se încheie cu un scurt rând „free by smstunnel.io”. Planurile plătite încep de la 9 $ pe lună, fără taxe, cu limite zilnice mai mari; vezi prețurile. În toate planurile, SMSTunnel acceptă 30 de cereri de trimitere pe minut.

Când ceva nu merge

Integrarea e făcută astfel încât o problemă să nu le ascundă pe celelalte:

• Erorile ajung în jurnalul lui Home Assistant, nu în automatizare, așa că restul automatizării rulează mai departe.
• Un destinatar la care trimiterea eșuează nu-i blochează pe ceilalți: celelalte mesaje pleacă.
• Peste 30 de cereri pe minut, mesajul nu se trimite, iar jurnalul o spune clar. Nu există reîncercare automată.
• Mesajele mai lungi de 1600 de caractere sunt tăiate înainte de trimitere, nu respinse.
• Dacă telefonul care trimite e offline, mesajul așteaptă în contul tău și pleacă atunci când telefonul revine.

Dacă ștergi integrarea, notify.smstunnel se oprește imediat, fără repornire, iar dacă ștergi aplicația ei din dashboard, cheia nu mai funcționează.

Întrebări frecvente

De pe ce număr vin alertele?

De pe SIM-ul telefonului pe care rulează aplicația SMSTunnel. Salvează-l în agendă ca „Casa” și îl recunoști dintr-o privire.

Pot răspunde cei care primesc alerta?

Da. Răspunsurile ajung pe telefonul care a trimis, ca orice SMS, iar cu sincronizarea pornită în aplicație (Sincronizează mesajele primite) le vezi și în dashboard. Integrarea doar trimite.

Trebuie ca Home Assistant să fie accesibil din internet?

Integrarea apelează SMSTunnel dinspre Home Assistant, deci Home Assistant are nevoie doar de acces la internet. Nu trebuie să accepte conexiuni din afară.

Există și alte variante în afară de Home Assistant?

Pentru servere și unelte de monitorizare, ghidul despre alerte de monitorizare prin SMS acoperă Uptime Kuma, Grafana și Zabbix. Pentru alte fluxuri, n8n funcționează la fel. Tot ce ține de integrare e pe pagina integrării Home Assistant.

Din 7 ianuarie 2019, Google Calendar nu mai trimite notificări prin SMS. De atunci, mementourile lui vin doar ca notificări în aplicație și pe e-mail. Pentru un cabinet stomatologic, un salon sau un service, asta contează: pacientul sau clientul nu folosește calendarul tău, așa că singurul memento pe care îl vede e cel pe care i-l trimiți tu.

SMSTunnel aduce înapoi mementourile prin SMS și adaugă mesaje trimise direct din foile de calcul. Niște șabloane Google Apps Script gratuite îi predau fiecare mesaj contului tău SMSTunnel, iar telefonul tău Android îl trimite de pe numărul tău. Oamenii văd un număr pe care îl cunosc și îți pot răspunde. Nu ai niciun server de întreținut: totul rulează în Apps Script, în propria ta foaie de calcul.

Ce poți trimite din Google

Sunt patru șabloane gata făcute, plus o mică bibliotecă pentru propriul tău cod:

Fiecare șablon trimite un singur mesaj pe număr, doar la numerele pentru care l-ai configurat, cu o limită pe rulare și niciodată de două ori același mesaj. Nu există un buton care să trimită mesaje tuturor celor din foaie, și asta e intenționat.

De ce ai nevoie

• Un telefon Android cu aplicația SMSTunnel din Google Play, autentificată în contul tău. Videoclipul de mai sus arată pașii.
• Un cont Google, personal sau Google Workspace. Apps Script e gratuit cu oricare dintre ele.
• O cheie SMSTunnel. În dashboard deschizi Apps → Add an app, alegi Script or server, îi dai un nume (de exemplu „Programări cabinet”) și apeși Create the key. Copiaz-o imediat, pentru că e afișată o singură dată. Fă câte o cheie pentru fiecare foaie de calcul, ca să poți opri una fără să le atingi pe celelalte.

Pasul 1: adaugi șablonul în foaia de calcul

Copiile gata făcute, cu un singur clic (Make a copy), vin în curând. Până atunci, copiezi codul din depozitul smstunnel-google de pe GitHub, în câteva minute. Meniurile Google apar mai jos cu numele din interfața în engleză; în interfața în română le găsești în aceleași locuri.

1. Deschide foaia de calcul: cea cu datele tale pentru Google Sheets sau una nouă pentru Google Calendar (ea ține jurnalul și, dacă vrei, numerele invitaților). Apoi alege Extensions → Apps Script.
2. Pe GitHub, deschide dosarul șablonului: apps-script/calendar-reminders, apps-script/sheets-status-texts sau apps-script/sheets-reminders. Creează în editor aceleași fișiere și lipește conținutul fiecăruia: SmsTunnel, SmsTunnelKit și Code ca fișiere script (+ → Script), iar Setup ca fișier HTML (+ → HTML).
3. Deschide Project Settings (rotița), bifează Show “appsscript.json” manifest file in editor, deschide appsscript.json și înlocuiește-l cu cel din șablon.
4. Salvează, întoarce-te în foaia de calcul și reîncarc-o. După câteva secunde apare meniul SMSTunnel.

Pasul 2: configurezi și trimiți un mesaj de test

Alege SMSTunnel → Set up. Prima dată, Google îți cere permisiunea și, pentru că e copia ta a unui script pe care Google nu l-a verificat, afișează „Google hasn’t verified this app”. E normal pentru un script al tău: apasă Advanced → Go to … (unsafe). Bifează toate permisiunile: scriptul vorbește doar cu smstunnel.io, lucrează doar în această foaie de calcul, îți citește calendarele fără să le modifice și rulează declanșatoarele cât timp nu ești la calculator.

Apoi lipești cheia, apeși Check, alegi telefonul care trimite mesajele, completezi restul și apeși Save and turn on. La final îți trimiți un mesaj de test: SMSTunnel → Send a test text sau, în șablonul pentru Calendar, Send me a test reminder.

Exemplu: mementouri pentru pacienții unui cabinet stomatologic

Șablonul pentru Google Calendar are trei părți, iar tu le pornești doar pe cele de care ai nevoie. Pentru pacienți, partea care contează e mementoul către oamenii din programări.

Numărul pacientului vine dintr-un rând din descrierea evenimentului care începe cu un cuvânt ales de tine și două puncte. Cuvântul poate fi în orice limbă, așa că în Set up poți alege „Telefon” și scrii în descriere:

Telefon: 0722 123 456

Un număr fără prefixul țării, ca acesta, are nevoie de prefixul +40, pe care îl completezi în Set up → More settings; fără el, numărul e sărit, ca să nu plece niciun mesaj într-o altă țară. Alte numere din descriere, cum ar fi cel de dial-in al unei întâlniri video, nu sunt folosite niciodată.

Textul îl scrii tu, cu câmpurile {Title}, {Date}, {Time} și {Location}:

Bună ziua! Vă reamintim programarea la cabinet: {Date}, ora {Time}. Dacă trebuie să o mutați, răspundeți la acest mesaj.

Tot în More settings alegi cum arată data și ora în mesaj; un format numeric, cu ora pe 24 de ore, se citește cel mai firesc în română. Câmpul {In} se completează în engleză („in 15 min”), așa că într-un mesaj în română e mai bine să-l lași deoparte.

Câteva reguli te protejează de surprize. Implicit, contează doar evenimentele create de tine, ca o invitație de la altcineva să nu poată alege cine primește un mesaj de pe telefonul tău. Mementourile către oameni pleacă doar între orele alese (implicit 8:00–21:00), la cel mult 10 persoane pe eveniment. Fiecare memento pleacă o singură dată, iar dacă muți programarea, noua oră primește un singur mesaj nou.

Celelalte două părți sunt pentru tine: un memento cu 10 minute până la o zi înainte de fiecare eveniment, la cel mult 5 numere ale tale, și agenda zilei, un singur mesaj în fiecare dimineață, la ora aleasă.

Exemplu: un atelier de reparații anunță că aparatul e gata

Un service de telefoane ține comenzile într-o foaie Google Sheets cu coloanele Nume, Telefon, Comanda și Stare. Cu șablonul pentru mesaje de stare alegi foaia, coloana de stare, valoarea care trimite mesajul (de exemplu „Gata”) și coloana cu telefonul. În text, numele coloanelor devin câmpuri:

Bună, {Nume}! Comanda {Comanda} e gata și te așteaptă la atelier, de luni până vineri, între 9 și 18.

Când cineva trece starea unui rând pe „Gata”, numărul de pe acel rând primește mesajul, iar coloana Texted at, adăugată de șablon, arată când. Un rând nu primește niciodată mesajul de două ori, iar rândurile care aveau deja valoarea la configurare sunt sărite. Dacă lipești valoarea pe multe rânduri, pleacă cel mult 20 de mesaje deodată (poți ridica limita la 50), iar restul așteaptă. Dacă foaia e completată de o altă aplicație, bifează Also check every 15 minutes, pentru că modificările făcute de alte aplicații nu pornesc declanșatorul de editare al Google.

Exemplu: mementouri dintr-o foaie cu programări

Pentru un salon care ține programările într-o foaie cu Nume, Telefon, Data și Ora, șablonul de mementouri alege singur rândurile. Datele pot fi date reale sau text precum 2026-11-02 14:30 și se citesc în fusul orar al foii (File → Settings). Și aici, câmpurile sunt numele coloanelor:

Bună ziua, {Nume}! Vă așteptăm la salon pe {Data}, la ora {Ora}. Dacă nu puteți ajunge, răspundeți la acest mesaj.

Din oră în oră, fiecare programare din următoarele 24 de ore (sau câte ore alegi) primește un memento, între orele alese (implicit 8:00–21:00), cel mult 25 pe rulare. Coloana Reminder sent îl înregistrează, iar un rând fără un număr valid e marcat Not sent, cu motivul. Preview the next reminders îți arată ce ar pleca, fără să trimită nimic.

Limite și bune practici

• Numerele se scriu în format internațional, de exemplu +40722123456. Format → Number → Plain text păstrează semnul + în celulă.
• SMSTunnel acceptă 30 de cereri de trimitere pe minut și până la 1600 de caractere pe mesaj, iar limita zilnică a planului tău se aplică. Șabloanele fac o pauză de 2 secunde între mesaje și au o limită pe rulare.
• Limitele Google: un cont Google gratuit are 20.000 de apeluri URL Fetch pe zi (unul pe mesaj) și 90 de minute pe zi pentru declanșatoare; conturile Workspace au mai mult.
• Dacă telefonul e offline, mesajul așteaptă în contul tău și pleacă imediat ce telefonul revine online.
• Cheia stă în proprietățile de utilizator ale scriptului (user properties), niciodată într-o celulă sau în jurnal. Oricine poate edita foaia îi poate edita și scriptul, așa că dă drept de editare doar oamenilor în care ai încredere. Dacă ștergi cheia din Apps, în dashboard, se opresc toate mesajele.
• Doar mesaje așteptate: trimite mementouri doar celor care ți-au dat numărul pentru asta și respectă regulile locale; în UE, asta include GDPR și regulile ePrivacy pentru comunicațiile electronice.

Întrebări frecvente

Cât costă?

Șabloanele sunt gratuite, la fel și Apps Script. Mesajele intră în planul tău SMSTunnel, iar pentru SMS-urile trimise de telefon se aplică abonamentul tău de la operator. Planul Gratuit include 25 de mesaje pe zi și 500 pe lună, trimise exact cum le-ai scris; Starter, la 9 $ pe lună, permite 300 de mesaje pe zi, pentru o agendă plină.

Ce număr văd pacienții și clienții?

Numărul tău. Mesajele pleacă de pe telefonul tău, de pe SIM-ul lui, ca un mesaj scris de tine, iar răspunsurile vin tot pe telefonul tău.

Calendarul meu e în Outlook. Ce fac?

Vezi mementourile prin SMS pentru Outlook Calendar, făcute cu n8n, Power Automate, Zapier sau Make.

Poate trimite mementourile un asistent AI?

Da, când îi ceri: cu serverul MCP SMSTunnel și un conector pentru calendar, un asistent precum Claude le poate scrie pacienților de mâine după ce îți arată lista. Nu rulează însă după un program, așa că pentru mementouri care pleacă singure, folosește șablonul pentru Calendar.

Când pică site-ul magazinului sau se umple discul unui server, alerta contează doar dacă ajunge la cineva. Un SMS ajunge și atunci când un e-mail sau o notificare push se pierd, iar omul de gardă îl primește de la un număr pe care îl cunoaște și pe care îl poate suna înapoi.

Cu SMSTunnel, uneltele tale de monitorizare îi predau fiecare alertă contului tău SMSTunnel, iar telefonul tău Android o trimite de pe SIM-ul lui. Nu montezi niciun modem GSM pe server și nu ai un furnizor de SMS la mijloc: fiecare alertă e un SMS obișnuit din abonamentul tău de la operator. Mai jos configurăm patru unelte des folosite, Uptime Kuma, Grafana, Zabbix și GitHub Actions, plus o adresă de webhook pentru restul.

Înainte de toate: câte o cheie pentru fiecare unealtă

Instalează aplicația SMSTunnel din Google Play pe un telefon Android și autentifică-te; videoclipul de mai sus arată pașii. Apoi, în dashboard, deschide Apps → Add an app, alege Script or server, dă-i numele uneltei (de exemplu „Uptime Kuma”) și apasă Create the key. Copiază cheia imediat, pentru că e afișată o singură dată.

Fă câte o aplicație pentru fiecare unealtă. Dacă o cheie scapă din setările uneia, ștergi doar aplicația ei, iar celelalte trimit mai departe.

Toate cele patru unelte fac, de fapt, același apel: o cerere POST către endpoint-ul de trimitere, cu cheia în antetul X-API-Key și câte un singur număr pe cerere:

curl -X POST https://smstunnel.io/api/v1/sms/send \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"to": "+40712345678", "message": "Serverul web-01 nu răspunde"}'

Numerele se scriu în format internațional, cu +40 pentru România. Pentru doi oameni faci două cereri: fiecare primește propriul mesaj.

Uptime Kuma: notificarea Webhook, fără plugin

Uptime Kuma nu are nevoie de niciun plugin. Deschide Settings → Notifications → Set Up Notification, alege tipul Webhook, dă-i un nume ca „SMS către mine” și completează:

• Post URL: https://smstunnel.io/api/v1/sms/send, cu HTTP Method POST, dacă versiunea ta afișează câmpul;
• Request Body: Custom Body, cu numărul tău în to;
• Additional Headers: pornit, cu cheia ta.

{"to": "+40712345678", "message": {{ msg | json }}}

{"Content-Type": "application/json", "X-API-Key": "sk_live_..."}

Lasă {{ msg | json }} exact așa: pune textul alertei din Uptime Kuma în mesaj, cu ghilimelele de care are nevoie JSON-ul. Apasă Test, iar telefonul îți trimite <Friendly Name> Testing; o cheie greșită apare ca eroare 401, „Invalid or expired API key”. Apasă Save, apoi bifează notificarea în lista Notifications a fiecărui monitor sau folosește Default enabled și Apply on all existing monitors. Pentru mai mulți colegi, adaugi câte o notificare Webhook pentru fiecare număr.

Mesajele arată așa:

[My shop] [🔴 Down] timeout of 48000ms exceeded
[My shop] [✅ Up] 200 - OK

Un monitor care tot cade și revine trimite un mesaj de fiecare dată, așa că completează Retries, ca o scurtă întrerupere să nu fie raportată drept cădere.

Nu vrei nicio cheie în Uptime Kuma? Merge și cu o adresă de webhook: în dashboard deschide Aplicații → Webhook-uri → Webhook nou (în engleză: Apps → Webhooks → New webhook) și alege Uptime Kuma, care pune ca text al mesajului {{msg}}. Apoi pune adresa la Post URL, cu Request Body pe Preset - application/json și fără antete; o singură notificare trimite mesajul la toate numerele webhook-ului, până la 10. Ghidul pentru Uptime Kuma arată ambele variante.

Grafana: un contact point de tip webhook

În Grafana 12 sau mai nou, deschide Alerts & IRM → Alerting → Notification configuration → Contact points, apasă + Add contact point și alege integrarea Webhook. Pune la URL https://smstunnel.io/api/v1/sms/send. La Optional Webhook settings, alege HTTP Method POST și adaugă la Extra Headers o intrare numită X-API-Key, cu cheia ta ca valoare. Apoi lipește asta la Custom Payload → Payload Template:

{{ coll.Dict
  "to" "+40712345678"
  "message" (printf "%s %s" (tmpl.Exec "default.title" .) (index .Alerts 0).Annotations.summary)
  | data.ToJSON }}

coll.Dict … | data.ToJSON scrie JSON-ul în locul tău, așa că ghilimelele sau semnele „:” dintr-o alertă nu-l pot strica. Lasă goale câmpurile Authorization și Basic Authentication, apasă Test, apoi Save contact point și alege-l într-o regulă de alertă sau în Notification policies. Un mesaj arată ca [FIRING:1] DiskFull nas1 Disk 95% full: /volume1, iar când alerta trece, apare din nou, cu [RESOLVED].

Două lucruri bune de știut. O alertă activă trimite din nou mesaj la fiecare repeat interval (implicit 4 ore) și încă o dată când se rezolvă, dacă nu bifezi Disable resolved message. Iar Grafana nu ascunde Extra Headers: oricine poate edita contact point-ul vede cheia, încă un motiv să-i dai Grafanei aplicația ei.

Și mai simplu, pe orice versiune de Grafana și pe Grafana Cloud: pune o adresă de webhook la URL-ul contact point-ului și lasă restul cum e, fără cheie și fără șablon de payload (vezi secțiunea despre webhook, mai jos). SMSTunnel citește direct JSON-ul alertelor din Grafana și trimite la numerele webhook-ului [FIRING] DiskFull - Disk 95% full: /volume1.

Zabbix: un tip de media în locul modemului GSM

SMS-ul inclus în Zabbix are nevoie de un modem GSM legat la un port serial al serverului. Tipul de media SMSTunnel are nevoie doar de HTTPS, așa că merge la fel pe un server fizic, într-o mașină virtuală, în Docker sau în cloud, pentru Zabbix 6.0 LTS, 7.0 LTS și versiunile mai noi. În Zabbix 6.0, unele meniuri sunt în altă parte: le găsești între paranteze.

1. Descarcă media_smstunnel.yaml, sau media_smstunnel_6.0.yaml pentru Zabbix 6.0, și importă-l din Alerts → Media types → Import (6.0: Administration → Media types → Import).
2. În Administration → Macros (6.0: Administration → General → Macros), adaugă {$SMSTUNNEL.API.KEY} cu cheia ta și alege tipul Secret text, ca să fie ascunsă în interfață și lăsată afară din exporturi.
3. Apasă Test pe rândul SMSTunnel și pune numărul tău în send_to. Fereastra de test nu completează macro-urile, așa că lipești cheia în api_key doar pentru acest test.
4. Dă-i fiecărui utilizator propriul număr: în Users → Users (6.0: Administration → Users) deschizi utilizatorul, apoi Media → Add, tipul SMSTunnel, cu numărul la Send to, în format internațional.
5. În Alerts → Actions → Trigger actions (6.0: Configuration → Actions → Trigger actions), adaugă o operație care trimite către utilizatori sau grupuri de utilizatori, cu Send only to: SMSTunnel.

Tipul de media vine cu șabloane de mesaje scrise pentru ecranul unui telefon și taie textele la 320 de caractere. Șabloanele sunt în engleză, dar le poți rescrie în română din tab-ul Message templates al tipului de media; notează-ți textele înainte să imporți o versiune nouă, pentru că importul le înlocuiește:

PROBLEM: High CPU utilization (over 90% for 5m)
Host: web-01
Severity: High
Data: Current utilization: 97.3 %
Started: 2026.11.01 10:00:00
ID: 123456

Un moment aglomerat sau o scurtă întrerupere se reîncearcă vreo două minute (5 încercări, la 30 de secunde una de alta). Alertele le trimite doar serverul Zabbix, nu un proxy Zabbix, așa că el trebuie să ajungă la smstunnel.io pe portul 443.

GitHub Actions: un mesaj când publicarea eșuează

Salvează cheia ca secretul de depozit SMSTUNNEL_API_KEY (Settings → Secrets and variables → Actions). Într-un depozit public, salvează și numărul ca secret, de exemplu ALERT_PHONE, pentru că fișierele fluxurilor de lucru și jurnalele lor sunt publice. Apoi adaugă un pas care rulează doar când jobul eșuează:

- name: Trimite-mi un SMS dacă a eșuat
  if: failure()
  uses: narcisbodea/smstunnel-action@v1
  with:
    api-key: ${{ secrets.SMSTUNNEL_API_KEY }}
    to: ${{ secrets.ALERT_PHONE }}
    message: "Publicarea ${{ github.repository }} a eșuat la ${{ github.sha }}: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"

Mai multe numere în to, despărțite prin virgule sau rânduri noi, primesc câte un mesaj fiecare (cel mult 30). GitHub nu dă secrete fluxurilor care rulează pentru pull request-uri din fork-uri sau pentru Dependabot, așa că sari peste pas în cazurile acelea și nu trece la pull_request_target ca să ocolești regula. Dacă un mesaj eșuat nu trebuie să oprească publicarea, adaugă continue-on-error: true. Ghidul pentru GitHub Actions are și exemple pentru lansări și joburi de noapte.

Restul uneltelor: o adresă de webhook

Unele unelte nu pot pune un antet sau propriul corp JSON. Pentru ele, SMSTunnel are webhook-uri: o adresă secretă care trimite mesaj la numerele salvate odată cu ea (de la 1 la 10, câte un mesaj fiecăruia). Apelul stabilește doar textul, niciodată numărul, așa că nu are nevoie de cheie, iar o adresă scăpată nu poate trimite mesaje altor numere.

O faci în dashboard: deschide Aplicații → Webhook-uri → Webhook nou (în engleză: Apps → Webhooks → New webhook), alege unealta care îl va apela (Grafana, Uptime Kuma, Healthchecks, Gatus, Alertmanager, Odoo Online sau Altceva), adaugă numerele, apasă Creează webhook-ul și copiază adresa. Dashboard-ul îți arată apoi pașii pentru unealta aleasă, cu adresa deja completată, și un buton care trimite o probă. Poți copia adresa din nou oricând, iar dacă ajunge unde nu trebuie, Adresă nouă o înlocuiește.

Merge un GET cu ?message= sau un POST cu un câmp message; textele sunt tăiate la 480 de caractere. Fiecare webhook primește implicit 20 de apeluri pe oră (până la 500), iar limita numără apelurile, nu mesajele: fiecare apel trimite mesajul la toate numerele webhook-ului. Alertele din Prometheus Alertmanager și Grafana sunt citite fără niciun șablon; pentru Uptime Kuma, când îl alegi, textul devine {{msg}}, ca numele monitorului să nu apară de două ori. De exemplu, un rând de crontab:

0 3 * * * /opt/backup.sh || curl -s -X POST https://smstunnel.io/api/v1/webhook/<token> -H 'Content-Type: application/json' -d '{"message":"Copia de siguranță de azi-noapte a eșuat"}'

Scripturile pot face webhook-uri și prin API; ghidul despre webhook-uri arată cum. Există ghiduri gata făcute pentru Prometheus Alertmanager, Healthchecks.io, Gatus și Odoo Online, iar cu o cheie, pentru Proxmox și Synology.

Limite bune de știut

• 30 de cereri de trimitere pe minut. Peste ele, SMSTunnel răspunde cu 429, iar fiecare unealtă notează eroarea sau reîncearcă. Grupează alertele, ca o avalanșă să devină un singur mesaj.
• Lungimea. Un mesaj poate avea până la 1600 de caractere. Un emoji face ca un SMS să cuprindă 70 de caractere în loc de 160, iar Uptime Kuma pune câte unul în fiecare alertă, așa că o alertă mai lungă pleacă în mai multe părți unite.
• Telefonul trebuie să fie pornit și online. Dacă nu e, mesajul așteaptă în contul tău și pleacă atunci când telefonul revine, timp de până la 3 zile. Dacă o alertă nu are voie să depindă de un telefon pornit și online, pentru ea se potrivește mai bine un furnizor de API SMS.
• Planurile. Planul Gratuit include 25 de mesaje pe zi și 500 pe lună, trimise exact cum le-ai scris, plus până la 25 în plus pe zi, care se încheie cu un scurt rând „free by smstunnel.io”. Starter (9 $ pe lună, fără taxe) permite 300 pe zi, Standard (19 $) 2.000, iar Profesional (39 $) nu are limită zilnică.

Întrebări frecvente

Am nevoie de un modem GSM sau de un furnizor de SMS?

Nu. Mesajele pleacă de pe telefonul tău, din abonamentul pe care îl plătești deja, de la un număr pe care oamenii îl recunosc.

Pot primi mai mulți colegi aceeași alertă?

Da, fiecare propriul mesaj: câte o notificare în Uptime Kuma, o integrare în Grafana sau o intrare Media în Zabbix pentru fiecare număr, până la 30 de numere în to, în acțiunea pentru GitHub, ori o singură adresă de webhook cu până la 10 numere.

Unde țin cheia?

Acolo unde o pot citi doar administratorii: în macro-ul de tip Secret text din Zabbix, într-un secret de depozit GitHub, în setările de notificare din Uptime Kuma sau Grafana. Dacă ștergi aplicația uneltei din dashboard, unealta nu mai poate trimite nimic, din acel moment.

„Scrie-i Ioanei că întârzii zece minute.” Spusă lui Claude, fraza asta poate deveni un SMS adevărat, trimis de pe numărul tău. Serverul MCP SMSTunnel le dă aplicațiilor Claude Desktop, Claude Code, Cursor și VS Code câteva unelte noi: asistentul predă mesajul contului tău SMSTunnel, iar aplicația SMSTunnel de pe telefonul tău Android îl trimite de pe SIM-ul tău. Ioana vede un număr pe care îl cunoaște și îți poate răspunde direct.

Serverul e publicat: pachetul @narcisbodea/smstunnel-mcp pe npm, intrarea io.github.narcisbodea/smstunnel-mcp în MCP Registry și codul sursă pe GitHub, cu licența MIT. Pagina serverului MCP are aceeași configurare, pe scurt.

Mai jos îl configurezi în câteva minute și afli regulile cu care vine: aprobi fiecare mesaj, fiecare mesaj merge la o singură persoană, iar mesajele primite sunt tratate ca informații, niciodată ca instrucțiuni.

Ce poate face asistentul

MCP (Model Context Protocol) e un standard deschis prin care aplicațiile AI folosesc unelte externe. Serverul SMSTunnel adaugă șase:

Fiecare unealtă poartă adnotările MCP care arată dacă doar citește sau schimbă ceva, așa că aplicațiile AI care le folosesc te pot întreba înainte să plece vreun mesaj.

Pasul 1: telefonul și cheia

1. Instalează aplicația SMSTunnel din Google Play pe telefonul tău Android și autentifică-te. Pe computer, intră în dashboard cu același cont: telefonul apare la Phones.
2. În dashboard, deschide Apps → Add an app și copiază cheia. Apare o singură dată și poate trimite mesaje și verifica dacă au plecat.
3. Opțional: ca asistentul să poată citi mesajele pe care le primești, bifează Can also read received texts când adaugi aplicația și pornește sincronizarea mesajelor primite în aplicația SMSTunnel. Sincronizarea e oprită implicit și preia doar mesajele care sosesc după ce o pornești.

Pasul 2: serverul în aplicația ta AI

Ai nevoie de Node.js 20 sau mai nou. Aplicația AI pornește singură serverul cu npx; nu trebuie să-l rulezi tu.

Claude Desktop și Cursor

În Claude Desktop, deschide Settings → Developer → Edit Config (fișierul claude_desktop_config.json), adaugă serverul, apoi închide și redeschide Claude. Cursor primește același bloc în ~/.cursor/mcp.json (pentru toate proiectele) sau în .cursor/mcp.json (pentru un singur proiect).

{
  "mcpServers": {
    "smstunnel": {
      "command": "npx",
      "args": ["-y", "@narcisbodea/smstunnel-mcp"],
      "env": {
        "SMSTUNNEL_API_KEY": "sk_live_cheia_ta",
        "SMSTUNNEL_DEFAULT_COUNTRY_CODE": "+40"
      }
    }
  }
}

Cu SMSTUNNEL_DEFAULT_COUNTRY_CODE setat la +40, poți scrie numerele și în forma obișnuită, de exemplu 0721 123 456: cele fără + sau 00 sunt completate cu prefixul României. Pe Windows, dacă aplicația nu poate porni npx, folosește "command": "cmd" și "args": ["/c", "npx", "-y", "@narcisbodea/smstunnel-mcp"].

Claude Code

claude mcp add --env SMSTUNNEL_API_KEY=sk_live_cheia_ta --transport stdio --scope user smstunnel -- npx -y @narcisbodea/smstunnel-mcp

Rulează /mcp în Claude Code ca să verifici că smstunnel e conectat.

VS Code

Cu fișierul .vscode/mcp.json de mai jos, VS Code îți cere cheia o singură dată și n-o scrie în fișier:

{
  "inputs": [
    { "type": "promptString", "id": "smstunnel-api-key", "description": "SMSTunnel API key", "password": true }
  ],
  "servers": {
    "smstunnel": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@narcisbodea/smstunnel-mcp"],
      "env": { "SMSTUNNEL_API_KEY": "${input:smstunnel-api-key}" }
    }
  }
}

Setările

Toate setările stau în env-ul serverului:

Pasul 3: încearcă

Începe cu propriul număr, apoi încearcă cereri ca acestea:

• „Trimite-i lui Andrei la +40721123456: coletul e la poarta din spate.”
• „Mesajul meu de adineauri a plecat?”
• „Care dintre telefoanele mele sunt conectate acum?”
• „Câte mesaje mai pot trimite azi?”
• „Mi-a răspuns cineva de azi-dimineață?” (dacă ai permis citirea mesajelor primite)

Înainte să trimită, asistentul îți arată numărul și textul exact și așteaptă să confirmi. După ce mesajul a fost predat contului tău, primește un ID și îți poate spune mai târziu dacă mesajul a plecat.

Mementouri din calendar, la cerere

Dacă ai un cabinet, un salon sau un service și îți ții programările în calendar, pune SMSTunnel lângă calendar în aceeași aplicație AI. În Claude, deschide Customize → Connectors și conectează Google Calendar sau Microsoft 365, pentru un calendar Outlook de pe un cont de serviciu sau de școală. Apoi cere:

„Uită-te în calendar la programările de mâine și trimite-i fiecărui client un memento cu ora. Arată-mi întâi lista.”

Asistentul citește evenimentele, găsește numărul fiecărui client și îți arată toată lista: persoana, numărul și textul exact. După ce confirmi, trimite câte un mesaj fiecărei persoane și nu retrimite niciodată din proprie inițiativă un mesaj eșuat. Scrie numărul clientului în eveniment, cu + și prefixul țării (de exemplu +40), ca asistentul să-l găsească. Unele evenimente pot veni din invitațiile altor oameni, așa că citește lista înainte s-o aprobi.

Asistentul lucrează doar când îi ceri; nu rulează după un program. Pentru mementouri care pleacă singure, folosește șablonul gratuit pentru Google Calendar (Google Calendar nu mai trimite notificări prin SMS din ianuarie 2019) sau ghidul pentru Outlook Calendar, cu n8n, Power Automate, Zapier sau Make.

Regulile serverului

Un asistent care poate trimite mesaje are nevoie de limite clare. Acestea fac parte din server, nu sunt doar sfaturi:

• Aprobi fiecare mesaj. Uneltele îi cer asistentului să-ți arate numărul și textul, sau toată lista când sunt mai multe persoane, și să aștepte confirmarea ta. Cu SMSTUNNEL_CONFIRM_EACH_TEXT lăsat pornit, Claude Code întreabă înainte de fiecare mesaj, chiar și în modurile în care altfel rulează uneltele singur.
• Un singur destinatar pe mesaj. Nu există o unealtă pentru mai multe numere deodată: asistentul trimite câte un mesaj fiecărei persoane, cel mult aproximativ 30 pe minut.
• Fără retrimiteri automate. Un mesaj eșuat sau neconfirmat poate să fi plecat totuși, așa că asistentul te întreabă în loc să-l trimită din nou.
• Mesajele primite sunt doar informații. Oricine îți poate scrie pe telefon, așa că asistentul tratează cuvintele lor ca date, niciodată ca instrucțiuni. Pornește citirea lor doar dacă ai nevoie de ea.
• Cheia rămâne în setările aplicației AI, niciodată într-o conversație, într-un depozit de cod sau într-o pagină web. Ștergi aplicația din Apps, în dashboard, și accesul se oprește.
• Doar mesaje pe care oamenii le așteaptă: răspunsuri, mementouri, alerte pentru tine, coduri de autentificare.

Încă un lucru bun de știut: mesajele trimise prin serverul MCP rămân pe pagina Messages din dashboard, ca mesajele din celelalte aplicații ale tale. Serverul nu le criptează end-to-end; dacă ai nevoie de asta pentru mesajele din software-ul tău, vezi cum funcționează criptarea end-to-end.

Și ChatGPT?

ChatGPT se conectează doar la servere MCP de pe internet, prin HTTPS, așa că nu poate porni acest server pe computerul tău. Folosește Claude Desktop, Claude Code, Cursor sau VS Code. Dacă vrei să scrii tu codul, aceleași operații sunt la un apel HTTPS distanță, în referința API.

Întrebări frecvente

Cât costă?

Serverul MCP e gratuit, cu cod sursă deschis. Mesajele intră în planul tău SMSTunnel, ca mesajele din orice altă aplicație a ta. Planul Gratuit include 25 de mesaje pe zi și 500 pe lună, trimise exact cum le-ai scris, plus până la 25 de mesaje în plus pe zi 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: vezi Prețuri. Pentru SMS-uri se aplică tarifele sau mesajele incluse în abonamentul tău de telefonie mobilă, pentru că trimite SIM-ul tău.

Poate asistentul să scrie mai multor oameni?

Da, câte unuia pe rând: îți arată întâi pe toți cei cărora le va scrie, iar după ce confirmi trimite câte un mesaj fiecărui număr. Nu există un apel care trimite același mesaj la mai multe numere deodată.

Ce telefon trimite mesajul?

Oricare dintre telefoanele legate de contul tău. Pune în SMSTUNNEL_DEVICE_ID ID-ul telefonului pe care îl vrei implicit sau cere-i asistentului să folosească un anumit telefon: îți poate lista telefoanele, cu ID-urile lor, și îl folosește pe cel pe care îl numești.

Pot să-l opresc?

Da, oricând. Ștergi aplicația din Apps, în dashboard, iar cheia ei nu mai poate trimite mesaje. Poți scoate și serverul din setările aplicației AI.