Setup iniziale e autenticazione
Registra un account su Chat API, crea un'API key nel pannello di controllo e salva la chiave come variabile d'ambiente. Non inserire mai la chiave direttamente nel codice sorgente.
Per Node.js, installa axios (npm install axios) o usa il fetch nativo. Per Python, installa requests (pip install requests). Entrambe le librerie permettono di fare richieste HTTP all'endpoint API di Chat API.
Esempio Node.js: invio messaggio e template
Il codice Node.js per inviare un messaggio di testo semplice e una chiamata POST all'endpoint /messages di Chat API con il numero del destinatario, il tipo di messaggio ('text') e il testo. La risposta include l'ID del messaggio che puoi usare per il tracciamento.
Per l'invio di un template con variabili, aggiungi il campo 'template' al body della richiesta con il nome del template e i valori delle variabili. La struttura del payload segue le specifiche di Chat API documentate nella documentazione tecnica.
La gestione degli errori corretta prevede di verificare il codice HTTP della risposta (2xx per successo, 4xx per errori del client, 5xx per errori del server) e di loggare il corpo della risposta in caso di errore per il debug.
Esempio Python: invio con retry logic
In Python, la libreria tenacity o un semplice ciclo for permettono di implementare retry logic con backoff esponenziale. Questo e fondamentale per gestire i rate limit e i timeout transitori senza perdere messaggi.
Gestione degli eventi via webhook
Per ricevere gli aggiornamenti di stato dei messaggi, configura un endpoint webhook nel pannello Chat API. In Node.js, Express.js permette di creare un endpoint POST in poche righe che riceve gli eventi e li processa.
Gli eventi principali da gestire sono: 'message.sent' (messaggio inviato all'API), 'message.delivered' (consegnato al dispositivo), 'message.read' (letto), 'message.failed' (fallito con codice errore). Salva ogni evento nel database con timestamp per il tracciamento completo.
La documentazione tecnica di Chat API include esempi completi per Node.js, Python, PHP e Go. La sandbox di Chat API permette di testare l'invio e la ricezione senza messaggi reali verso clienti finali durante lo sviluppo.
