Chiamate WhatsApp Business

Chiamate WhatsApp Business

Collega il tuo WhatsApp Business Account (WABA) a Finn così gli utenti possono chiamare la tua azienda direttamente da WhatsApp — con risposta di un agente Finn e fatturazione al minuto come per qualsiasi altra chiamata.

WhatsApp Business Calling (la superficie voce su WhatsApp di Meta, lanciata nel 2024) si appoggia alla Cloud API. Per l'utente è un tocco sul pulsante di chiamata nella chat con la tua azienda. Per te è una normale chiamata in entrata su Finn.

Cosa ottieni

• Voce in entrata da qualsiasi utente WhatsApp nel mondo
• Nessun nuovo numero da attivare — usa l'ID del numero di telefono del tuo WABA
• Risponde un agente Finn con lo stesso prompt, la stessa voce e lo stesso workflow delle chiamate in entrata abituali
• Registrazione, trascrizione e analisi identiche alle chiamate in entrata PSTN
• Costo al minuto inferiore rispetto alle chiamate PSTN internazionali in entrata in molte aree

Prerequisiti

Prima di poter effettuare il collegamento:

1. Un Meta Business Account verificato con la WhatsApp Business Platform abilitata
2. Un numero WABA in regola (non l'app WhatsApp per consumatori — il numero della Cloud API)
3. Verifica aziendale approvata da Meta (obbligatoria per le chiamate)
4. Un'organizzazione Finn su piano Pro o superiore (Starter non include le chiamate WhatsApp)
5. La funzionalità Calling API esplicitamente abilitata nel tuo WABA — Meta ne limita l'accesso. Richiedilo in Meta Business → WhatsApp Manager → API Settings → Calling

Configurazione (5 passaggi)

1. Abilitare le chiamate nel WABA

In Meta Business Suite → WhatsApp Manager → Phone Numbers → [il tuo numero] → Settings → Calling:

• Imposta Enable inbound calling su On
• Imposta Default action su Forward to API
• Salva

2. Generare un token di accesso permanente per l'utente di sistema

In Meta Business → Business Settings → System Users:

• Crea un utente di sistema (o riutilizzane uno)
• Genera un token con gli scope: whatsapp_business_management, whatsapp_business_messaging
• Tratta il token come una password — non inserirlo mai nel codice, ruotalo ogni trimestre

3. Collegare in Finn

Dashboard → Impostazioni → Integrazioni → WhatsApp → Connetti.

Incolla:

• phone_number_id (da WhatsApp Manager)
• waba_id (l'ID del WhatsApp Business Account)
• Token di accesso dell'utente di sistema

Finn convalida il token chiamando /v18.0/{phone_number_id} e mostra lo stato in linea.

4. Associare un agente Finn

Nella stessa schermata, scegli quale Finn risponde alle chiamate WhatsApp. Puoi:

• Assegnare un solo agente a tutte le chiamate WhatsApp in entrata — la soluzione più semplice
• Instrada dinamicamente tramite il webhook in entrata — agenti diversi per chiamante, paese o tag campagna

5. Test

Invia un messaggio di prova su WhatsApp al tuo numero WABA da un account personale, poi tocca il pulsante di chiamata. L'agente Finn dovrebbe rispondere in 2–3 secondi.

Se la chiamata cade subito, la capacità di chiamata non è del tutto approvata — controlla il banner di abilitazione alle chiamate di Meta in WhatsApp Manager.

Comportamento rispetto alle chiamate in entrata PSTN

Identificazione del chiamante

Il payload del webhook in entrata include campi specifici di WhatsApp:

{
  "session_id": "ws_2H4abc",
  "channel": "whatsapp",
  "from": {
    "wa_id": "919876543210",
    "display_name": "Priya M",
    "profile_pic_url": "https://..."
  },
  "to_phone_number_id": "104382715924563",
  "started_at": "2026-05-22T14:30:00Z"
}

wa_id è l'identificativo WhatsApp del chiamante (in genere il suo numero in formato E.164 senza il +). Usalo come chiave di ricerca nel tuo CRM allo stesso modo in cui useresti caller_id per il PSTN.

Prezzi

Le chiamate in entrata da WhatsApp sono fatturate con lo stesso modello a crediti AI di Finn delle chiamate in entrata PSTN:

• Chiamata risposta: fatturazione a impulsi al minuto, minimo 1 min
• Nessun sovrapprezzo operatore — Meta gestisce la tratta di rete
• Nessun costo di attivazione per chiamata

Vedi Wallet e crediti AI per la formula completa di fatturazione a impulsi.

Limitazioni

• Solo in entrata (restrizione Meta dal 2026). Non è possibile chiamare gli utenti WhatsApp da Finn.
• Un solo Finn per ID numero di telefono alla volta — anche se l'instradamento dinamico tramite il webhook in entrata consente di cambiare agente a ogni chiamata.
• Segreteria telefonica non ancora supportata — le chiamate perse cadono senza lasciare messaggio.
• La disponibilità varia per regione — Meta sta ancora distribuendo Calling paese per paese. Verifica il tuo stato in WhatsApp Manager → API Settings.

Conformità

• Comunicazione della registrazione — valgono le stesse regole del PSTN. India, UE e alcuni stati USA richiedono di comunicare che la chiamata è registrata. Configura il messaggio di benvenuto di Finn in modo che includa la comunicazione.
• Consenso — toccando il pulsante di chiamata in WhatsApp l'utente ha avviato la chiamata: per quella sessione il consenso esplicito è implicito. Serve comunque un consenso separato per richiamarlo via PSTN.
• Residenza dei dati — Meta elabora l'audio nella propria regione. Se la tua organizzazione ha requisiti stringenti di residenza, valuta prima di attivare.

FAQ

D: Il mio agente Finn esistente può rispondere alle chiamate WhatsApp senza modifiche? R: Sì. Prompt, voce e workflow dell'agente restano gli stessi. Basta associarlo nella schermata di integrazione WhatsApp.

D: Chi chiama da WhatsApp vede che sta parlando con un'AI? R: L'identità del tuo Finn è quella che hai configurato (es. "Aria di Smile Dental"). Se richiesto direttamente, l'agente deve dichiarare di essere un'AI — stessa regola di conformità del PSTN.

D: Posso instradare le chiamate WhatsApp a un operatore umano? R: Sì — il meccanismo di trasferimento assistito di Finn funziona allo stesso modo. La chiamata trasferita arriva su un numero PSTN configurato.

D: In cosa differisce dai link click-to-call di WhatsApp? R: Il click-to-call apre il dialer del telefono dell'utente con un numero PSTN. WhatsApp Business Calling resta dentro l'app WhatsApp e usa l'infrastruttura voce di Meta — superficie completamente diversa.

Risoluzione dei problemi

Correlati

• Numeri di telefono →
• Webhook in entrata →
• Webhook post-chiamata →
• Conformità →
• Wallet e crediti AI →