--- title: "Inviare SMS con l’API OVHcloud in PHP" description: "Scopri come configurare un ambiente di sviluppo PHP e inviare il tuo primo SMS passo dopo passo utilizzando l’API RESTful OVHcloud" url: https://docs.ovhcloud.com/it/guides/web-cloud/messaging/sms/send-sms-api-php lang: it lastUpdated: 2020-06-25 --- # Inviare SMS con l’API OVHcloud in PHP ## Obiettivo Gli SMS sono ampiamente utilizzati per inviare informazioni pratiche, per seguire lo stato di un ordine o di un processo transazionale, essere avvisati di un evento insolito o come promemoria di appuntamenti. Questa guida espone in dettaglio il metodo di invio di un primo SMS con l'API OVHcloud RESTful in PHP. **Impara come inviare SMS con l’API OVHcloud RESTful in PHP** ## Prerequisiti - Disporre di un ambiente di sviluppo PHP - Disporre di un [account SMS OVHcloud](https://www.ovhcloud.com/it/sms/) con saldo SMS ## Procedura ### Passaggio 1: Recupero del Wrapper PHP per le OVHcloud API Collegati al progetto [https://github.com/ovh/php-ovh](https://github.com/ovh/php-ovh) Potrai integrare rapidamente il wrapper PHP grazie a Composer: [https://getcomposer.org/](https://getcomposer.org/) Segui le istruzioni su GitHub, crea il file composer.json, come indicato nel progetto: GitHub> Readme > Quickstart Potrai acquisire nel tuo progetto la directory ./vendor/ovh/ovh/ oltre che il file autoload.php che permette di gestire tutte le dependency e le importazioni. ![Il tuo progetto con Composer](/images/web-cloud/messaging/sms/send-sms-api-php/img_2450.jpg) ### Passaggio 2: Creazione degli identificativi Per utilizzare l’API SMS sono necessari degli identificativi. Questi identificativi vengono creati una volta per individuare l’applicazione che invierà gli SMS. La loro durata di vita è configurabile. Crea i tuoi identificativi di Script (tutte le chiavi in una volta) su questa pagina: [https://auth.eu.ovhcloud.com/api/createToken](https://auth.eu.ovhcloud.com/api/createToken?GET=/sms/\&GET=/sms/*/jobs\&POST=/sms/*/jobs) (questo URL permette di avere automaticamente le autorizzazioni per i passaggi descritti in questa guida). ![creazione dei token](/images/web-cloud/messaging/sms/send-sms-api-php/img_2451.jpg) In questo semplice esempio, recuperiamo le autorizzazioni per avere accesso alle informazioni sull’account, alla possibilità di vedere i messaggi in uscita e di inviare SMS. - GET /sms - GET /sms/\*/jobs - POST /sms/\*/jobs L’asterisco (\*) attiva le chiamate a questi metodi per tutti i tuoi account di SMS. Puoi ugualmente limitare le chiamate a un solo account, se gestisci diversi account SMS sul tuo account OVHcloud, sostituendo "/sms" con "/sms/NOME-ACCOUNT" e "/sms/\*/" con "/sms/NOME-ACCOUNT/". In questo modo recupererai gli identificativi per il tuo script: - Application Key (identifica la tua applicazione) - Application Secret (autentica la tua applicazione) - Consumer Key (autorizza l’applicazione ad accedere ai metodi scelti) ![recupero dei token](/images/web-cloud/messaging/sms/send-sms-api-php/img_2452.jpg) L’ambiente è pronto, gli identificativi sono creati, ora puoi codificare il tuo script PHP. ### Passaggio 3: Configurazione di un SDK PHP Per semplificare le cose abbiamo configurato un SDK PHP che è possibile trovare sul [repository GitHub php-ovh-sms](https://github.com/ovh/php-ovh-sms). ### Passaggio 4: Connessione base all’API A questo punto è possibile verificare se la connessione all’API è buona visualizzando i dati di ciascun account SMS: ``` get('/sms/'); foreach ($smsServices as $smsService) { print_r($smsService); } ?> ``` All’avvio di questo script dovresti recuperare l’elenco dei tuoi account SMS. ### Passaggio 5: Invio del primo SMS Per inviare degli SMS, utilizza il metodo POST jobs: [🇪🇺POST/sms/{serviceName}/jobs](https://eu.api.ovh.com/console/?section=/sms&branch=v1#post-/sms/-serviceName-/jobs) :::info **Solo per gli account OVHcloud in Francia escluso DOM-TOM:** Il parametro senderForResponse permetterà di utilizzare un numero breve, il che consente di inviare direttamente degli SMS senza dover creare un mittente alfanumerico (ad esempio: il tuo cognome). I numeri brevi permettono anche di ricevere delle risposte da parte dei destinatari dei tuoi SMS, il che può essere utile per un sondaggio sulla soddisfazione, un’applicazione di voto, un gioco,... ::: ``` get('/sms/'); foreach ($smsServices as $smsService) { print_r($smsService); } $content = (object) array( "charset"=> "UTF-8", "class"=> "phoneDisplay", "coding"=> "7bit", "message"=> "Bonjour les SMS OVH par api.ovh.com", "noStopClause"=> false, "priority"=> "high", "receivers"=> [ "+3360000000" ], "senderForResponse"=> true, "validityPeriod"=> 2880 ); $resultPostJob = $conn->post('/sms/'. $smsServices[0] . '/jobs', $content); print_r($resultPostJob); $smsJobs = $conn->get('/sms/'. $smsServices[0] . '/jobs'); print_r($smsJobs); ?> ``` Ecco il tipo di risposta prevista: ``` sms-XXXXXX-1 Array ( [totalCreditsRemoved] => 1 [invalidReceivers] => Array ( ) [ids] => Array ( [0] => 26929925 ) [validReceivers] => Array ( [0] => +3360000000 ) ) Array ( ) ``` Recuperi l’account SMS (ServiceName). Ottieni una risposta con 1 credito consumato per un numero valido. Infine, verifica che non vi siano SMS in uscita. #### Dimensione degli SMS commerciali Un SMS commerciale deve obbligatoriamente includere la dicitura STOP. Questa contiene 11 caratteri e viene automaticamente detratta dai 160 caratteri di base del primo SMS. La tabella seguente indica quindi il numero massimo di caratteri consentiti per gli SMS commerciali. Esempio: in codifica a 7 bit, se il tuo messaggio supera i 149 caratteri, sarà inviato in 2 SMS e costerà quindi 2 crediti. | Codifica | Primo SMS | Secondo SMS e successivi | | ----------------------- | ------------- | ------------------------ | | 7 bit (norma GSM 03.38) | 149 caratteri | 153 caratteri | | Unicode | 59 caratteri | 70 caratteri | ## Per saperne di più La [console di API](https://api.ovh.com/console/?section=%2Fsms\&branch=v1) ti permetterà di scoprire altri metodi per facilitare l’integrazione di servizi SMS quali: SMS che permettono la risposta (unicamente per gli account OVHcloud in Francia), invio in massa con file CSV, mailing o con conferma di ricezione... Contatta la nostra [Community di utenti](https://community.ovhcloud.com/).