Integrare l'invio di SMS transazionali, notifiche ordini o codici di verifica OTP all'interno di un'applicazione PHP, un gestionale o un e-commerce (come WooCommerce o PrestaShop) non richiede librerie pesanti né configurazioni complesse: basta una semplice chiamata HTTP POST verso un endpoint REST.
In questa guida vediamo due modi pratici per farlo in PHP:
- Usando l'SDK ufficiale tramite Composer (consigliato per progetti strutturati).
- Usando cURL nativo senza alcuna dipendenza esterna.
Prerequisiti
Per inviare SMS tramite API servono:
- PHP 7.4 o superiore con estensione
curlejsonattive. - Una API Key attiva su un gateway SMS.
Per gli esempi useremo le REST API di Messagility, un gateway italiano orientato agli sviluppatori con tariffe trasparenti a partire da 0,033 € per SMS, senza canoni mensili e con crediti senza scadenza (qui trovi il listino completo).
Metodo 1: Invio SMS con Composer (SDK Ufficiale)
Se utilizzi Composer nel tuo progetto (Laravel, Symfony, Yii2 o PHP moderno), puoi installare il client ufficiale pubblicato su Packagist:
composer require messagility/sms-client
Una volta installato, bastano poche righe per inviare un SMS o un codice OTP:
<?php
require 'vendor/autoload.php';
use Messagility\MessagilityClient;
$client = new MessagilityClient('LA_TUA_API_KEY');
try {
$response = $client->sendSms(
'+393331234567', // Destinatario in formato E.164
'Il tuo codice di verifica OTP è: 849201', // Testo del messaggio
'Messagility' // Mittente alfanumerico (Alias)
);
print_r($response);
} catch (RuntimeException $e) {
echo 'Errore invio SMS: ' . $e->getMessage();
}
Il codice sorgente del client è open source e disponibile su GitHub.
Metodo 2: Chiamata diretta con PHP cURL nativo
Se preferisci non installare pacchetti esterni, puoi effettuare direttamente la richiesta POST in JSON verso l'endpoint REST:
<?php
$apiKey = 'LA_TUA_API_KEY';
$endpoint = '[https://messagility.com/api/v1/sms/send](https://messagility.com/api/sms/send)';
$payload = [
'to' => '+393331234567',
'message' => 'Conferma ordine #1042: il tuo pacco è stato spedito.',
'sender' => 'MiaAzienda'
];
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
'Content-Type: application/json',
'Accept: application/json',
],
CURLOPT_POSTFIELDS => json_encode($payload),
CURLOPT_TIMEOUT => 15,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200 || $httpCode === 201) {
$data = json_decode($response, true);
echo "SMS inviato con successo! ID: " . ($data['id'] ?? 'OK');
} else {
echo "Errore HTTP $httpCode: " . $response;
}
Best practice per l'invio di SMS in produzione
-
Formato internazionale (E.164): Normalizza sempre i numeri salvati nel database aggiungendo il prefisso internazionale (es.
+39per l'Italia) e rimuovendo spazi o trattini prima di passare il numero all'API. - Mittente Alfanumerico (Alias): Per inviare SMS con il nome del tuo brand al posto del numero di telefono, ricorda che in Italia la normativa AGCOM richiede la registrazione preventiva dell'Alias associato alla Partita IVA dell'azienda.
-
Gestione dei Timeout: Imposta sempre un
CURLOPT_TIMEOUT(es. 10-15 secondi) per evitare che eventuali rallentamenti di rete blocchino il checkout o il login dell'utente.
Risorse utili
- Documentazione API completa: messagility.com/api-docs
- Tariffe e calcolatore costi SMS: messagility.com/prezzi
- Consulenza per integrazioni ad alti volumi: messagility.com/consulenza
Top comments (0)