API di WhatsApp per sviluppatori

Cosa risolve l'API al posto tuo

• Coda di uscita con tentativi ripetuti: l'invio viene confermato con 202 e consegnato a Meta rispettando il ritmo di ogni numero. Un rifiuto di Meta resta nello stato del messaggio con un codice stabile.
• Idempotenza: l'intestazione Idempotency-Key evita di inviare due volte lo stesso messaggio se riprovi.
• Webhook firmati con HMAC su data e corpo (protezione contro i reinvii), più un'intestazione statica opzionale per strumenti no-code come n8n.
• Modelli: crearli, sincronizzarli e verificarli prima di inviarli a Meta, con il motivo e la correzione se qualcosa verrebbe rifiutato.
• Media: inviare immagine, documento, audio e video tramite link, e scaricare i media in arrivo tramite un proxy.
• Errori di Meta tradotti in un catalogo di codici stabili, con cosa fare in ogni caso.

Come si presenta

Un invio è una richiesta HTTP con la tua chiave API. Il numero si indica con l'identificativo di connessione (conn_…) che restituisce GET /v1/connections.

Esempi pronti da copiare in cURL, Node.js, PHP e Python: Inviare un messaggio. Tutto il contratto: OpenAPI.

Cosa non fa

• Non è una casella di chat per rispondere con un team: per quello c'è WAIA, il nostro prodotto chiavi in mano.
• Non conserva file: per inviare un tuo file, lo ospiti tu e invii il link.
• Non ti esonera dalle regole di Meta: la finestra di 24 ore, i modelli approvati e i limiti di invio continuano a valere. Te li spieghiamo in Prima di collegarti.

Quanto costa

Una tariffa fissa per numero collegato, senza limite di messaggi. Inizi con 14 giorni di prova; il piano più piccolo è Starter (US$ 12 al mese).

• Starter — US$ 12 al mese, 1 numero
• Studio — US$ 25 al mese, 5 numeri
• Agencia — US$ 45 al mese, 12 numeri
• Escala — US$ 99 al mese, 30 numeri, più US$ 3 per ogni numero extra

Meta addebita a parte i suoi messaggi, sulla tua carta; noi non aggiungiamo ricarichi. Il confronto con chi invece lo fa: WAIA Connect vs Twilio.

Domande frequenti

Usa l'API ufficiale di Meta?

Sì. WAIA Connect è un fornitore di tecnologia verificato da Meta e gestisce la Cloud API e la coesistenza (Coexistence). Non usa librerie non ufficiali che simulano WhatsApp Web.

Come ricevo i messaggi in arrivo?

Registri un URL https e ti arrivano via POST, firmati con HMAC. La guida alla verifica della firma ha esempi in quattro linguaggi.

Cosa succede se invio due volte la stessa richiesta?

Con la stessa Idempotency-Key il messaggio viene inviato una sola volta e la seconda risposta restituisce lo stesso identificativo.

C'è un limite mensile di messaggi?

In WAIA Connect no: il piano si paga per numero collegato. Meta invece ha i suoi limiti per avviare conversazioni con modelli, che dipendono dal tuo account Meta.

La documentazione è pensata per essere letta con un'IA?

Sì: ogni modulo è disponibile anche in Markdown, c'è un llms.txt nella radice del sito e il contratto completo è in OpenAPI.

Per continuare

• Documentazione
• Autenticazione
• Ricevere il webhook
• Catalogo degli errori
• WhatsApp Coexistence
• Per le agenzie