Tutorial

Ricezione e gestione dei messaggi webhook

 

Con un webhook puoi ricevere notifiche quando succede qualcosa con un bot di trading. In questo tutorial imparerai a verificare il tuo webhook e a iniziare a ricevere e gestire i messaggi webhook dell'API. In questo tutorial useremo il linguaggio PHP per creare il nostro webhook, ma ovviamente potrai anche creare il tuo webhook in qualsiasi altro linguaggio di programmazione. Avrai chiaramente bisogno di un server pubblico a cui possiamo inviare i messaggi webhook e il server pubblico deve essere protetto con un certificato SSL, deve essere accessibile tramite https. Avrai anche bisogno di un'app su Cryptohopper, se non hai ancora creato un'app, vai su App e crea la tua prima app.

Preparazione del tuo webhook

Prima di configurare e connettere il tuo webhook alla tua app, prepareremo il tuo webhook sul tuo server. Copia il codice PHP sottostante e posizionalo nella cartella pubblica del tuo server. Chiamiamolo webhook.php.


Assicurati di regolare la variabile segreta dell'app e la variabile del codice di verifica. Il segreto dell'app si trova quando modifichi la tua app e il codice di verifica può essere quello che vuoi. Assicurati di ricordare il codice di verifica, perché ti servirà quando vorrai verificare il tuo webhook.

Configura il tuo webhook nella tua app

Ora che hai creato un webhook sul tuo server, possiamo configurare il tuo webhook nella tua app. Vai su App, seleziona la tua app e fai clic sulla scheda "webhook". Fai clic su "Aggiungi webhook" e inizia a inserire l'URL del tuo webhook (con https). Quindi puoi configurare il tipo di messaggi che desideri ricevere selezionando gli abbonamenti. Infine, devi inserire il codice di verifica che hai inserito nel codice PHP sul tuo server, deve corrispondere esattamente. Fai clic su valida e salva, il tuo webhook dovrebbe ora essere visualizzato sotto nell'elenco dei webhook collegati.

Ricezione dei messaggi webhook

Poiché il codice PHP nell'esempio è progettato per fare semplicemente eco e stampare i messaggi webhook, non vedrai immediatamente se il tuo codice webhook funziona. Pertanto, dobbiamo apportare alcune modifiche al codice PHP per inoltrare i messaggi webhook all'e-mail o, ad esempio, salvare i messaggi in un database. La decisione spetta a te, dipende da te cosa vuoi fare con i messaggi webhook.

Per inoltrare semplicemente i messaggi webhook come notifiche alla tua e-mail, puoi usare e regolare il codice PHP nell'esempio seguente.

'.$message['type'];
            $email_message .= 'Titolo:
'.$message['title']; $email_message .= '

'; $email_message .= 'Messaggio:
'.$message['message']; mail($send_to_email, $subject_email, $email_message); } } }else{ // unkown type echo 'Tipo di messaggio webhook sconosciuto.'; } }else{ //invalid signature echo 'Firma non valida.'; } ?>

Assicurati di modificare le variabili nell'esempio precedente per soddisfare le tue esigenze. Se hai bisogno di maggiori informazioni sulle possibilità dei webhook, consulta la documentazione dell'API Webhooks per maggiori informazioni.