In Turchia, quando un cliente vuole contattarla, l'app che apre per prima è molto probabilmente WhatsApp. Come trasformare allora questo canale, oggi legato a una persona che scrive dall'app verde sul telefono, in un sistema di assistenza clienti attivo 24/7, basato sull'AI e gestito dalla sua interfaccia? La risposta è la WhatsApp Business Cloud API, con dietro la Claude (Anthropic) API.

Questo articolo non si ferma alla superficie. Spieghiamo che cos'è davvero la «nuova API», perché quel numero non si può usare sul telefono, come costruire con i webhook la sua interfaccia WhatsApp e, dall'inizio alla fine, il tema più frainteso: i template di messaggio e la regola delle 24 ore. Mostriamo poi l'architettura con cui inserire Claude nel flusso per gestire un assistente di supporto autonomo.

Che cos'è esattamente la «nuova API»? La WhatsApp Business Cloud API

La prima fonte di confusione sono i nomi. In realtà esistono tre cose diverse:

  • WhatsApp (app personale): il normale WhatsApp sul telefono.
  • WhatsApp Business App: pensata per le piccole imprese, si gestisce comunque a mano dal telefono.
  • WhatsApp Business Platform (Cloud API): l'API programmatica ospitata nel cloud di Meta. È questa la «nuova API». Ha sostituito la vecchia On-Premises API, che andava ospitata in proprio: ora l'infrastruttura la gestisce Meta e a Lei basta collegarsi all'API.

La Cloud API consente a un software (il suo sistema) di inviare e ricevere messaggi su WhatsApp. In altre parole, a parlare non è una persona ma il codice. Da qui derivano sia la sua forza sia le sue regole.

Il punto critico: questo numero non si usa sul telefono

L'equivoco più comune: «Una volta collegata l'API, controllerò i messaggi anche da WhatsApp sul telefono». No. Quando registra un numero di telefono sulla Cloud API, quel numero non può più essere usato contemporaneamente nella normale app WhatsApp o in WhatsApp Business. Diventa un «numero API».

Per questo, in pratica, consigliamo di usare per la comunicazione con i clienti un numero separato, dedicato esclusivamente all'API. Se vuole continuare a usare a mano anche il suo attuale numero aziendale, non lo migri all'API: riservi una nuova linea. Così il sistema non si rompe per l'aspettativa di «controllare anche dal telefono».

Dove vedrà allora i messaggi? La risposta è nella prossima sezione: nella sua interfaccia.

Costruire la propria interfaccia WhatsApp con i webhook

La Cloud API funziona in due direzioni:

  • Messaggi in entrata: quando un cliente le scrive, Meta invia all'istante l'evento al suo server come HTTP POST tramite un webhook. Non deve andare a «prelevare» i messaggi: è Meta a inviarglieli. Sullo stesso canale arrivano le conferme di consegna e di lettura.
  • Messaggi in uscita: per rispondere, invia una richiesta all'endpoint /messages della Graph API di Meta (con l'ID del suo numero di telefono e un token di accesso).

Grazie a questi due flussi può costruire la sua interfaccia WhatsApp: intercetta ogni messaggio in entrata nel webhook, lo salva nel suo database (e nel suo CRM) e lo mostra come «posta in arrivo» nel suo pannello. Gli operatori rispondono da lì e la cronologia delle conversazioni si accumula nella scheda cliente. L'app verde non serve più. La verifica del webhook (verify token) e la convalida delle richieste in entrata tramite firma (app secret) sono i passaggi di sicurezza di base.

Template e regola delle 24 ore — il tema più frainteso

È qui che tutti si bloccano, quindi cerchiamo di essere precisi. Per impedire alle aziende di inviare spam alle persone, WhatsApp applica una regola rigorosa:

La finestra di assistenza clienti di 24 ore

Nel momento in cui un cliente le scrive, si apre una finestra di 24 ore. Al suo interno può inviare messaggi in formato libero (con il contenuto che preferisce), come in una normale chat. Ogni nuovo messaggio del cliente riporta la finestra a 24 ore.

Quando la finestra si chiude o non si è mai aperta: solo template approvati

Ed ecco la frase cruciale: tramite API non può inviare un messaggio in formato libero a chi non le ha mai scritto. Allo stesso modo, una volta chiusa la finestra di 24 ore, non può inviare testo libero. In entrambi i casi l'unica strada è inviare un template di messaggio preventivamente approvato da Meta.

