Cosa puoi testare nella sandbox
La sandbox di Chat API permette di testare: invio di messaggi di testo, invio di template con variabili, ricezione di messaggi simulati via webhook, invio di messaggi interattivi (pulsanti, liste), invio di file allegati, e la logica di gestione degli errori.
I webhook vengono simulati dalla sandbox: puoi configurare eventi di test (messaggio ricevuto, stato consegnato, stato letto, errore di consegna) e verificare che il tuo backend li gestisca correttamente senza aspettare messaggi reali.
La sandbox e accessibile con le stesse credenziali del tuo account Chat API ma usa un endpoint separato e numeri di test. I messaggi inviati nella sandbox non vengono consegnati a destinatari reali e non generano costi di conversazione.
Come configurare l'ambiente di sviluppo
La configurazione tipica dell'ambiente di sviluppo prevede: account Chat API con accesso sandbox, variabili d'ambiente separate per staging e produzione (CHAT_API_KEY_STAGING, CHAT_API_KEY_PRODUCTION), e endpoint webhook diversi per ogni ambiente.
Per testare i webhook in locale durante lo sviluppo, usa un tool di tunneling come ngrok che espone il tuo server locale su un URL HTTPS pubblico. Questo URL temporaneo puo essere configurato come webhook endpoint nella sandbox.
Usa numeri di telefono di test nel formato +39000[4 cifre] nella sandbox per simulare diversi destinatari. Ogni numero di test puo essere usato per testare scenari diversi (numero valido, numero non WhatsApp, numero bloccato).
Test automatizzati per le integrazioni WhatsApp
Scrivi test automatizzati che usano la sandbox per verificare il corretto funzionamento dell'integrazione: test di invio messaggio, test di ricezione webhook, test di gestione degli errori. Esegui questi test ad ogni deploy in staging prima di andare in produzione.
Passaggio da sandbox a produzione
Prima del go-live in produzione, esegui una checklist di verifica: tutti i template sono stati approvati da Meta, le credenziali di produzione sono configurate correttamente nelle variabili d'ambiente, i webhook di produzione sono configurati su HTTPS con certificati validi, il sistema di monitoring e alerting e attivo.
Esegui un go-live graduale: inizia inviando messaggi a un gruppo ristretto di utenti interni o beta tester prima di aprire a tutta la base clienti. Questo permette di identificare problemi non emersi nei test in sandbox.
