La libreria in PHP è stata realizzata per semplificare l’uso delle API nello sviluppo di progetti con WAZone, la classe è scaricabile dal sito GitHub oppure è possibile integrarla con Composer, in questo modo sarà sempre aggiornata nel vostro progetto.
L’uso della libreria è molto semplice, accedere a wazone.app e recuperare il DEVICE_ID e il TOKEN_ID del vostro dispositivo mittente, quindi importate nel vostro sorgente la classe con il comando include e chiamate il membro della funzione che vi occorre.
| Nome | Descrizione | Parametri | Valori |
|---|---|---|---|
| WAZone() | Costruttore della classe | DEVICE_ID:text TOKEN_ID:text |
obbligatorio obbligatorio |
| SendText() | Funzione: Invia messaggio | NUMBER:text MESSAGE:text |
obbligatorio obbligatorio |
| SendMedia() | Funzione: Invia media e testo | NUMBER:text MEDIAURL:text MESSAGE:text |
obbligatorio obbligatorio facoltativo |
| CheckNumber() | Funzione: Controlla numero | NUMBER:text | obbligatorio |
Le funzioni della classe ritornano una variabile “success” che indica lo stato della operazione
se è andata a buon fine.
Qui sotto trovate dei semplici esempi di uso del servizio per l’invio dei messaggi… copiate il Costruttore e una delle Funzioni (SendText, SendMedia, CheckNumber) in base a quello che vi serve, sostituite i valori nelle variabili e in un attimo avrete integrato l’invio di messaggi su WA nella vostra applicazione o servizio.
// includere la libreria (con composer usare l'autoloading)
include("class.wazone.php");
// wa_device e wa_token sono il numero di telefono e il token del cellulare
// si trovano nel pannello di gestione WAZone nelle proprietà del dispositivo
// registrarsi su https://wazone.app per avere un account di prova per 30gg
$wa_device = 'IL_TUO_NUMERO';
$wa_token = 'IL_TUO_TOKEN';
// numero di telefono del destinatario, ATTENZIONE:
// i numeri di telefono devono essere nel formato 393123456789
// (preceduti dal prefisso internazionale, '39' x l'italia)
$wa_number = 'DESTINATARIO';
// istanziare la classe WAZone
$WA = new WAZone($wa_device, $wa_token);
// una volta caricata e inizializzata la libreria, chiamare la funzione...
// invio messaggio testuale
$API = $WA->SendText($wa_number, "Prova invio messaggio!");
if (!$API->success) {
print "Errore invio messaggio \n";
} else {
print "Messaggio inviato a $wa_number!!\n";
}
// il messaggio verrà ricevuto sul cellulare del DESTINATARIO
// una volta caricata e inizializzata la libreria, chiamare la funzione...
// url del file multimediale da inviare al destinatario
$urlmedia = "https://verbasoft.github.io/WAZone/docs/wazone.pdf";
// invia messaggio multimediale
$API = $WA->SendMedia($wa_number, $urlmedia, "prova invio documento pdf...");
if (!$API->success) {
print "Errore invio messaggio!! \n";
} else {
print "Messaggio inviato a $wa_number!!\n";
}
// il messaggio testuale e l'allegato verrà ricevuto sul cellulare del DESTINATARIO
// una volta caricata e inizializzata la libreria, chiamare la funzione...
// controllo se il numero è presente in WA
$API = $WA->CheckNumber($wa_number);
if (!$API->success) {
print "Numero $wa_number non presente su WA! \n";
} else {
print "Numero $wa_number è presente su WA!!\n";
}
// con questa funzione saprete se il numero è presente in WA
Forniamo un servizio di analisi e integrazione del vostro sistema informatico, acquistabile sul sito wazone, in cui viene studiata l’integrazione al vostro ambiente, sito internet, software windows, portale web, etc…