Guide all'API WhatsApp Business
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
Modello di autenticazione con pulsante per copiare il codice, scadenza e verifica lato server, fallback via SMS.
Notifiche d'ordine su WhatsApp
Conferma, spedizione e consegna come modelli di utilità: variabili, idempotenza e stati di consegna.
Inviare una campagna WhatsApp tramite l'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
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
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. Queste due guide rispondono alle domande che vengono prima.
Coesistenza con l'app WhatsApp Business
Tieni l'app sul numero mentre invii tramite l'API: requisiti, passaggi, cosa si sincronizza e i limiti.
API WhatsApp senza verifica di Meta
Cosa può inviare un'azienda non verificata, cosa sblocca la verifica e il rischio delle API non ufficiali.
Quanto costa un messaggio WhatsApp?
Queste sono le tariffe di Meta. L'abbonamento Genuka WA, fatturato per numero, è sulla pagina dei prezzi e in Markdown su /pricing.md.
Come collego un agente IA a WhatsApp?
Cosa mi serve prima di seguire una guida?
Un account Genuka WA, un numero collegato e una chiave API. La guida rapida copre tutti e tre, autenticazione copre la chiave e il riferimento API elenca ogni endpoint. La stessa API è descritta in OpenAPI 3.1 su /openapi.json. Quando una chiamata fallisce, il codice restituito da Meta è spiegato nei codici di errore.
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). 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). I dettagli sono in API WhatsApp senza verifica di Meta.
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). Solo un numero registrato su WhatsApp normale, l'app consumer, va liberato prima. Vedi la guida alla coesistenza.
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). 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
- Meta — Onboarding WhatsApp Business app users (coexistence)
- Meta — Solution Partners and Tech Providers
- 360dialog — Authentication messages
Piani e fatturazione
Paghi per numero WhatsApp. Meta fattura direttamente le conversazioni sul tuo Business Account; non applichiamo mai un ricarico a un messaggio.
Inviare codici OTP WhatsApp da Node.js
Invia password monouso su WhatsApp da Node.js con Genuka WA: modello di autenticazione, pulsante per copiare il codice, scadenza, verifica e fallback via SMS.