Skip to main content

Chiamate WhatsApp Business

Accetta le chiamate vocali WhatsApp in un agente Finn.

6 min read

WhatsApp Business Calling

Collegare il vostro WhatsApp Business Account (WABA) a Finn in modo che gli utenti possono inserire chiamate vocali al vostro business direttamente all'interno di WhatsApp — risposto da un agente Finn, fatturato per minuto come qualsiasi altra chiamata.

WhatsApp Business Calling (la superficie voce-over-WhatsApp di Meta, lanciata 2024) si trova in cima al Cloud API. Dal lato dell'utente è un tap sul pulsante di chiamata all'interno della chat di affari. Dal vostro lato è una normale chiamata in entrata Finn.


Che cosa si ottiene

  • ** Voce in arrivo da qualsiasi utente WhatsApp** in tutto il mondo
  • Nessun nuovo numero a disposizione — utilizza il tuo ID numero di telefono WABA esistente
  • l'agente diFinn risponde con lo stesso prompt, voce e flusso di lavoro come il vostro inbound regolare
  • Recording + transcript + analytics identico a PSTN inbound
  • Costo inferiore al minuto rispetto all'ingresso internazionale PSTN in molte regioni

Prerequisiti

Prima di poter connettersi:

  1. Un account Meta Business verificato** con la piattaforma Business WhatsApp abilitata
  2. Un numero di telefono WABA in buona posizione (non l'app consumer WhatsApp — il numero Cloud API)
  3. ** Verifica aziendale** approvata da Meta (richiesto per la chiamata)
  4. A Finn org su Pro o superiore (Starter non include WhatsApp call)
  5. La capacità Calling API esplicitamente abilitata nel vostro WABA — Meta gates questo. Richiedi l'accesso in Meta Business → WhatsApp Manager → Impostazioni API → Calling

Setup (5 passi)

1. Attiva chiamata in WABA

In Meta Business Suite → WhatsApp Manager → Numeri telefonici → [il tuo numero] → Impostazioni → Chiamata:

  • Abilita' in entrata a chiamare..
  • Impostare l'azione di default ** per ** Verso API**
  • Salva

2. Generare un token di accesso permanente dell'utente del sistema

In Meta Business → Impostazioni aziendali → Utenti di sistema:

  • Creare un utente di sistema (o riutilizzarne uno)
  • Generare un token con scopi: whatsapp_business_management, whatsapp_business_messaging
  • Trattare il token come una password — mai commettere, ruotare trimestrale

3. Collegare dentro Finn

Dashboard → Impostazioni → Integrazioni → WhatsApp → Connect.

Paste:

  • phone_number_id (da WhatsApp Manager)
  • waba_id (il WhatsApp Business Account ID)
  • Sistema di accesso utente token

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

4. Bind a Finn agente

Nella stessa schermata, scegliere quale Finn risponde alle chiamate WhatsApp. Potete:

  • Pin one agent for all WhatsApp inbound — più semplice
  • Route dinamicamente tramite il tag inbound webhook — diversi agenti per caller, country o campagna

5. Test

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

Se la chiamata cade immediatamente, la capacità di chiamata non è completamente approvata — controllare il banner di Meta di attivazione chiamata in WhatsApp Manager.


Comportamento rispetto a PSTN inbound

| Aspect | PSTN inbound | WhatsApp inbound | Traduzione: | Tempo di configurazione | 5 min (numero di affitto) | 30–60 min (approvazione Meta) | | Caller ID | Telefono | WhatsApp user ID + nome del display | | Costo internazionale | Varies (alto paese esterno) | Flat — Meta handles routing | | Registrazione | Standard | Standard (Notifica chiamante per legge locale) | | Voicemail | Configurable | Non ancora — Meta caps | | Outbound from Finn | Yes (full PSTN) | No — chiamare è inbound-only via WhatsApp | | Tappi concorrenti | Capacità per numero | Legato al livello WABA |


Identificazione delle chiamate

Il payload 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'identificatore WhatsApp del chiamante (tipicamente il loro numero di telefono in E.164 meno il +). Usalo come la chiave di ricerca contro il tuo CRM nello stesso modo in cui useresti caller_id per PSTN.


Prezzi

WhatsApp inbound è fatturato sullo stesso modello Finn AI-credit come PSTN inbound:

  • Picked-up call: pulsato al minuto, minimo 1 minuto
  • Nessun sovrapprezzo del vettore — Meta gestisce la gamba di rete
  • ** Nessuna tassa di configurazione per chiamata **

Vedere Wallet & AI Credits per la formula full impulso-billing.


Limitazioni

  • ** Solo in entrata ** (Meta restrizione del 2026). Non è possibile comporre utenti WhatsApp da Finn.
  • Un Finn per telefono-numero ID alla volta — anche se routing dinamico tramite il inbound webhook consente di commutare gli agenti per chiamata.
  • Voicemail non ancora supportato — mancate chiamate drop senza un messaggio.
  • La disponibilità delle regioni varia — Meta sta ancora rotolando Chiamando fuori per paese. Controlla WhatsApp Manager → Impostazioni API per il tuo stato.

Compliance

  • Registrazione — le stesse regole si applicano come PSTN. India, UE, parti degli Stati Uniti richiedono la divulgazione della chiamata è registrata. Configurare il messaggio di benvenuto di Finn per includere la divulgazione.
  • Consent — toccando il pulsante di chiamata in WhatsApp, l'utente ha avviato la chiamata — il consenso espresso è implicito per tale sessione. Hai ancora bisogno di un consenso separato per richiamarli via PSTN.
  • Data residency — Meta elabora l'audio nella loro regione. Se il vostro org ha requisiti di residenza rigorosi, valutare prima di abilitare.

FAQ

Q: Il mio agente Finn esistente risponde alle chiamate WhatsApp senza modifiche? A: Sì. Il prompt dell'agente, la voce e il flusso di lavoro sono gli stessi. Basta legarlo nella schermata di integrazione WhatsApp.

Q: I chiamanti WhatsApp vedono che stanno parlando con l'AI? A: L'identità del tuo Finn è ciò che hai configurato (ad esempio "Aria da Smile Dental"). Se richiesto direttamente, l'agente dovrebbe rivelare lo stato AI — stessa regola di conformità di PSTN.

Q: Posso indirizzare WhatsApp chiama ad un agente umano? A: Sì — Il meccanismo di trasferimento caldo di Finn funziona allo stesso modo. La chiamata trasferita atterra su un numero PSTN configurato.

Q: Come differisce da WhatsApp link click-to-call? A: Click-to-call apre il quadrante del telefono dell'utente con un numero PSTN. WhatsApp Business Calling rimane all'interno dell'app WhatsApp e cavalca la voce infra di Meta — superficie completamente diversa.


Risoluzione dei problemi

| Sintomo | Causa giustamente | Traduzione: | "Chiamare non abilitato" banner | Meta non ha approvato la chiamata per questo WABA ancora | | Le chiamate cadono in 1–2 secondi | Token non valido o portata mancante — ristampa | | Qualità audio povera in regioni specifiche | Meta sta ancora rotolando Chiamare fuori — controllare lo stato pagina | | Caller sente "questo numero non è configurato" | phone_number_id errore tra WhatsApp Manager e Finn | | Registrazione mancante | recording_enabled flag off on the bound Finn — toggle in agent settings |


Correlati

Was this page helpful?

Still stuck or have feedback?

Email [email protected] or use the chat bubble in the bottom-right corner — it's a Finn that knows the Academy cold.