Salta al contenuto principale
Torna al blog
Prodotto2 ottobre 2026·6 min di lettura

API di WhatsApp Business: un bot che vede foto e ascolta vocali

API di WhatsApp Business: un bot che vede foto e ascolta vocali

Guarda gli ultimi 20 messaggi di manutenzione che i tuoi inquilini hanno inviato su WhatsApp. Molti non contengono testo: una foto di un sifone che perde, un vocale di 40 secondi, un video di una lavatrice che non scarica. Un assistente che legge solo testo risponde "Puoi descrivere il problema?", e qualcuno del tuo team finisce per ascoltare l'audio, ricopiarlo in un ticket e inoltrare la foto a mano. Collegare il tuo numero all'API di WhatsApp Business ufficiale cambia le cose.

Con la Official WhatsApp Business Connection, il tuo numero funziona sulla piattaforma ufficiale WhatsApp Business di Meta, senza codice QR né telefono collegato da tenere acceso, e l'assistente che ci sta dietro vede le foto e ascolta i vocali. Fa parte degli strumenti di comunicazione con gli inquilini di Vivin per operatori di coliving, studentati e affitti di media durata.

Perché un chatbot WhatsApp solo testo frustra gli inquilini

  • Vocali - qualcuno ascolta, capisce la richiesta e scrive il ticket: 3-5 minuti ciascuno
  • Foto - scaricate dalla chat e allegate al ticket a mano
  • Botta e risposta - il bot chiede all'inquilino di descrivere ciò che la foto mostra già
  • Una linea fragile - una sessione collegata via QR si ammutolisce quando lo fa il telefono collegato, e nessuno se ne accorge finché un inquilino non si lamenta

Su un portafoglio di 150 stanze con circa 60 messaggi con foto o voce al mese, sono facilmente 3-5 ore ad ascoltare, ricopiare e inoltrare, mentre gli inquilini aspettano una persona.

Come collegare l'API di WhatsApp Business in Vivin

1. Collega il tuo numero dalle impostazioni

Vai in Settings > ChatBot > Connections e, nella scheda del collegamento WhatsApp, clicca su Connect WhatsApp Business. Vivin chiede prima "Which number should Vivin answer on?": un numero nuovo, oppure quello che usi già nell'app WhatsApp Business. Si apre poi una finestra di Meta in cui scegli o crei il portfolio aziendale e l'account WhatsApp Business, confermi il numero e completi la verifica richiesta da Meta. Tienila aperta finché non si chiude da sola: in quel momento il collegamento è fatto.

La scheda mostra quindi "Connected through the official WhatsApp Business Platform (Cloud API)", con il numero e il nome aziendale verificato.

API di WhatsApp Business in Vivin: la scheda WhatsApp connection con il pulsante Connect WhatsApp Business
Settings > ChatBot > Connections: collega il tuo numero tramite la piattaforma ufficiale WhatsApp Business.

2. Continua a usare l'app WhatsApp Business sul telefono

Se scegli il numero che usi già, resta attivo nell'app WhatsApp Business e Vivin risponde anche lì. Le conversazioni precedenti restano sul telefono; Vivin mostra i messaggi dal momento del collegamento. Tutto ciò che il tuo team scrive nell'app compare anche in Vivin, segnato come "Sent from the WhatsApp Business app".

Un chatbot WhatsApp può capire foto e vocali?

3. L'assistente vede le foto

Quando un inquilino invia una foto, l'assistente riceve l'immagine con il messaggio, quindi distingue un rubinetto che gocciola da un tubo scoppiato e fa una domanda utile invece di una generica. Quando apre un ticket di manutenzione, le foto, i video e i file inviati dall'inquilino finiscono sul ticket, e il tecnico vede il problema prima di arrivare.

4. L'assistente ascolta i vocali

I vocali vengono trascritti e l'assistente risponde a ciò che l'inquilino ha detto davvero. Se un vocale è ancora in trascrizione quando arriva il messaggio successivo, lo aspetta invece di rispondere a metà storia.

5. Il tuo team vede gli stessi file

Nella inbox WhatsApp condivisa, un vocale si ascolta in un player in stile WhatsApp, con velocità di riproduzione e la sua Transcript subito sotto, così leggi in dieci secondi un messaggio di due minuti. Le foto si aprono sul posto a grandezza piena, con "Open original" per il file; i video si riproducono nella chat e i documenti si scaricano con un clic.

