# Sviluppo WhatsApp Business Platform (Cloud API, chatbot, agenti AI)

> Consulente WhatsApp Business API freelance: integrazioni Cloud API, webhook, template, invii massivi, chatbot, agenti AI e voce, progettati per la produzione.

URL: https://fedme.dev/it/services/whatsapp-business-platform
Fornito da: Federico Meini (federico.meini@gmail.com)

## Servizi WhatsApp che reggono quando li usano milioni di persone.

Ho passato sei anni a costruire una piattaforma WhatsApp in Turn.io, usata da servizi sanitari in tutto il mondo e con milioni di messaggi al giorno. Posso sviluppare la tua integrazione con la Cloud API, il tuo chatbot o il tuo agente AI, oppure sistemare quello che hai già.

## Cosa ottieni

- Un’integrazione con la Cloud API che verifica le firme, deduplica i webhook e mantiene l’ordine dei messaggi per ogni contatto.
- Invii massivi e messaggi template che rispettano i limiti di throughput, fanno retry in sicurezza e tracciano ogni stato di consegna.
- Chatbot e agenti AI con un handover pulito verso gli operatori umani e verso i tuoi sistemi esistenti (CRM, cartella clinica elettronica, prenotazioni).
- Dashboard e alert su ciò che conta: tassi di consegna, tempi di risposta, performance dei template, invii falliti.

## Perché i servizi WhatsApp si rompono in produzione

Un prototipo su WhatsApp si fa in fretta. Il difficile arriva quando lo usano persone vere: i webhook arrivano due volte o nell’ordine sbagliato, una campagna scatena migliaia di risposte in un minuto, la finestra di assistenza clienti di 24 ore si chiude a metà conversazione, un template viene messo in pausa, e l’unico messaggio che contava davvero non riceve mai lo stato `delivered`.

Ho passato sei anni su questi problemi in [Turn.io](https://www.turn.io), una piattaforma WhatsApp usata da organizzazioni come l’OMS e da programmi sanitari nazionali per raggiungere milioni di persone. Ci ho costruito il motore di invio massivo dietro grandi campagne di salute pubblica, l’infrastruttura di job e trigger, lo storage su Postgres ed Elasticsearch mentre i dati dei messaggi crescevano di milioni di righe al giorno e, dal 2023, gli agenti AI che rispondono su WhatsApp.

## Cosa costruisco

**Integrazioni con la Cloud API.** Un receiver di webhook che verifica `X-Hub-Signature-256` sul body grezzo, risponde subito ed elabora in modo asincrono, deduplica per ID del messaggio e mantiene in ordine i messaggi di ogni contatto. Invii in uscita che gestiscono come si deve errori di throttling, regole dei template e media.

**Messaggistica massiva e campagne.** Una pipeline guidata dalla domanda con rate limiting, backpressure, retry e tracciamento delle consegne, così una campagna verso un milione di contatti non manda in crisi il tuo sistema e non ti fa finire in throttling.

**Chatbot e agenti AI.** Flussi di conversazione, messaggi interattivi (pulsanti, liste), agenti AI con tool e un handover agli operatori umani che non perde il contesto. Posso collegarli al tuo CRM, alla cartella clinica elettronica, al sistema di prenotazione o di pagamento.

**Voce.** Chiamate WhatsApp combinate con modelli vocali real-time e LLM piccoli e veloci, per conversazioni con una latenza abbastanza bassa da risultare naturali.

## Come lavoro

1. **Mappare prima le conversazioni.** Cosa vogliono ottenere gli utenti, cosa non deve mai andare storto, quali messaggi partono dall’azienda e quindi richiedono un template.
2. **Progettare per la consegna at-least-once.** Su WhatsApp tutto può arrivare due volte o in ritardo, quindi idempotenza e ordinamento vengono prima di tutto.
3. **Rilasciare presto una versione minima** e osservare il traffico reale: tassi di consegna, tempi di risposta, punti di abbandono.
4. **Misurare e iterare.** Per gli agenti AI questo significa eval su conversazioni simulate e reali, non sensazioni.

## Servizi correlati

- [Sistemi real-time e distribuiti](https://fedme.dev/it/services/realtime-systems): il motore di invio e l’elaborazione che reggono WhatsApp su larga scala.
- [Orchestrazione di agenti AI ed eval](https://fedme.dev/it/services/ai-agents-evals): agenti che rispondono su WhatsApp, e come dimostrare che sono sicuri.

## Come possiamo collaborare

- **Sviluppo di un’integrazione**: Sviluppo a perimetro definito di un’integrazione o di un servizio sulla WhatsApp Cloud API, dal receiver dei webhook fino al lancio in produzione.
- **Revisione dell’architettura**: Da una a due settimane di analisi di un’integrazione WhatsApp esistente: affidabilità, ordinamento, idempotenza e costi.
- **Senior engineer nel tuo team**: Part-time nel tuo team per qualche mese, mentre lanci o fai crescere un servizio WhatsApp.

## Stack

WhatsApp Cloud API, Webhooks, Message templates, Interactive messages, WhatsApp calling, Elixir / Phoenix, Python, TypeScript, PostgreSQL

## FAQ

### Lavori con la WhatsApp Cloud API o con la On-Premises API?

I nuovi progetti dovrebbero usare la Cloud API, ospitata da Meta, ed è quella su cui lavoro oggi. Ho lavorato anche su configurazioni più vecchie e posso aiutarti a pianificare una migrazione.

### Puoi costruire un agente AI che risponde su WhatsApp?

Sì. In Turn.io ho costruito l’agent harness che le organizzazioni usano per far girare agenti AI su WhatsApp, con uso di tool, guardrail e handover agli operatori umani. Posso fare lo stesso per il tuo servizio, insieme alle eval che dimostrano che l’agente si comporta come deve.

### Come si inviano milioni di messaggi WhatsApp senza incappare nel throttling?

Con una pipeline di invio guidata dalla domanda, che applica limiti di throughput per numero con un token bucket, ripete con backoff e jitter le richieste respinte per throttling e registra ogni webhook di stato. Ho costruito un motore di questo tipo per campagne nazionali di salute pubblica.

### Lavori solo con organizzazioni sanitarie?

No. Gran parte della mia esperienza con WhatsApp viene da servizi sanitari e a impatto sociale, dove l’affidabilità conta molto, ma l’ingegneria è la stessa per e-commerce, assistenza clienti, fintech o logistica.

## Contatti

Email federico.meini@gmail.com · https://fedme.dev/it/contact
