DEV Community

Cover image for Come inviare SMS e codici OTP in PHP tramite REST API in 3 minuti
TommyDev
TommyDev

Posted on Originally published at messagility.com

Come inviare SMS e codici OTP in PHP tramite REST API in 3 minuti

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:

  1. Usando l'SDK ufficiale tramite Composer (consigliato per progetti strutturati).
  2. Usando cURL nativo senza alcuna dipendenza esterna.

Prerequisiti

Per inviare SMS tramite API servono:

  • PHP 7.4 o superiore con estensione curl e json attive.
  • 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
Enter fullscreen mode Exit fullscreen mode

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();
}
Enter fullscreen mode Exit fullscreen mode

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;
}
Enter fullscreen mode Exit fullscreen mode

Best practice per l'invio di SMS in produzione

  1. Formato internazionale (E.164): Normalizza sempre i numeri salvati nel database aggiungendo il prefisso internazionale (es. +39 per l'Italia) e rimuovendo spazi o trattini prima di passare il numero all'API.
  2. 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.
  3. 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

Top comments (0)