Documentazione dell'API
Ti diamo un'API e tu ci costruisci sopra. Esempi in cURL, Node.js, PHP e Python. Gli esempi qui usano placeholder (wc_live_…, conn_…); dentro il pannello arrivano con i tuoi dati reali.
Specifica OpenAPI
L'API pubblica (/v1) in un file OpenAPI 3.1: importalo in Postman/Insomnia, genera un client nel tuo linguaggio, o passalo a un agente di IA perché usi l'API senza leggere HTML.
Primi passi
Prima di scrivere una riga di codice conviene sapere cosa ti chiederà Meta, che è la parte che non dipende da noi: un numero tuo, un account Facebook con un Portafoglio aziendale, una carta sul tuo account Meta e —se vuoi scrivere per primo— un modello approvato. Niente di tutto questo ha un costo qui e non serve registrarsi per leggerlo. Sono sei brevi passi, nell'ordine in cui avvengono davvero.
Una volta che hai un account, il pannello ti dice quale di questi sei ti manca, con lo stato reale del tuo numero. Inizia.
- ① Prima di collegare — cosa ti servirà
- ② Mentre ti colleghi
- ③ Le pratiche di Meta, in ordine di urgenza
- ④ Cos'è un modello (template) e perché esiste
- ⑤ Per inviare
- ⑥ Cosa addebita Meta e cosa addebita WAIA Connect
Essenziale
- Autenticazione GET /v1/connections
- Inviare un messaggio di testo POST /v1/messages
- Inviare media (immagine · documento · audio · video) POST /v1/messages
- Ricevere messaggi via webhook
- Autenticare il webhook: header statico o firma
- Verificare la firma
- Consultare lo stato di un messaggio GET /v1/messages/:id
- Segnare un messaggio come letto (e mostrare «sta scrivendo…») POST /v1/messages/read
- Scaricare i media in arrivo GET /v1/media/:mediaId
- Ricevere la cronologia di Coexistence GET /v1/connections/:id/history
Completo
- Inviare un modello POST /v1/messages
- Inviare un modello con un file nell'intestazione POST /v1/messages
- Creare, elencare e sincronizzare i modelli POST /v1/templates
- Connessioni e il loro stato di salute GET /v1/connections
- Onboarding ospitato (il tuo cliente collega il suo numero) POST /v1/onboarding-links
- Modelli proposti dal tuo cliente POST /v1/template-links
- Consumo e limiti GET /v1/usage
- I 21 tipi di evento con il loro payload
- Il catalogo completo degli errori
- Idempotenza, nuovi tentativi e ordine di consegna
Usi n8n? WhatsApp in n8n: il workflow completo di assistenza, gratis.
Il tuo progetto è su Supabase? Ricevere WhatsApp in Supabase con una Edge Function.
Costruisci il tuo bot su un foglio Google? Collegare WhatsApp a Google Sheets (Apps Script, senza programmare).
Qualcosa non torna o ti serve un piano su misura? Scrivici a hola@waiaconnect.com o chiedi un preventivo.