Configurare le chiamate WhatsApp
Invece di scrivere, i clienti possono toccare l'icona del telefono in WhatsApp. Con The-Y CRM queste chiamate arrivano nel tuo centralino come qualsiasi altra chiamata: menu vocale, gruppo, coda, segreteria. La chiamata compare direttamente nella conversazione WhatsApp del contatto. E puoi richiamare via WhatsApp, se il cliente lo ha permesso. Le chiamate WhatsApp in arrivo non costano nulla presso Meta; se richiami via WhatsApp, Meta addebita al minuto, a seconda del Paese (listino di Meta). Dalla versione 1.1.45.
1. Cosa succede in una chiamata WhatsApp
- Il cliente tocca in WhatsApp il pulsante di chiamata del tuo numero.
- Squilla nel tuo browser (softphone) e sul tuo telefono da scrivania. Il softphone mostra “WhatsApp call” con il nome.
- Il centralino risponde subito. Poi segue il tuo percorso di chiamata: menu vocale, chiamata di gruppo, coda, orari di apertura, segreteria.
- Attesa, parcheggio e trasferimento interno funzionano come per qualsiasi chiamata.
- Le chiamate WhatsApp in arrivo non costano nulla presso Meta.
- Le chiamate WhatsApp contano nel limite di chiamate contemporanee (Free 2, Cloud Pro 10). Oltre il limite chi chiama sente l'annuncio che tutte le linee sono occupate. Nell'elenco chiamate compare allora “rejected – limit”.
2. Cosa richiede Meta: controlla prima
Queste condizioni le stabilisce Meta. Nessun fornitore può aggirarle.
| Condizione | Cosa significa |
|---|---|
| Numero usato solo per il CRM | Se il numero è attivo anche nell'app WhatsApp Business su un telefono, Meta non supporta le chiamate tramite il CRM: continuano a squillare solo sul telefono. Per le chiamate nel CRM ti serve un numero che funzioni solo tramite il CRM. |
| Limite di messaggi di almeno 2.000 | Meta attiva le chiamate solo a partire da un limite di messaggi di 2.000. Una nuova azienda su Meta parte da 250; dal 7 ott 2025 tutti i numeri dell'azienda condividono questo limite. La via più rapida: fai verificare la tua azienda da Meta. Senza verifica: consegna entro 30 giorni 2.000 messaggi modello di alta qualità, fuori dalla finestra di 24 ore e a numeri diversi; Meta poi valuta e alza il limite a 2.000 (aggiornato al 12 nov 2026, fonti: chiamate · limiti · modifica 2025). |
| Metodo di pagamento presso Meta | Sull'account WhatsApp deve essere impostato un metodo di pagamento, anche per le chiamate in arrivo gratuite. Senza, Meta rifiuta ogni chiamata. |
| WhatsApp su un telefono | I clienti possono chiamare solo dall'app WhatsApp su un telefono, non da WhatsApp Web o dal computer. |
3. Attivare le chiamate (3 passaggi)
- Apri Settings → Channels e clicca “Edit” sul tuo numero nell'elenco “Connected” (finché manca qualcosa c'è scritto “Configure”). Si apre la finestra del numero.
- Nella scheda “WhatsApp calls” attiva “Accept calls” e conferma con “Turn on”. Lo stato diventa “Active: customers can call you via WhatsApp.”
- In Settings → Phone → Provider & numbers → Numbers → “WhatsApp numbers” scegli dove parte la chiamata (sezione 4).
“Show call button in WhatsApp” nasconde o mostra l'icona del telefono. Senza il pulsante i clienti non possono chiamarti di loro iniziativa.
4. Dove va la chiamata
In Settings → Phone → Provider & numbers → Numbers → “WhatsApp numbers” imposti per ogni numero WhatsApp:
- Call starts at: menu vocale, chiamata di gruppo, coda, interno, orari di apertura, annuncio o segreteria. “Automatic” significa: come il numero di telefono in cima al tuo elenco, altrimenti il primo menu o il primo interno.
- Fallback instead of forwarding outside: vale quando il tuo percorso di chiamata porta più avanti a un numero esterno (sezione 5). “Automatic” significa: la prima casella di segreteria, altrimenti la chiamata viene chiusa.
Lascia disattivati gli orari di chiamata di Meta: fuori da quegli orari nessuno può chiamare, nemmeno per arrivare alla segreteria. Gli orari di apertura del tuo centralino lo gestiscono meglio. La scheda ti avvisa se presso Meta sono impostati degli orari di chiamata.
5. Nessun inoltro verso la rete telefonica
Meta non consente di inoltrare una chiamata WhatsApp alla rete fissa o mobile, in nessun momento della chiamata. Per questo è il centralino stesso a bloccarlo:
- Se il tuo percorso di chiamata porta a un numero esterno (per esempio tasto del menu → cellulare, overflow, riserva dell'interno), chi chiama sente un breve annuncio e poi passa alla destinazione di riserva.
- Nella vista del percorso questi punti sono segnati in rosso: “Forward to … – blocked for WhatsApp calls”.
- Per le chiamate WhatsApp il softphone non propone numeri esterni come destinazione di trasferimento.
Le telefonate normali non sono interessate. Puoi comunque rispondere anche quando sei fuori: con il softphone nell'app sul tuo telefono, che passa da internet ed è consentito (vedi Installare l'app).
6. La chiamata nella conversazione WhatsApp
- Ogni chiamata WhatsApp è una riga nella conversazione con il contatto, proprio come nell'app WhatsApp: “📞 WhatsApp call (incoming)” con l'esito.
- Esiti possibili: risposta (con durata), persa, messaggio in segreteria, riagganciato nel menu, non raggiunto.
- Un messaggio in segreteria viene aggiunto sotto come audio; una registrazione viene allegata alla riga.
- Una chiamata persa avvisa la persona assegnata alla conversazione, altrimenti il team.
- Una chiamata apre la finestra di 24 ore di WhatsApp: puoi scrivere subito, senza modello.
- “Premi 1 per WhatsApp” invia a chi chiama via WhatsApp un messaggio normale (“Grazie per la Sua chiamata! Scriva pure qui la Sua richiesta …”) invece di un modello.
- Se qualcuno chiama con numero nascosto, viene mostrato il suo nome utente WhatsApp.
Nell'elenco chiamate le chiamate WhatsApp hanno l'etichetta “WhatsApp”; il filtro “Via WhatsApp” mostra solo quelle. Nei flussi, i trigger “Call ended” e “Key pressed in voice menu” hanno la condizione “Network: phone / WhatsApp”, per esempio per creare un'attività dopo una chiamata WhatsApp persa.
7. Richiamare via WhatsApp
- Nella scheda attiva “Allow outgoing WhatsApp calls” (conferma la nota sui costi).
- Nella conversazione WhatsApp clicca “WhatsApp call”, poi “Call now”. Il pulsante c'è anche sul contatto e sulle chiamate WhatsApp nell'elenco chiamate.
- Prima squilla il tuo telefono. Quando rispondi, il centralino chiama il cliente via WhatsApp.
Puoi chiamare solo i clienti che lo hanno permesso:
- Automaticamente: chi ti chiama via WhatsApp ti permette di richiamarlo per 7 giorni.
- Su richiesta: “Ask for call permission” invia “Possiamo chiamarLa via WhatsApp? Così possiamo occuparci più in fretta della Sua richiesta. Decide Lei e può cambiare idea in qualsiasi momento.” Il cliente sceglie se permetterlo temporaneamente (7 giorni) o in modo permanente, oppure rifiuta. La risposta compare come nota nella conversazione.
- Dentro la finestra di 24 ore aperta, la richiesta parte come messaggio normale. Dopo serve il modello approvato “May we call you?”: scheda “WhatsApp calls” → “Submit template to Meta”. Meta lo verifica come qualsiasi altro modello.
Per richiamare ti serve un tuo interno. Alla prima chiamata il cliente potrebbe vedere solo il tuo numero invece del nome dell'azienda.
8. Costi
| Cosa | Costo presso Meta |
|---|---|
| Chiamata WhatsApp in arrivo | gratis |
| Chiamata WhatsApp in uscita | al minuto, a seconda del Paese; più conveniente da 50.000 minuti al mese. Addebito a scatti di 6 secondi (listino di Meta) |
| Richiesta di permesso dentro la finestra di 24 ore | come una normale risposta (le prime 1.000 per numero e mese sono gratuite) |
| Richiesta di permesso tramite modello | come un modello utility nel Paese del cliente |
Meta ti addebita direttamente tramite il metodo di pagamento del tuo account WhatsApp. The-Y CRM non fa pagare nulla per questo. La panoramica dei costi nel CRM stima le chiamate in uscita al prezzo di listino di Meta. In Free le chiamate WhatsApp in uscita contano nei 200 minuti di chiamate in uscita al mese. Tutti gli altri costi: pagina dei costi.
9. Cosa significa lo stato nella scheda
| Stato | Cosa puoi fare |
|---|---|
| “Active: customers can call you via WhatsApp.” (attivo: i clienti possono chiamarti via WhatsApp) | Niente. |
| “Possible, not turned on yet.” (possibile, non ancora attivato) | Attiva “Accept calls”. |
| “Not possible: the number also runs in the WhatsApp Business app.” (non possibile: il numero è attivo anche nell'app WhatsApp Business) | Usa un numero solo per il CRM (sezione 2). |
| “Messaging limit below 2,000.” (limite di messaggi sotto 2.000) | Fai verificare la tua azienda da Meta o aspetta che Meta alzi il limite. |
| “Payment method at Meta is missing.” (manca il metodo di pagamento presso Meta) | “Open payment method at Meta” e aggiungine uno. |
| “Not possible: another provider handles calls at Meta.” (non possibile: presso Meta le chiamate le gestisce un altro fornitore) | In Meta Business Suite, nello smistamento delle conversazioni, assegna le chiamate a The-Y CRM (vedi Agente IA di Meta). |
| “Blocked by Meta until …” (bloccato da Meta fino al …) | Meta toglie il blocco da sola. Causa: molti clienti hanno bloccato o segnalato il numero, oppure troppe chiamate sono rimaste senza risposta. |
| “Turned on, but calls do not reach the phone system.” (attivato, ma le chiamate non arrivano al centralino) | Clicca “Check”. Se resta così, contatta l'assistenza. |
| “Call events from Meta are missing” (mancano gli eventi di chiamata da Meta; solo per gli admin) | L'inizio e la fine delle chiamate WhatsApp non arrivano al CRM. Self-hosted con la tua app Meta: clicca una volta “Subscribe webhooks” nell'hub. Su crm.the-y.at basta avvisarci. Lo stato viene riletto al massimo una volta all'ora. |
| “Not possible: this installation is not set up for WhatsApp calls.” (non possibile: questa installazione non è configurata per le chiamate WhatsApp) | Solo per installazioni self-hosted: sezione 11. |
10. Registrazioni: informa i tuoi clienti
Un tasto del menu con registrazione registra anche le chiamate WhatsApp. Dalla versione 1.1.46 chi chiama sente prima un avviso, attivo fin dall'inizio. Dalla 1.1.51 l'avviso “Questa chiamata viene registrata” lo registri tu (nel browser o come file audio); senza una tua registrazione chi chiama sente solo un segnale acustico. Lo fai in Settings → Phone → Overview → “More phone system settings” → “Notice before a recording” (guida). Finché manca il tuo avviso, la registrazione parte comunque e l'app mostra un avvertimento chiaro. Se disattivi l'avviso, dillo tu nell'annuncio del menu, per esempio “Questa chiamata viene registrata a scopo di formazione.” Questa frase da sola non basta dal punto di vista legale: prima devono essere chiari lo scopo e la base giuridica, e chi chiama deve ricevere le informazioni sulla privacy previste dall'art. 13 del GDPR. Se ti serve il consenso e come informare le persone, verificalo con un esperto (questa non è una consulenza legale). Cosa tratta The-Y CRM per le chiamate WhatsApp è descritto nella nostra informativa sulla privacy (sezione “Data from Meta platforms”) e nel DPA (accordo sul trattamento dei dati).
11. Self-hosted
Senza configurazione le chiamate WhatsApp restano disattivate: con l'aggiornamento non cambia nient'altro. Per le chiamate WhatsApp ti servono:
- un nome pubblico per il centralino (per esempio
sip.your-domain.tld) con un certificato valido di un'autorità di certificazione pubblica (per esempio Let's Encrypt). Meta controlla il certificato: se non è valido o è scaduto, Meta interrompe subito ogni chiamata. - nel
.envdi app e worker:PBX_WA_SIP_HOSTe, se vuoi,PBX_WA_SIP_PORT(predefinito 5071). Certificato e chiave nel container Asterisk in/etc/asterisk/certs/wa-sip.crtewa-sip.key(si cambiano conPBX_WA_TLS_CERT/PBX_WA_TLS_KEY).PBX_WA_PUBLIC_ADDRsolo dietro NAT. Facoltativo:PBX_WA_TLS_CERT_LOCAL(percorso in cui il worker vede il certificato), così di notte ricarica da solo un certificato rinnovato. - Asterisk 22.5 o successivo con
res_srtp; monta la cartellapbx/asterisk/certsin sola lettura nel container Asterisk. - nel firewall, porta 5071/tcp aperta solo per gli intervalli IP di Meta (elenco nella guida SIP di Meta); apri l'intervallo RTP 10000–20000/udp e impostalo in
rtp.conf; gli intervalli IP di Meta nelignoreipdi fail2ban. - l'account AMI con
write = system,call,originate. - con la tua app Meta: clicca una volta “Subscribe webhooks” nell'hub (nuovi:
calls,account_settings_update); l'app deve essere in modalità “Live”. Se mancacalls, la scheda mostra “Call events from Meta are missing”. - dalla 1.1.46: senza una chiave a pagamento sono possibili 2 chiamate contemporanee, chiamate WhatsApp comprese. Maggiori dettagli in Self-hosting → centralino.
Ordine per l'aggiornamento manuale: prima l'app (aggiorna il database), poi il worker. Per la gestione: guida al self-hosting.
Domande frequenti
Perché non riesco ad attivare “Accept calls”?
La scheda indica il motivo. I più frequenti: il numero è attivo anche nell'app WhatsApp Business, oppure il limite di messaggi è sotto 2.000.
I miei clienti non vedono il pulsante di chiamata.
Ad alcuni clienti Meta mostra le modifiche solo dopo un massimo di 7 giorni. Con “Chat info” nella chat il pulsante compare subito. Controlla anche “Show call button in WhatsApp”. Se Meta ha nascosto il pulsante per via di molte chiamate senza risposta, la scheda lo segnala.
Posso inoltrare le chiamate WhatsApp al mio cellulare?
Non tramite la rete telefonica: Meta lo vieta. Rispondi con il softphone nell'app sul tuo telefono.
Posso chiamare o ricevere chiamate da WhatsApp Web?
No. Meta supporta le chiamate WhatsApp con le aziende solo su WhatsApp da telefono.
Quanto mi costa una chiamata WhatsApp?
In arrivo niente. In uscita al minuto, a seconda del Paese, da pagare a Meta (sezione 8).
