Laravel Sms Gateway: un SMS Gateway open-source și self-hosted pentru trimiterea mesajelor prin API

Ai nevoie să trimiti mesaje SMS din website fără abonamente și servicii externe?

Trimiterea de SMS-uri dintr-o aplicație web sau mobilă presupune, în mod obișnuit, integrarea unui serviciu SMS extern. Pentru multe proiecte acest lucru este soluția cea mai simplă, însă există situații în care ai nevoie de mai mult control asupra infrastructurii și asupra modului în care sunt trimise mesajele.

Pentru astfel de scenarii am creat SmsGateway, o soluție gratuită și open-source care permite aplicațiilor să trimită și să gestioneze SMS-uri printr-un API REST, folosind propriile dispozitive Android sau gateway-uri IoT.

Proiectul este disponibil ca software self-hosted, ceea ce înseamnă că îl poți instala pe propriul server și îl poți integra în infrastructura ta.

Ce este SmsGateway?

SmsGateway este un SMS Gateway software construit cu Laravel, destinat dezvoltatorilor, companiilor mici și mijlocii și proiectelor care au nevoie de funcționalități SMS programatice.

Aplicația oferă un API prin care un sistem extern poate:

• trimite SMS-uri;
• verifica statusul mesajelor;
• consulta istoricul SMS-urilor;
• gestiona conversațiile și răspunsurile;
• retransmite mesajele eșuate;
• înregistra și administra dispozitivele utilizate pentru trimiterea SMS-urilor.

Mesajele nu sunt trimise de un serviciu SMS extern. În schimb, gateway-ul transmite cererea către un dispozitiv compatibil, cum ar fi un telefon Android sau un dispozitiv IoT, care efectuează trimiterea prin rețeaua mobilă.

De ce un SMS Gateway self-hosted?

Un serviciu SMS extern poate fi foarte util, însă unele proiecte au nevoie de o arhitectură diferită.

Cu o soluție self-hosted ai posibilitatea să controlezi infrastructura, API-ul și dispozitivele care participă la procesul de trimitere.

LaravelSmsGateway poate fi o alternativă interesantă pentru proiecte în care:

• ai deja un telefon Android cu SIM;
• ai un gateway IoT cu conectivitate mobilă;
• vrei să integrezi SMS-ul direct într-o aplicație proprie;
• vrei să eviți integrarea unui furnizor SMS extern;
• ai nevoie de o soluție pe care să o poți instala pe propriul server.

Este important de menționat că LaravelSmsGateway nu elimină costurile operatorului de telefonie mobilă. Pentru trimiterea SMS-urilor este necesar un dispozitiv compatibil și un SIM, iar operatorul poate percepe tarife pentru mesajele trimise.

Cum funcționează?

Arhitectura proiectului este bazată pe comunicarea dintre aplicația care dorește să trimită SMS-ul, serverul SmsGateway și dispozitivul care va transmite efectiv mesajul.

Fluxul este următorul:

Aplicație → REST API → Queue → WebSocket → Android / IoT Device → SMS → Status API

Atunci când clientul face o cerere către endpoint-ul de trimitere SMS, gateway-ul creează o înregistrare pentru mesaj și îl pune în coadă.

Worker-ul preia mesajul și transmite o cerere către dispozitiv prin Laravel Reverb/WebSocket. Dispozitivul trimite SMS-ul și raportează rezultatul către API.

Dacă dispozitivul nu răspunde, sistemul poate efectua încercări suplimentare cu backoff progresiv.

Integrare cu Android și IoT

Unul dintre obiectivele proiectului este să permită utilizarea mai multor tipuri de dispozitive.

În configurația actuală sunt suportate tipurile de dispozitive Android și IoT, fiecare putând utiliza propriul canal de comunicare WebSocket.

Pentru Android există și un client dedicat, Sms Gateway Client - Android, care poate comunica cu gateway-ul.