Quindi, nello scenario «ho 5.000 numeri, mando una campagna a tutti», se quelle persone non le hanno mai scritto può raggiungerle solo con un template approvato e con il loro opt-in. I template passano dall'approvazione di Meta e si dividono in categorie:

  • Utility: messaggi transazionali come stato dell'ordine, promemoria degli appuntamenti, informazioni sulla spedizione.
  • Marketing: campagne, annunci, messaggi di riattivazione.
  • Authentication: messaggi con password monouso (OTP).

In sintesi, la logica è questa: se è il cliente ad avviare la conversazione → può conversare liberamente per 24 ore. Se vuole avviarla Lei → template approvato + opt-in sono obbligatori. Qualsiasi sistema costruito senza conoscere questa regola va a sbattere contro un muro alla prima campagna.

Nota: i prezzi di Meta per conversazioni e template dipendono dalla categoria e vengono aggiornati periodicamente. Prima di iniziare, verifichi i prezzi in vigore nella documentazione ufficiale di Meta.

Inserire la Claude API nel flusso: un programma di assistenza clienti autonomo

Ora viene la parte migliore. Il messaggio in entrata arriva al webhook, ma chi scrive la risposta? È qui che entra in gioco la Claude API. Il flusso è il seguente:

  • 1. Il cliente scrive su WhatsApp → Meta inoltra il messaggio al suo server tramite webhook.
  • 2. Il suo server (ad es. Laravel) riceve il messaggio e raccoglie la cronologia della conversazione e il contesto del cliente (dal CRM).
  • 3. Lei invia questo contesto, insieme a un system prompt, alla Messages API di Claude: «Sei l'assistente di supporto del brand X, rispetta queste regole, disponi di queste informazioni…»
  • 4. Claude genera una risposta. Se necessario, tramite il tool use accede ai dati reali del suo sistema: cerca un ordine, controlla le scorte, crea un appuntamento, avvia un reso.
  • 5. Se la finestra di 24 ore è aperta, Lei rimanda la risposta tramite la WhatsApp API come messaggio in formato libero. Se è chiusa, prosegue con un template adatto.

Con questa architettura il suo assistente smette di essere «un bot con risposte preconfezionate» e diventa un livello di supporto capace di ragionare e collegato ai dati della sua azienda. Grazie al tool use di Claude, a «dov'è il mio ordine?» risponde con lo stato reale della spedizione e a «c'è un appuntamento domani?» con il calendario reale. Con il prompt caching può mettere in cache il system prompt ripetuto e ridurre i costi; con le regole di human handoff indirizza i temi delicati a un operatore umano.

Che cosa si può realizzare?

  • Supporto di primo livello 24/7: risponde all'istante, anche a mezzanotte, su domande frequenti, tracciamento di ordini e spedizioni e procedura di reso.
  • Appuntamenti e prenotazioni: cliniche, parrucchieri, centri assistenza — il cliente prenota su WhatsApp e il sistema registra l'appuntamento in calendario.
  • Qualificazione dei lead: l'assistente approfondisce con alcune domande ogni richiesta in arrivo e passa alle vendite quelle qualificate.
  • Supporto multilingue: turco, inglese, tedesco — Claude cambia lingua all'interno dello stesso assistente.
  • Notifiche sugli ordini: messaggi transazionali come «il suo ordine è stato spedito» (tramite template utility).

A che cosa prestare attenzione

  • Opt-in: deve avere il consenso delle persone a cui invierà i template; in caso contrario, la valutazione di qualità del suo numero scende.
  • Valutazione di qualità e limiti di messaggistica: Meta assegna al suo numero una valutazione di qualità e suddivide in livelli il numero di messaggi che può inviare ogni giorno. I comportamenti da spam abbassano il limite.
  • Protezione dei dati (KVKK, la legge turca n. 6698 in materia, e GDPR): quando tratta i dati dei clienti, imposti correttamente consenso esplicito, conservazione e cancellazione.
  • Guardrail per l'AI: dica chiaramente all'assistente che cosa può e non può fare; limiti temi come gli impegni sui prezzi o la consulenza legale e li passi a una persona.

Come La aiuta Partnerfy

Questo sistema poggia su quattro pilastri e tutti e quattro rientrano nelle nostre competenze: l'infrastruttura di messaggistica multicanale, l'integrazione API (webhook + Graph API + gestione dei template), intelligenza artificiale e automazione (integrazione di Claude, tool use, guardrail) e il collegamento con CRM ed ERP. Dalla migrazione del numero all'API alla sua interfaccia di posta in arrivo, fino all'assistente basato su Claude, realizziamo tutto end-to-end.

Se vuole automatizzare con l'AI la sua linea di supporto WhatsApp, ci contatti: definiremo insieme i suoi scenari e le proporremo l'architettura più adatta.

Fonti