# Guide all'API WhatsApp Business

URL: https://wa.genuka.com/it/docs/guides
Language: Italian

> Guide all'API WhatsApp Business con Genuka WA: codici OTP, notifiche d'ordine, campagne, webhook, coesistenza, prezzi Meta e agenti IA.

Ognuna di queste guide risponde a una domanda di integrazione sull'API WhatsApp Business con
Genuka WA: inviare un codice OTP, avvisare i clienti di un ordine, lanciare una campagna, ricevere
risposte e stati su un webhook, tenere l'app WhatsApp Business sul tuo numero, partire senza la
verifica di Meta, stimare il costo dei messaggi in Africa o affidare WhatsApp a un agente IA.

*Ultimo aggiornamento: 8 ottobre 2026*

## Come invio messaggi WhatsApp dal mio backend?

* [Inviare codici OTP WhatsApp da Node.js](https://wa.genuka.com/it/docs/guides/whatsapp-otp-nodejs): Modello di autenticazione con pulsante per copiare il codice, scadenza e verifica lato server,
  fallback via SMS.
* [Notifiche d'ordine su WhatsApp](https://wa.genuka.com/it/docs/guides/order-notifications): Conferma, spedizione e consegna come modelli di utilità: variabili, idempotenza e stati di
  consegna.
* [Inviare una campagna WhatsApp tramite l'API](https://wa.genuka.com/it/docs/guides/campaigns-api): Modello marketing, elenco dei destinatari, lancio, quote del piano e limiti marketing di Meta.

## Come ricevo le risposte e gli stati di consegna?

* [Ricevere risposte e stati via webhook](https://wa.genuka.com/it/docs/guides/receive-messages-webhooks): Registra un URL, verifica la firma HMAC nell'header `X-Genuka-Signature`, deduplica,
  gestisci i nuovi tentativi e il replay.
* [Collegare un agente vocale alle chiamate WhatsApp](https://wa.genuka.com/it/docs/guides/voice-agent): Attiva le chiamate, ricevi ogni chiamata con il suo SDP, rispondi e chiama tramite l'API.

## Come collego il mio numero WhatsApp?

La procedura vera e propria è in [Collegare un numero](https://wa.genuka.com/it/docs/onboarding). Queste due guide
rispondono alle domande che vengono prima.

* [Coesistenza con l'app WhatsApp Business](https://wa.genuka.com/it/docs/guides/coexistence): Tieni l'app sul numero mentre invii tramite l'API: requisiti, passaggi, cosa si sincronizza e
  i limiti.
* [API WhatsApp senza verifica di Meta](https://wa.genuka.com/it/docs/guides/without-meta-verification): Cosa può inviare un'azienda non verificata, cosa sblocca la verifica e il rischio delle API
  non ufficiali.

## Quanto costa un messaggio WhatsApp?

* [Prezzi dei messaggi WhatsApp in Africa](https://wa.genuka.com/it/docs/guides/whatsapp-pricing-africa): Le tariffe di Meta per paese e categoria, in USD, EUR e franchi CFA, con un esempio svolto.

Queste sono le tariffe di Meta. L'abbonamento Genuka WA, fatturato per numero, è sulla
[pagina dei prezzi](https://wa.genuka.com/it#pricing) e in Markdown su [/pricing.md](https://wa.genuka.com/pricing.md).

## Come collego un agente IA a WhatsApp?

* [API WhatsApp per agenti IA](https://wa.genuka.com/it/docs/guides/ai-agents): Il server MCP `@genuka/whatsapp-mcp` per Claude, Cursor o VS Code, più `llms.txt`, pagine
  Markdown e la specifica OpenAPI per scrivere l'integrazione.

## Cosa mi serve prima di seguire una guida?

Un account Genuka WA, un numero collegato e una chiave API. La [guida rapida](https://wa.genuka.com/it/docs/quickstart)
copre tutti e tre, [autenticazione](https://wa.genuka.com/it/docs/authentication) copre la chiave e il
[riferimento API](https://wa.genuka.com/it/docs/api) elenca ogni endpoint. La stessa API è descritta in OpenAPI 3.1 su
[/openapi.json](https://wa.genuka.com/openapi.json). Quando una chiamata fallisce, il codice restituito da Meta è
spiegato nei [codici di errore](https://wa.genuka.com/it/docs/errors).

## FAQ

### Mi serve la verifica dell'azienda di Meta per seguire queste guide?

Non per iniziare. Un'azienda non verificata invia modelli marketing e di utilità a un massimo di 250
destinatari unici ogni 24 ore fuori dalla finestra del servizio clienti, per cominciare
([Meta, Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)).
I codici OTP sono l'eccezione: i modelli di autenticazione richiedono di superare uno dei percorsi
di crescita di Meta, nella maggior parte dei casi la verifica dell'azienda
([360dialog, Authentication messages](https://docs.360dialog.com/docs/resources/authentication-messages)).
I dettagli sono in [API WhatsApp senza verifica di Meta](https://wa.genuka.com/it/docs/guides/without-meta-verification).

### Posso tenere un numero che usa già WhatsApp Business?

Sì. Con la coesistenza di Meta, l'app WhatsApp Business, versione 2.24.17 o successiva, continua a
funzionare sul numero collegato all'API, e la cronologia delle chat individuali resta
sincronizzata
([Meta, Onboarding WhatsApp Business app users](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users)).
Solo un numero registrato su WhatsApp normale, l'app consumer, va liberato prima. Vedi la
[guida alla coesistenza](https://wa.genuka.com/it/docs/guides/coexistence).

### Chi fattura i messaggi che invio?

Meta, direttamente sul tuo WhatsApp Business Account: un cliente registrato tramite un Tech
Provider aggiunge il proprio metodo di pagamento e Meta gli fattura l'utilizzo
([Meta, Solution Partners and Tech Providers](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/overview)).
Genuka non applica ricarichi su queste tariffe e addebita un abbonamento per numero WhatsApp.

### In quali linguaggi sono gli esempi di codice?

curl, Node.js, Python e PHP nella maggior parte delle guide. La guida ai webhook mostra Next.js,
Express, Flask e la libreria `@genuka/whatsapp`; la guida OTP si limita a Node.js e curl.

## Fonti

Consultate l'8 ottobre 2026.

* Meta — [Messaging limits](https://developers.facebook.com/documentation/business-messaging/whatsapp/messaging-limits)
* Meta — [Onboarding WhatsApp Business app users (coexistence)](https://developers.facebook.com/documentation/business-messaging/whatsapp/embedded-signup/onboarding-business-app-users)
* Meta — [Solution Partners and Tech Providers](https://developers.facebook.com/documentation/business-messaging/whatsapp/solution-providers/overview)
* 360dialog — [Authentication messages](https://docs.360dialog.com/docs/resources/authentication-messages)