Această arhitectură poate fi utilă, de exemplu, atunci când o aplicație web trebuie să trimită SMS printr-un telefon aflat într-o anumită locație sau printr-un gateway IoT.

API REST pentru aplicațiile tale

SmsGateway este construit în jurul unui API REST, astfel încât funcționalitatea SMS poate fi integrată în aplicații existente.

Printre endpoint-urile disponibile se află funcții pentru autentificare, trimitere SMS, verificarea statusului, conversații, retry și gestionarea dispozitivelor.

Acest lucru permite integrarea gateway-ului cu:

• aplicații Laravel;
• aplicații PHP;
• aplicații mobile;
• sisteme IoT;
• aplicații interne pentru companii;
• sisteme de rezervări;
• sisteme de notificări;
• platforme care folosesc OTP sau coduri de verificare.

Funcționalități de securitate

SmsGateway include autentificare OAuth2 prin Laravel Passport și un sistem de roluri și permisiuni.

Sunt disponibile roluri precum:

• Admin – administrarea utilizatorilor și aprobarea accesului;
• Client – utilizarea API-ului pentru trimiterea SMS-urilor;
• AppClient – utilizat pentru clienții aplicațiilor/dispozitivelor.

Utilizatorii noi pot fi menținuți în așteptare până când un administrator îi aprobă.

Tehnologii utilizate

Proiectul este construit folosind tehnologii moderne din ecosistemul Laravel:

• PHP 8.4
• Laravel 13
• SQLite
• Laravel Passport
• Laravel Reverb
• Spatie Laravel Permission
• Dedoc Scramble pentru documentația OpenAPI.

Un avantaj al configurației implicite este că proiectul poate utiliza un singur fișier SQLite pentru sesiuni, queue și cache, fără ca Redis să fie obligatoriu.

Pentru ce poate fi folosit?

SmsGateway poate fi utilizat în numeroase scenarii în care o aplicație trebuie să comunice prin SMS.

Coduri OTP și verificare

Poți integra SMS-ul într-un sistem de autentificare sau verificare a utilizatorilor pentru transmiterea codurilor OTP.

Confirmări de rezervări

Un sistem de rezervări poate trimite automat confirmări sau notificări prin SMS și poate primi răspunsuri de la utilizator.

Notificări și remindere

Poate fi utilizat pentru notificări automate, remindere pentru programări sau alte mesaje generate de aplicație.

Proiecte IoT

Dispozitivele IoT pot utiliza gateway-ul pentru a integra comunicația SMS în propriile fluxuri de automatizare.

Gratuit și open-source

SmsGateway este distribuit sub licența MIT, ceea ce îl face potrivit pentru dezvoltatori și organizații care doresc să studieze, modifice și integreze software-ul în propriile proiecte, în condițiile licenței.

Fiind self-hosted, software-ul poate fi instalat pe propria infrastructură, fără a depinde de o platformă SaaS pentru funcționarea gateway-ului.

Este LaravelSmsGateway un SaaS?

Nu.

SmsGateway este mai corect descris ca o soluție software digitală, open-source și self-hosted.

Diferența este importantă: software-ul nu este oferit ca un serviciu cloud administrat de noi. Utilizatorul instalează și administrează aplicația pe propria infrastructură și utilizează propriile dispozitive pentru transmiterea SMS-urilor.

Concluzie

SmsGateway oferă o modalitate flexibilă de a adăuga funcționalități SMS propriilor aplicații fără integrarea directă a unui furnizor SMS extern.

Dacă ești dezvoltator și ai nevoie de un SMS API self-hosted, dacă ai un telefon Android pe care vrei să îl folosești ca gateway SMS sau dacă lucrezi la un proiect IoT, SmsGateway poate reprezenta o bază solidă pentru construirea propriei infrastructuri de mesagerie SMS.

Laravel Sms Gateway este disponibil gratuit și open-source.

Codul sursa este public pe GitHub Azelya