Guida di configurazione

WhatsApp + Zapier / Make: collegali oggi con la REST API

Funziona oggi via HTTP, nessuna app nativa necessariaUltima verifica: agosto 2026

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. 1

    Apri le chiavi API

    Nella Posta in arrivo di Spun: “Impostazioni”, poi “Webhook”, poi “Gestisci chiavi API”, poi “Nuova chiave”.

  2. 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. 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.
Invia un messaggio WhatsApp (POST /api/integrations/send-message)
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. 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. 2

    Incollalo in Spun

    “Impostazioni”, poi “Webhook”, poi “Aggiungi webhook”. Incolla l’URL e scegli quali eventi devono attivarlo.

  3. 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.

Cosa invia Spun su message.inbound
{
  "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

Domande frequenti

Esiste un’app Spun ufficiale nella directory di Zapier o Make?

Non ancora. La REST API e i webhook in uscita che userebbe sono già attivi, quindi le stesse azioni e gli stessi trigger funzionano oggi tramite il passaggio generico HTTP/Webhooks in Zapier, Make e n8n.

Cosa posso fare oggi con l’API?

Inviare un messaggio di testo WhatsApp, verificare se un numero ha WhatsApp, creare o aggiornare un contatto e applicare o rimuovere un’etichetta su una chat, più ricevere eventi in tempo reale (nuovo messaggio, nuovo contatto, etichetta applicata, flusso di chat completato, lead qualificato, chat archiviata, chiamata completata) come webhook in uscita.

Come mi autentico?

Crea una chiave API in “Impostazioni” > “Webhook” > “Gestisci chiavi API”, scegli solo gli ambiti che ti servono e inviala come token Bearer nell’intestazione Authorization. Oggi questa API non ha un flusso OAuth.

Zapier può iscriversi in automatico ai miei eventi Spun, come fa con un’app REST Hook nativa?

Non ancora. Incolli l’URL del catch hook di Zapier/Make nella schermata “Impostazioni” > “Webhook” di Spun e scegli lì gli eventi; Zapier non può creare quell’iscrizione al posto tuo.

Quali sono i limiti di frequenza?

60 richieste al minuto per chiave API. L’endpoint check-phone accetta fino a 20 numeri in una sola chiamata, il modo più semplice per restare ben sotto il limite nelle verifiche in blocco.

Cosa succede se invio un messaggio mentre il canale WhatsApp è disconnesso?

L’API restituisce comunque esito positivo con un flag di coda invece di fallire. Il messaggio viene inviato in automatico appena il canale si riconnette, quindi per questo caso non devi costruire una tua logica di nuovi tentativi.

Ottieni una chiave API e inizia a costruire

L’accesso all’API è disponibile nei piani WhatsApp di Spun, insieme alla casella condivisa del team, alle risposte con IA e alle integrazioni native con Google Sheets e HubSpot. Prezzo fisso a partire da €45 al mese, prova gratuita.

Inizia gratis: 7 giorni con tutto incluso

Vedi tutte le integrazioni