Se stai sviluppando un'app che sarà usata da altre aziende, consulta le nostre guide Primi passi per i fornitori di soluzioni tecnologiche o Primi passi per i partner di soluzioni.
Primi passi
Questa guida ti aiuterà a inviare e ricevere il tuo primo messaggio usando l'API Cloud. Imparerai anche come configurare i webhook da usare con un'app di esempio.
Questa guida è destinata alle persone che sviluppano app per sé stesse o per la propria organizzazione. Se stai sviluppando un'app che sarà usata da altre aziende, consulta le nostre guide Primi passi per i partner di soluzioni o Primi passi per i fornitori di soluzioni tecnologiche.
Prima di iniziare
Ecco cosa ti servirà:
- Un account sviluppatore di Meta (scopri di più sulla registrazione come sviluppatore di Meta).
- Un'app business (scopri di più sulla creazione di app). Se non vedi l'opzione per creare un'app business, seleziona Altro > Avanti > Business.
Passaggio 1: aggiunta del prodotto WhatsApp alla tua app
A questo punto, se hai creato una nuova app, ti verrà chiesto di aggiungere prodotti alla tua app. Scorri verso il basso e in WhatsApp, seleziona Configura. In caso contrario, seleziona la tua app dalla schermata Le mie app e potrai seguire di nuovo le stesse istruzioni per aggiungere WhatsApp alla tua app.
Se hai un account business di Meta (MBA), ti verrà chiesto di allegarlo quando aggiungi il prodotto WhatsApp alla tua app. Se non hai un account business di Meta, riceverai alcuni messaggi che ti aiuteranno a crearlo. Dopo avere allegato il tuo account business di Meta alla tua richiesta, sarà tutto pronto per iniziare i test.
L'aggiunta del prodotto WhatsApp alla tua app implica alcune conseguenze:
- Se non hai un account business di Meta, ti verrà richiesto di crearlo.
- Crea automaticamente un account WhatsApp Business di prova per te. Questo account ha delle limitazioni e dovrebbe essere usato a fini di test e sviluppo, dato che non paghi per i messaggi.
- Crea un numero di telefono aziendale di test associato al tuo account WhatsApp Business. Questo numero ti permette di inviare messaggi gratuiti a un massimo di 5 numeri di telefono destinatari.
- Crea una serie di modelli di messaggi pre-approvati.
Passaggio 2: aggiunta di un numero destinatario
Aggiungi un numero WhatsApp valido a cui inviare i messaggi di test.
Dal menu a sinistra della Dashboard gestione app, seleziona WhatsApp > Configurazione API. Da Invia e ricevi messaggi, seleziona il campo A e scegli Gestisci elenco di numeri di telefono.
Puoi aggiungere come destinatario qualsiasi numero di WhatsApp valido. Il numero del destinatario riceverà un codice di conferma su WhatsApp, che potrà essere usato per verificare il numero.
Dopo la verifica, il numero del destinatario dovrebbe essere selezionato nel campo A. Ripeti la procedura se vuoi aggiungere un altro destinatario. Puoi aggiungerne fino a 5.
Passaggio 3: invio di un messaggio di prova
Invia il modello di messaggio pre-approvato hello_world al numero del destinatario selezionato.
Nella scheda WhatsApp > Configurazione API:
- Assicurati che il numero di telefono aziendale di test sia selezionato nel campo Da.
- Assicurati che il numero di telefono del destinatario a cui desideri inviare un messaggio sia selezionato nel campo A. Se hai aggiunto più numeri, puoi inviare più messaggi contemporaneamente.
- Nella scheda Invia messaggi con l'API, clicca sul pulsante Invia messaggio.
In alternativa, puoi copiare il comando cURL, incollarlo in una nuova finestra del terminale ed eseguirlo.
Tieni presente che il codice indica che stai inviando un modello di messaggio (”type”:”template”) e che stai identificando un modello specifico da usare (”name”:”hello_world”).
Passaggio 4: clonazione dell'app di esempio e configurazione dei webhook
I webhook ti consentono di ricevere notifiche HTTP in tempo reale relative a modifiche a oggetti specifici. In WhatsApp, i webhook possono informarti di molti eventi nella tua app, come la consegna dei messaggi e le notifiche di lettura, nonché delle modifiche dell'account.
Aggiungi un URL di callback per visualizzare il contenuto dei webhook. Segui la nostra guida Esempio di URL di callback per il test dei webhook per clonare la nostra app di esempio, che accetta notifiche webhook e mostra i loro payload JSON sullo schermo.
Una volta configurato il webhook, invia di nuovo il modello di messaggio e rispondi. Dovresti ricevere 4 notifiche distinte dei webhook: il messaggio inviato, consegnato, le notifiche di lettura e il contenuto del messaggio in arrivo. Ottimo lavoro!
Passaggio 5: aggiunta di un numero aziendale reale (facoltativo)
Puoi iniziare a sviluppare l'applicazione con il numero aziendale di test e l'account WhatsApp Business di test. Usando queste risorse di test, non pagherai per l'invio di messaggi durante lo sviluppo dell'app.
Quando ti senti pronto per iniziare a inviare messaggi ai tuoi clienti, puoi aggiungere un vero numero di telefono aziendale nella scheda Configurazione API e creare un vero account WhatsApp Business.