Spun non ha ancora un’app Zapier o Make pubblicata da installare con un clic. Quello che ha è una REST API costruita proprio per questo: inviare messaggi WhatsApp, creare o aggiornare contatti, applicare etichette e verificare se un numero ha WhatsApp, più webhook in uscita per gli eventi in tempo reale. Entrambi si collegano direttamente al passaggio “Webhooks by Zapier” di Zapier o al modulo HTTP di Make, e allo stesso modo al nodo HTTP Request di n8n.
Questa ricetta è la strada onesta che funziona oggi. Se invece di un passaggio HTTP generico vuoi un’app nativa pubblicata in elenco, consulta le note di fattibilità linkate in fondo per capire cosa servirebbe per rilasciarla.
1. Crea una chiave API
- 1
Apri le chiavi API
Nella Posta in arrivo di Spun: “Impostazioni”, poi “Webhook”, poi “Gestisci chiavi API”, poi “Nuova chiave”.
- 2
Dagli un nome e scegli gli ambiti
Chiamala per esempio “Zapier Production”. Attiva solo gli ambiti che ti servono davvero: invio messaggi, gestione contatti, lettura contatti, gestione etichette, lettura etichette o verifica dei numeri di telefono.
- 3
Copiala una volta sola
La chiave (che inizia con wap_) viene mostrata una sola volta. Conservala nell’archivio delle credenziali della tua piattaforma di automazione, mai dentro un passaggio del workflow o in un documento condiviso.
2. Chiama Spun da uno Zap, uno scenario o un workflow
Ogni azione va allo stesso URL di base con la stessa intestazione. In Zapier usa “Webhooks by Zapier” > Custom Request; in Make, un modulo HTTP impostato su “Make a request”; in n8n, un nodo HTTP Request con Header Auth.
- check-phone: verifica che un numero abbia WhatsApp prima di inviare (accetta fino a 20 numeri per chiamata).
- create-contact / update-contact: mantieni sincronizzata la scheda WhatsApp di un lead da qualsiasi modulo o CRM.
- apply-label / remove-label: etichetta una chat da un trigger esterno, per es. applica l’etichetta “Nuovo lead” a una chat nel momento in cui viene inviato un modulo.
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json
{
"to": "15551234567",
"text": "Hello! Thanks for contacting us."
}Se il canale WhatsApp è offline per poco, send-message restituisce comunque esito positivo con un flag di coda invece di fallire: il messaggio parte in automatico appena il canale si riconnette.
3. Ricevi gli eventi WhatsApp in Zapier o Make
- 1
Crea prima il passaggio di ricezione
In Zapier, avvia uno Zap con “Webhooks by Zapier” > Catch Hook e copia l’URL che ti viene dato. In Make, aggiungi un modulo trigger Custom Webhook e copia l’URL del modulo.
- 2
Incollalo in Spun
“Impostazioni”, poi “Webhook”, poi “Aggiungi webhook”. Incolla l’URL e scegli quali eventi devono attivarlo.
- 3
Genera un evento di prova
Invia a te stesso un messaggio WhatsApp, poi clicca “Test trigger” (Zapier) o esegui lo scenario una volta (Make) per acquisire il vero payload di esempio.
{
"event_id": "550e8400-e29b-41d4-a716-446655440000",
"event": "message.inbound",
"timestamp": "2026-08-18T10:30:00.000Z",
"org_id": "123",
"data": {
"message_id": "[email protected]_ABC123",
"chat_id": "[email protected]",
"from": "15551234567",
"type": "text",
"text": "Hello!"
}
}Eventi disponibili: messaggio in arrivo/in uscita, contatto creato/aggiornato/eliminato, etichetta assegnata, flusso di chat completato, messaggio in coda elaborato, lead qualificato, chat archiviata e chiamata completata.
Cosa sapere prima di costruirci sopra
- Non è un’app Zapier/Make pubblicata e ricercabile in elenco. Oggi in Zapier o Make non esiste una schermata OAuth “Connect your Spun account”: l’autenticazione è una chiave API statica che incolli tu stesso nelle intestazioni del passaggio HTTP.
- Le iscrizioni ai webhook (il lato “ricevi eventi”) per ora si possono creare solo dalle Impostazioni di Spun, non dal lato di Zapier, quindi un trigger in stile REST Hook che si iscrive da solo non è ancora disponibile.
- Il limite di frequenza è di 60 richieste al minuto per chiave API. Dove puoi, raggruppa le verifiche dei numeri (fino a 20 per chiamata) invece di farle una alla volta in un ciclo.
Vedi anche: WhatsApp + Google Sheets (completamente nativa, nessuna chiave API necessaria) · WhatsApp + HubSpot CRM