Documentazione dell'API di WhatsApp Business
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).
Cosa puoi fare
Inviare messaggi
Testo, media, pulsanti, liste, moduli, più i modelli approvati per raggiungere un cliente fuori dalla finestra di 24 ore.
Ricevere eventi
Messaggi in arrivo, conferme di consegna e di lettura, cambi di stato dei modelli, disiscrizioni dal marketing.
Automatizzare le campagne
Invia un modello a una lista di contatti e segui ogni invio fino alla conferma di lettura.
Integrare in TypeScript
@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.
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.
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: account, numero collegato, primo messaggio, in una decina di minuti.
Integri da codice esistente? Vai direttamente all'autenticazione, poi all'invio di messaggi.
Guide, confronti e codici di errore
Guide
Un caso d'uso per pagina: codici OTP, notifiche d'ordine, campagne, webhook, coesistenza, prezzi di Meta in Africa.
Confronti
Genuka WA a confronto con Twilio, 360dialog, WATI e le API WhatsApp non ufficiali.
Codici di errore
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-mcpdà a Claude, Cursor o VS Code accesso ai tuoi numeri, modelli e campagne. Configurazione in API di WhatsApp per agenti AI. - /llms.txt: un indice di tutta la documentazione per i modelli linguistici, e /llms-full.txt con tutte le pagine in un unico file.
- Markdown di qualsiasi pagina: aggiungi
.mdxal suo URL, per esempio /it/docs/quickstart.mdx. - /openapi.json: l'API REST descritta in OpenAPI 3.1.
- /pricing.md: i piani e i loro limiti, in Markdown.