# Documentazione dell'API di WhatsApp Business

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

> La WhatsApp Business Platform ufficiale tramite un'API REST, senza dover presentare tu stesso una candidatura a Meta.

Genuka WA ti dà accesso alla **WhatsApp Business Platform ufficiale di Meta** tramite una semplice
API REST. Nessun account sviluppatore Meta da creare, nessuna candidatura come provider da
presentare a Meta, nessun token di accesso da ruotare: Genuka è un Meta Tech Provider e si fa
carico di questa complessità al posto tuo. La verifica dell'azienda di Meta non è necessaria per
iniziare; in pratica, è ciò che sblocca i codici OTP e limiti di invio più alti
([dettagli](https://wa.genuka.com/it/docs/guides/without-meta-verification)).

## Cosa puoi fare

* [Inviare messaggi](https://wa.genuka.com/it/docs/messages): Testo, media, pulsanti, liste, moduli, più i modelli approvati per raggiungere un cliente fuori
  dalla finestra di 24 ore.
* [Ricevere eventi](https://wa.genuka.com/it/docs/webhooks): Messaggi in arrivo, conferme di consegna e di lettura, cambi di stato dei modelli, disiscrizioni
  dal marketing.
* [Automatizzare le campagne](https://wa.genuka.com/it/docs/campaigns): Invia un modello a una lista di contatti e segui ogni invio fino alla conferma di lettura.
* [Integrare in TypeScript](https://wa.genuka.com/it/docs/library): `@genuka/whatsapp` fornisce builder tipizzati che rifiutano i payload non validi prima della
  chiamata di rete.

## Due regole da conoscere prima di iniziare

WhatsApp non è un canale di invio senza regole. Due vincoli condizionano ogni integrazione, e
costa meno rispettarli qui che scoprirli nei tuoi log di produzione.

> [!WARNING]
> **La finestra di servizio di 24 ore**
>
> Puoi inviare un messaggio libero (testo, immagine, pulsanti) solo entro **24 ore** dall'ultimo
> messaggio che hai ricevuto da quel contatto. Dopo, verrà consegnato solo un **modello approvato**
> da Meta. Qualsiasi altra cosa fallisce con l'errore `131047`.

> [!NOTE]
> **Il consenso (opt-in) è obbligatorio**
>
> Puoi scrivere solo a persone che hanno accettato di essere contattate. Un utente può disiscriversi
> dai messaggi di marketing in qualsiasi momento; ricevi una notifica via webhook e gli invii
> devono fermarsi immediatamente.

## Da dove iniziare

Sei nuovo sulla piattaforma? Segui la [guida rapida](https://wa.genuka.com/it/docs/quickstart): account, numero
collegato, primo messaggio, in una decina di minuti.

Integri da codice esistente? Vai direttamente all'[autenticazione](https://wa.genuka.com/it/docs/authentication), poi
all'[invio di messaggi](https://wa.genuka.com/it/docs/messages).

## Guide, confronti e codici di errore

* [Guide](https://wa.genuka.com/it/docs/guides): Un caso d'uso per pagina: codici OTP, notifiche d'ordine, campagne, webhook, coesistenza, prezzi
  di Meta in Africa.
* [Confronti](https://wa.genuka.com/it/docs/compare): Genuka WA a confronto con Twilio, 360dialog, WATI e le API WhatsApp non ufficiali.
* [Codici di errore](https://wa.genuka.com/it/docs/errors): I codici di errore di Meta (131047, 131026, 130429…), uno per pagina: cosa significa ciascuno e
  se conviene riprovare.

## Per agenti AI e strumenti

* **Server MCP**: `@genuka/whatsapp-mcp` dà a Claude, Cursor o VS Code accesso ai tuoi numeri,
  modelli e campagne. Configurazione in [API di WhatsApp per agenti AI](https://wa.genuka.com/it/docs/guides/ai-agents).
* **[/llms.txt](https://wa.genuka.com/llms.txt)**: un indice di tutta la documentazione per i modelli linguistici, e
  [/llms-full.txt](https://wa.genuka.com/llms-full.txt) con tutte le pagine in un unico file.
* **Markdown di qualsiasi pagina**: aggiungi `.mdx` al suo URL, per esempio
  [/it/docs/quickstart.mdx](https://wa.genuka.com/it/docs/quickstart.mdx).
* **[/openapi.json](https://wa.genuka.com/openapi.json)**: l'API REST descritta in OpenAPI 3.1.
* **[/pricing.md](https://wa.genuka.com/pricing.md)**: i piani e i loro limiti, in Markdown.
