Ora puoi migrare il tuo account WhatsApp 360dialog connesso all'API WhatsApp Business di respond.io per usufruire di maggiore affidabilità, costi inferiori e accesso a nuove funzionalità. Scopri di più sul processo di migrazione qui.
Per connettere WhatsApp Cloud API, è necessaria un'app Facebook con il prodotto WhatsApp abilitato. Leggi questa guida su come configurare la tua app di Facebook.
Il 20 maggio Facebook ha annunciato il rilascio della WhatsApp Cloud API, che è a disposizione di tutte le aziende, grandi e piccole, per comunicare con i clienti utilizzando l'API ufficiale di WhatsApp.
Questo canale ha una finestra di messaggistica limitata a 24 ore a causa delle normative di WhatsApp. Scopri di più sulla politica aziendale di WhatsApp qui.
Connessione dell'API WhatsApp Cloud
Guarda il video qui sotto per una guida dettagliata su come connettere WhatsApp Cloud API a respond.io.
Per chattare con i tuoi clienti tramite WhatsApp Cloud API, collega un profilo WhatsApp Business e un account Meta Business.
Sono richiesti l'app Facebook e l'account Meta Business e per connetterli devi essere amministratore di entrambi.
Passaggio 1: Vai a Impostazioni dello spazio di lavoro > Clicca su Aggiungi Canale
Passaggio 2: Individua il canale WhatsApp Cloud API > Clicca su Connetti.
Passaggio 3: Fai clic sul pulsante Connettiti con Facebook.
Passaggio 4: Accedi utilizzando l'account Facebook con accesso amministratore all'app Facebook e all'account aziendale Meta.
Passaggio 5: Nell'elenco a discesa, seleziona il nome WABA con il numero WhatsApp a cui desideri connetterti.
Passaggio 6: aggiungere l'URL di callback. Torna alla sezione WhatsApp nell'app per sviluppatori di Facebook. Vai alla sottosezione Configurazione e imposta l'URL di callback. Aggiungi l'URL di callback generato e verifica il token da respond.io nei campi corrispondenti nella finestra di dialogo del webhook.
Passaggio 7: Sull'app di Facebook, verifica e salva le modifiche all'app.
Passaggio 8: Iscriviti all'evento webhook. Sulla tua app di Facebook, seleziona la scheda Webhook nel pannello Prodotti e seleziona WhatsApp Business Account nell'elenco a discesa. Clicca sull'evento "Iscriviti ai messaggi".
Passaggio 9: Clicca sul pulsante in cima alla pagina per attivare la modalità live.
Ricorda di inserire l'URL della tua informativa sulla privacy. Se questo campo è vuoto, non sarà possibile attivare la modalità live.
Passaggio 10: Clicca su Salva modifiche per completare l'installazione.
Una volta completata la configurazione, tutti i messaggi inviati al tuo numero WhatsApp saranno ora ricevuti nel tuo spazio di lavoro.
Configurazione del canale
Il canale WhatsApp Cloud API può essere configurato con un nome canale univoco.
Passaggio 1: Vai a Impostazioni dello spazio di lavoro > Clicca su Canali.
Passaggio 2: Individua il canale WhatsApp Cloud API > Clicca su Gestisci.
Passaggio 3: Configura il nome del canale, che viene usato internamente per identificare l'account.
Passaggio 4: Clicca su Salva modifiche per aggiornare la configurazione del canale.
Metadati ricevuti dal canale
Canali diversi forniscono set diversi di metadati dei contatti alla piattaforma respond.io. Ecco l'elenco dei dati dei contatti che potrai ottenere da questo canale:
Numero di telefono
ID numero di telefono
Nome del profilo
ID WhatsApp
Gestire il profilo API WhatsApp Cloud.
Se è necessario apportare una modifica o controllare il tuo profilo WhatsApp Cloud API, puoi farlo sulla piattaforma respond.io.
Passaggio 1: Vai a Impostazioni dello spazio di lavoro > Clicca su Canali.
Passaggio 2: Individua il canale WhatsApp Cloud API > Clicca su Gestisci > Profilo.
Passaggio 3: Fai clic su Sincronizza profilo per ottenere le informazioni più recenti sul profilo WhatsApp Business da WhatsApp.
Passaggio 4: Modificare le seguenti informazioni secondo necessità.
Campi | Descrizione |
|---|---|
Foto del profilo | Immagine mostrata come immagine del profilo dell'account WhatsApp Business. Si consiglia una dimensione dell'immagine di 640x640. |
Di | Il testo di 'About' dell'attività. Questo testo appare nel profilo aziendale sotto l'immagine del profilo, il numero di telefono e i pulsanti di contatto. |
Indirizzo | Indirizzo dell'attività commerciale. Massimo 256 caratteri. |
Descrizione | Descrizione dell'attività. Massimo 512 caratteri. |
Indirizzo email (in un formato email valido) per contattare l'azienda. Massimo 128 caratteri. | |
Verticale | Settore dell'attività. Deve essere uno di questi valori accettati: Automotive, Bellezza, Spa e Saloni, Abbigliamento e Moda, Istruzione, Intrattenimento, Pianificazione di Eventi e Servizi, Finanza e Banca, Cibo e Generi Alimentari, Servizi Pubblici, Hotel e Alloggio, Medicina e Salute, Non Profit, Servizi Professionali, Shopping e Vendita al Dettaglio, Viaggi e Trasporti, Ristorante, Altro. Il settore dell'attività non può essere reimpostato su un valore vuoto dopo che è stato creato. |
Sito web | URL (inclusi http:// o https://) associati all'attività commerciale (ad esempio sito web, pagina Facebook, Instagram). Massimo 2 siti web con un massimo di 256 caratteri ciascuno. |
Passaggio 5: rivedere le informazioni e fare clic su Salva modifiche.
Gestione dei modelli di messaggi di WhatsApp
Prima di inviare un modello di messaggio a un contatto sulla piattaforma respond.io, assicurati di aver fatto quanto segue:
- Inviato il modello di messaggio per l'approvazione - Aggiunto il modello di messaggio approvato all'area di lavoro sincronizzando il modello di messaggio
Invio di modelli di messaggio
Passaggio 1: Vai a Impostazioni dello spazio di lavoro > Clicca su Canali.
Passaggio 2: Individua il canale WhatsApp Cloud API > Clicca su Gestisci.
Passaggio 3: fare clic su Modelli > Invia modello per inviare un modello di messaggio per l'approvazione.
Passaggio 4: Inserisci le informazioni richieste per creare un modello.
Campo | Descrizione |
|---|---|
Nome del modello | Il nome può contenere solo caratteri alfanumerici minuscoli e caratteri di sottolineatura ( _ ) |
Categoria | La categoria a cui appartiene il modello di messaggio. |
Lingua | La lingua in cui è scritto il modello. |
Passaggio 5: Crea il messaggio compilando i componenti necessari, quindi rivedi il messaggio nella sezione di anteprima. È possibile includere i parametri {{1}}, {{2}}, ecc. come segnaposto da riempire con contenuto personalizzato.
Blocco di costruzione | Descrizione |
|---|---|
Corpo | Il Corpo contiene il testo più importante del tuo modello. È supportato solo il testo. Puoi usare il markdown per formattare il contenuto di questo blocco. Scopri di più. |
Intestazione | L'intestazione è facoltativa e funge da titolo o intestazione del modello. Supporta i seguenti formati: |
Piè di pagina | Il piè di pagina è facoltativo e supporta solo testo. Può essere utilizzato per fornire informazioni supplementari nel modello del messaggio. |
Pulsante | Il pulsante è facoltativo e aggiunge interattività ai tuoi modelli. Ci sono due tipi disponibili: |
Passaggio 6: fornire il valore campione
Questo è applicabile solo se hai incluso dei parametri nel contenuto del modello di messaggio.
Specificare valori di esempio per il parametro nel modello del messaggio aiuterà il revisore di WhatsApp a comprendere il messaggio che stai cercando di inviare ai tuoi contatti.
Link importante: Linee guida per i modelli di messaggi WhatsApp
Sincronizzazione dei modelli di messaggio
Passaggio 1: Vai a Impostazioni dello spazio di lavoro > Clicca su Canali.
Passaggio 2: Individua il canale WhatsApp Business Platform (API) > Clicca su Gestisci.
Passaggio 3: fare clic su Modelli > Sincronizza modello per iniziare il processo di sincronizzazione.
Il processo di sincronizzazione è stato completato. Questo significa:
- I modelli di messaggio saranno elencati con i rispettivi stati.
- Verrà aggiornata la data e l'ora dell'ultima sincronizzazione.
- Se il tuo modello viene rifiutato, il motivo del rifiuto verrà visualizzato sotto il modello di messaggio rifiutato.
Nella tabella seguente sono elencati i possibili stati dei modelli di messaggio:
Stato | Descrizione |
|---|---|
Inviato | Il modello del messaggio è stato inviato ed è in attesa di approvazione. |
Approvato | Il modello di messaggio è approvato e può essere inviato ai contatti. |
Respinto | Il modello di messaggio è stato rifiutato e non può essere utilizzato. |
Utilizza la ricerca e il filtro nell'angolo in alto a destra dell'elenco per trovare facilmente i tuoi modelli!
Tipi di file supportati
Il tipo di file supportato da WhatsApp e la dimensione massima del file per questo tipo sono i seguenti:
Audio & Video (16 MB)
Documento (100 MB)
Immagine (5 MB)
Adesivo (100 KB)
I messaggi non supportati saranno visualizzati in modalità fallback con il testo Messaggio non supportato o Payload personalizzato e Tipo (se disponibile). Per qualsiasi tipo di file non supportato o che superi la dimensione massima inviata tramite WhatsApp Cloud API, il file verrà automaticamente trasformato in un collegamento URL sulla piattaforma respond.io. Per il payload personalizzato, puoi cliccare Mostra altro per visualizzare il payload JSON di questo messaggio. Esempi di messaggi non supportati per WhatsApp Cloud API sono:
- Reazioni
- Messaggio eliminato
- Sondaggi
- Messaggio temporaneo
Limiti di velocità
Un limite di frequenza è il numero di chiamate API che un'app o un utente può effettuare entro un determinato periodo di tempo definito dal canale. Scopri di più sui limiti di invio per questo canale.
FAQ e risoluzione dei problemi
Impossibile inviare messaggi
Accertati che il numero che hai collegato alla piattaforma sia un numero WhatsApp Cloud API.
I messaggi non arrivano
Ciò può accadere quando il webhook dei messaggi non è sottoscritto.
Passaggio 1: vai alla pagina del webhook dell'app Facebook
Apri l'app di Facebook e vai alla pagina Webhook .
Passaggio 2: verifica l'evento sottoscritto
Seleziona Account WhatsApp Business e verifica se l'evento messaggi è sottoscritto.
Passaggio 3: invia un messaggio di prova
Invia un messaggio di prova al numero di telefono WhatsApp e verifica se è arrivato.
Impossibile ricevere le ricevute di lettura
Quando l'utente connesso a WhatsApp Cloud API modifica la propria password di Facebook, le autorizzazioni diventano obsolete e devono essere aggiornate.
Passaggio 1: Vai a Impostazioni dello spazio di lavoro > Clicca su Canali.
Passaggio 2: Individua il canale WhatsApp Business Platform (API) > Clicca su Gestisci.
Passaggio 3: fai clic su Risoluzione dei problemi > Aggiorna autorizzazione per aggiornare le autorizzazioni di WhatsApp.
Passaggio 4: Invia un messaggio di prova al numero di telefono WhatsApp e controlla se è arrivato.
Impossibile inviare messaggi in uscita: errore di convalida del token di accesso
Ciò può accadere per diversi motivi:
Quando la sessione per la convalida del token di accesso è scaduta.
È stata apportata una modifica ai privilegi di amministratore dell'utente'in Meta Business Manager.
Si è verificato un cambio di password su Meta Business Manager.
Per risolvere questo errore, devi aggiornare le autorizzazioni del canale WhatsApp Cloud API e inviare nuovamente un messaggio di prova.
Per poter aggiornare le autorizzazioni, devi essere l'amministratore di Meta Business Manager.
Contatto che non riceve messaggi
Ciò può accadere quando il contatto non ha accettato i termini e l'informativa sulla privacy di WhatsApp.
Se i tuoi contatti non riescono a ricevere messaggi dal tuo numero WhatsApp Cloud API, assicurati che abbiano accettato i termini e l'informativa sulla privacy più recenti di WhatsApp.
Quali sono i requisiti del numero di telefono da utilizzare per registrarsi a WhatsApp Cloud API?
Il numero di telefono utilizzato per WhatsApp Cloud API non può essere utilizzato nell'app personale o aziendale di WhatsApp. Dovrai'eliminare l'account sull'app WhatsApp personale o aziendale prima di poter utilizzare il numero per registrarti a un'API WhatsApp Cloud.
Dopo averlo registrato sulla piattaforma WhatsApp Business, potrai continuare a utilizzare il numero per altri scopi, ad esempio per chiamare e ricevere SMS.
Una volta utilizzato un telefono per WhatsApp Cloud API, non sarà più possibile utilizzare quel numero sull'app WhatsApp Business.
È necessaria la verifica aziendale per iniziare a utilizzare Cloud API?
Non è obbligatorio completare la verifica di Facebook Business per iniziare a inviare messaggi su WhatsApp. Senza la verifica aziendale, la tua azienda sarà comunque in grado di:
Rispondi a un numero illimitato di conversazioni avviate dagli utenti.
Invia conversazioni avviate dall'azienda (modelli di messaggi) a 250 clienti unici nell'arco di 24 ore.
Registra fino a 2 numeri di telefono.
Le aziende possono avviare la Verifica dell'Attività solo quando sono pronte a scalare conversazioni avviate dall'attività o vogliono diventare un Account Aziendale Ufficiale.
Posso visualizzare le informazioni dettagliate sulle conversazioni del mio account WhatsApp Business?
Sì, puoi monitorare in tempo reale i tuoi messaggi e le analisi delle spese per il tuo account WhatsApp Business nella scheda Insights del tuo Meta WhatsApp Manager. Leggi di più qui.
Quali sono i limiti dei messaggi su WhatsApp?
I limiti di messaggistica determinano il numero massimo di utenti unici di WhatsApp con cui un portfolio aziendale può avviare conversazioni di iniziativa aziendale in un periodo di 24 ore. Questo limite è condiviso tra tutti i numeri di telefono nel portfolio.
Questi limiti non si applicano alle conversazioni avviate dall'utente. Una conversazione di iniziativa aziendale inizia quando il primo messaggio viene consegnato a un cliente e dura per 24 ore.
Un comune malinteso è che ogni messaggio conti per il limite: in realtà, più messaggi inviati allo stesso utente nell'arco di 24 ore contano ancora come una conversazione.
Leggi di più qui.
Come faccio ad aggiungere un metodo di pagamento al mio account WhatsApp Business?
Puoi aggiungere un metodo di pagamento al tuo account WhatsApp Business in Business Manager. Scopri come aggiungere un metodo di pagamento al tuo account WhatsApp Business qui.
Perché il mio messaggio non è stato inviato e ho ricevuto l'errore "Problema di pagamento per l'idoneità aziendale"?
Ciò è dovuto molto probabilmente al superamento della soglia del livello gratuito mensile senza un metodo di pagamento valido. Per risolvere questo problema, aggiungi un metodo di pagamento valido.
Qual è il prezzo della WhatsApp Cloud API?
Dal 1 luglio 2025, WhatsApp Cloud API utilizza un modello di pricing ibrido. Le conversazioni di servizio (quando rispondi a un cliente entro 24 ore) vengono addebitate per conversazione. I messaggi modello — Marketing, Utilità e Autenticazione — vengono addebitati per messaggio inviato. I modelli di utilità sono gratuiti se inviati entro 24 ore, mentre i modelli di autenticazione e marketing sono sempre addebitati per messaggio. I modelli ad alto volume di utilità e autenticazione ricevono sconti automatici scalari. Le conversazioni di entry point gratuite da annunci o CTA delle pagine aprono una finestra gratuita di 72 ore in cui tutti i tipi di messaggi sono gratuiti.
Come faccio a eliminare un numero di telefono da un account aziendale?
Per eliminare un numero di telefono sono necessari alcuni requisiti e passaggi, per saperne di più leggi qui.
Posso usare respond.io per inviare un broadcast WhatsApp Cloud API con il numero di test Meta?
È possibile inviare una trasmissione di prova dalla piattaforma utilizzando il numero di prova Meta. Tuttavia, una trasmissione tramite il numero di prova è limitata a cinque destinatari. Per prima cosa devi aggiungere questi cinque destinatari all'elenco dei numeri di telefono negli strumenti di Meta Developer.
Se non aggiungi destinatari a questo elenco o se tenti di inviare un messaggio broadcast a destinatari non presenti in questo elenco, riceverai il seguente messaggio di errore:
Posso eliminare il numero di test Meta dal mio account Cloud API connesso?
No, questo numero viene fornito automaticamente a tutti gli account per l'invio di messaggi di prova e non può essere eliminato. Tieni presente che questo è un numero di prova e non deve essere utilizzato per altri scopi.
Perché vedo contatti duplicati dallo stesso canale WhatsApp?
WhatsApp fornisce il numero di telefono del contatto in un formato diverso dal formato E.164 che usa respond.io. Questa differenza fa sì che i contatti di alcuni Paesi vengano duplicati. Se ciò accade, contattaci qui.
Come faccio a modificare il nome visualizzato della mia Cloud API?
Per modificare il nome visualizzato della tua Cloud API, segui questi passaggi:
Vai a FBM > Account WhatsApp > Numero di telefono. Questa pagina mostra il limite e la qualità dei tuoi messaggi.
Passare il mouse sull'icona della matita accanto al nome visualizzato per abilitare la modifica.
Fai clic su Avanti per inviare il tuo nuovo nome visualizzato a Meta per l'approvazione.
Attendi la conferma dell'approvazione da Meta.
Quali passaggi devo seguire una volta approvato il nuovo nome visualizzato per la mia Cloud API?
Dopo aver ricevuto l'approvazione da Meta per il tuo nuovo nome visualizzato, completa i seguenti passaggi:
Registra nuovamente il tuo numero di telefono utilizzando il nome visualizzato appena approvato.
Esegui una chiamata API POST per verificare il tuo numero di telefono.
Effettua un'altra chiamata API POST a per registrare nuovamente il numero di telefono verificato.
Una volta completato, l'aggiornamento del nome visualizzato della tua Cloud API è completo.
Perché ho riscontrato l'errore "Errore di convalida del token di accesso: la sessione è stata invalidata perché l'utente ha cambiato la propria password o Facebook ha modificato la sessione per motivi di sicurezza" quando ho provato a inviare un messaggio?
Questo errore si verifica se hai aggiornato di recente le tue credenziali Facebook; ciò potrebbe interrompere la connessione del canale sulla nostra piattaforma, causando errori durante l'invio dei messaggi.
Per risolvere questo problema, devi aggiornare le autorizzazioni del canale sulla nostra piattaforma utilizzando le tue credenziali Facebook aggiornate. Per questo processo è richiesto il ruolo di amministratore. Aggiornando le autorizzazioni, ristabilirai la connessione con le nuove credenziali, assicurando che i tuoi messaggi in uscita vengano inviati con successo senza errori.
Come rimuovo WhatsApp Cloud API da respond.io?
Per interrompere l'utilizzo di WhatsApp Cloud API con respond.io, segui questi passaggi:
Passaggio 1: Elimina il canale in respond.io
Vai su Impostazioni dello spazio di lavoro > Canali.
Seleziona il tuo canale WhatsApp Cloud API.
Elimina il canale.
Passaggio 2: Elimina il numero di telefono da WhatsApp Manager
Vai a Meta Business Manager.
Vai a WhatsApp Manager > Numeri di telefono.
Elimina il numero di telefono.
Cosa succede dopo aver rimosso WhatsApp Cloud API?
Respond.io smetterà di ricevere e inviare messaggi.
I Webhook collegati a respond.io smetteranno di funzionare.
Importante:
L'eliminazione del canale in respond.io non elimina automaticamente il numero dal tuo account Meta Business.
Se vuoi utilizzare nuovamente il numero nell'app WhatsApp Business, devi prima eliminarlo da Cloud API (come richiesto da Meta).
Se il numero continua a inviare messaggi tramite un'altra integrazione, potrebbero applicarsi le tariffe standard per conversazione di Meta.