Come il team prende il posto del bot

6. Pause bot e la hand-off window

Ogni conversazione ha un interruttore Pause bot. In Settings > ChatBot > General puoi anche impostare una Hand-off window: i minuti in cui l'assistente resta in silenzio dopo la risposta di un membro del team, che arrivi da Vivin o dall'app WhatsApp Business. L'interruttore si spiega da solo, per esempio "Paused automatically until 14:30 because your team replied", e ogni nuova risposta lo prolunga. Con la finestra a 0 la pausa automatica è disattivata.

7. Avvisi prima che la linea si ammutolisca

Poiché il collegamento è ufficiale, la scheda avvisa quando Meta abbassa la valutazione di qualità del numero, quando l'autorizzazione sta per scadere o quando il numero richiede un Reconnect WhatsApp.

API di WhatsApp Business vs bot collegato via QR: i numeri

Stime per un portafoglio di 150 stanze con circa 60 messaggi con foto o voce al mese:

Attività Bot solo testo, via QR Collegamento ufficiale
Trasformare un vocale in un ticket 3-5 min a mano Circa 30 s per controllare
Mettere una foto sul ticket 1-2 min a mano Allegata dall'assistente
Prima risposta utile all'inquilino Quando qualcuno è libero Secondi
Bot muto perché il telefono collegato è offline Possibile Nessun telefono collegato
Tempo del team al mese su messaggi con foto e voce 3-5 ore Meno di 1 ora

Come una richiesta di manutenzione passa da WhatsApp a un ticket

Il vocale a tarda notte

Un inquilino registra 50 secondi sull'acqua che esce da sotto il piatto doccia. L'assistente lavora sulla trascrizione, chiede una foto del pavimento, apre un ticket di manutenzione con entrambi allegati e conferma che è stato registrato. Il ticket segue poi il tuo processo abituale (vedi come gestire le richieste di manutenzione su larga scala).

Configurare l'API di WhatsApp Business, passo dopo passo

  1. Apri Settings > ChatBot > Connections.
  2. Clicca su Connect WhatsApp Business e scegli un numero nuovo o quello che usi già nell'app WhatsApp Business.
  3. Completa i passaggi nella finestra di Meta e tienila aperta finché non si chiude da sola (consenti i pop-up se il browser la blocca).
  4. Verifica che la scheda mostri il tuo numero come collegato, poi invia una foto e un vocale di prova da un telefono di test.
  5. Imposta la Hand-off window in Settings > ChatBot > General se l'assistente deve farsi da parte quando risponde il tuo team.

Domande frequenti

Che cos'è l'API di WhatsApp Business?

È il canale ufficiale di Meta con cui le aziende inviano e ricevono messaggi WhatsApp tramite un software, chiamato anche WhatsApp Business Platform o Cloud API. Invece di un telefono collegato con codice QR, il tuo numero si collega a Vivin direttamente tramite Meta, e il bot continua a rispondere che ci sia o no un telefono acceso.

Posso continuare a usare l'app WhatsApp Business sul telefono?

Sì. Quando colleghi, scegli "The number I already use in the WhatsApp Business app". Il numero resta attivo sul telefono e Vivin risponde anche lì. I messaggi che il team scrive nell'app compaiono in Vivin segnati come inviati dall'app, così tutti vedono la conversazione completa.

Cosa succede alla mia linea WhatsApp attuale con codice QR?

Vivin te lo dice prima di iniziare: il collegamento sposta il bot che risponde ai tuoi inquilini sul numero ufficiale, e il collegamento con codice QR viene spento non appena quello ufficiale è pronto. Per mantenere lo stesso numero, scegli l'opzione del numero che usi già nell'app WhatsApp Business.

Il bot si ferma quando risponde un membro del team?

Decidi tu. Ogni conversazione ha un interruttore Pause bot, e la Hand-off window in Settings > ChatBot > General stabilisce per quanti minuti l'assistente resta in silenzio dopo la risposta di un membro del team, da Vivin o dall'app WhatsApp Business. Ogni nuova risposta prolunga la pausa, e una finestra di 0 la disattiva.

Gli inquilini parlano per foto e vocali. Ora il tuo assistente guarda e ascolta, sul tuo numero ufficiale. Prenota una demo per vederlo in una conversazione reale.