Proteggi le automazioni WhatsApp: chiavi, webhook e firme
Proteggi un'automazione WhatsApp in quattro punti: la chiave AI, conservata cifrata e usata solo per le risposte AI; il webhook che un'automazione richiama, che dovrebbe verificare una firma HMAC prima di fidarsi di una richiesta; l'inoltro dei messaggi in arrivo, firmato con un segreto che puoi ruotare; e le persone e gli assistenti con accesso, limitati a ciò che serve.
easyCoexistence conserva le tue chiavi AI cifrate e non le mostra mai più, firma ogni richiesta di Chiama il mio webhook e ogni messaggio inoltrato con X-EC-Signature usando un segreto che solo tu conosci, e rifiuta gli indirizzi webhook che non sono HTTPS pubblici.
Cifratura a riposo per le chiavi AI salvate, i segreti di firma e il token di accesso Meta del numero.
Di una chiave AI salvata si vede di nuovo solo: "termina in" seguito dai suoi ultimi quattro caratteri.
Casualità in ogni segreto di firma: whsec_ seguito da 24 byte casuali, uno per automazione e uno per ogni numero che inoltra.
Gli URL del webhook e di inoltro devono essere HTTPS pubblici; gli indirizzi privati e interni vengono rifiutati al salvataggio e prima di ogni invio.
Limite suggerito sull'età del valore t della firma, per rifiutare richieste riprodotte.
Cosa va protetto in una configurazione di automazione WhatsApp?
Cinque credenziali, ciascuna con il proprio posto e la propria correzione se viene divulgata. Due appartengono alle automazioni stesse: la chiave AI e il segreto di firma di Chiama il mio webhook; il segreto di inoltro appartiene al numero; il token di accesso e l'accesso del tuo assistente appartengono all'account. Sapere di cosa si tratta ti dice cosa ruotare quando qualcosa va storto.
Come vengono conservate e usate le chiavi AI?
Solo dalla dashboard: il pulsante Chiavi AI nella pagina Automazioni, poi Prova e salva. La chiave viene prima verificata con un endpoint gratuito del fornitore, che non consuma token, e una chiave rifiutata dal fornitore viene scartata senza essere salvata. Una chiave funzionante viene cifrata a riposo con AES-256-GCM, decifrata solo per chiamare quel fornitore nei tuoi passaggi AI e agenti, e per trascrivere i messaggi vocali con una chiave OpenAI o OpenRouter, e mostrata in seguito solo come "termina in 1234". Nessuno strumento MCP accetta o restituisce una chiave, quindi non passa mai da una chat con il tuo assistente.
Un account ha una chiave per fornitore, e salvarne una nuova sostituisce la vecchia. Crea una chiave dedicata alle automazioni presso il fornitore, con un limite di spesa dove il fornitore lo offre, così può essere revocata senza interrompere le altre app. Se il fornitore dovesse rifiutarla, le automazioni che la usano risultano In pausa e ricevi una sola e-mail; salvare una chiave funzionante le riavvia automaticamente.
Come verifichi che una richiesta di Chiama il mio webhook sia autentica?
Controlla la firma prima di leggere altro. Ogni richiesta porta X-EC-Signature: t=<secondi unix>,v1=<HMAC-SHA256 esadecimale di "<t>.<corpo grezzo>">, calcolato con la chiave del segreto di firma di quell'automazione, che copi dal passaggio nell'editor dopo il salvataggio. Ricalcola l'HMAC sui byte grezzi, confronta in tempo costante e rifiuta una t che si discosta più di 5 minuti dal tuo orologio. Anche il corpo ti dice due cose utili. dry_run è true quando la richiesta arriva dal pulsante Prova, quindi salta ogni operazione irreversibile, come la creazione di un ordine. run_id è unico per ogni esecuzione, quindi conserva quelli già gestiti e rifiuta una richiesta riprodotta. Rispondi entro 20 secondi; {"reply": "..."} viene inviato al cliente così com'è, quindi non far passare mai testo del cliente senza controllo.
POST /hooks/whatsapp HTTP/1.1
Content-Type: application/json
User-Agent: easyCoexistence-automations/1
X-EC-Event: automation.step
X-EC-Signature: t=1794405732,v1=<64 hex characters>
{
"event": "automation.step",
"dry_run": false,
"automation": { "id": "a7d0c3e2-5b1f-4c8e-9a6d-2f4e8b1c7d90", "name": "Order status" },
"run_id": "e41b9f07-3c2a-4d6e-8f15-7a9c0b2d4e68",
"channel": { "type": "whatsapp", "connection_id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"connection": { "id": "3f2a9c1e-7b4d-4e8a-9c2f-1a2b3c4d5e6f", "phone": "+1 631-555-0142", "phone_number_id": "106540352242922" },
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFjNFQjBDNzE4RjQ2QjI5RDkxQTNFAA==", "type": "text", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.000Z" },
"history": [
{ "direction": "in", "text": "Hi!", "at": "2026-11-11T14:01:40.120Z" },
{ "direction": "in", "text": "Where is my order #1042?", "at": "2026-11-11T14:02:11.310Z" }
]
}
// Your answer, within 20 seconds (or {} to send nothing):
{ "reply": "Your order #1042 left the shop at 2:20 p.m." }Come funzionano i segreti di inoltro e come si ruotano?
Un numero impostato su Tramite easyCoexistence può inoltrare i messaggi in arrivo al tuo sistema. La prima volta che salvi un URL di inoltro viene generato un segreto, mostrato una sola volta sotto "Il tuo segreto di firma, mostrato una sola volta. Copialo ora:"; firma ogni POST inoltrato con lo stesso schema X-EC-Signature. Un nuovo segreto dalla pagina del numero, oppure set_inbound_mode con rotate_secret impostato su true, ne genera uno sostitutivo, di nuovo mostrato una sola volta, e da quel momento firma tutto, inclusi i nuovi tentativi di consegne precedenti. Puoi anche digitare un segreto tuo, di almeno 24 caratteri, che viene memorizzato e non viene mai più mostrato. Interrompere l'inoltro elimina il segreto, quindi salvare in seguito un URL ne crea uno nuovo.
Ruota il segreto dopo che un collaboratore con accesso se n'è andato, dopo che un segreto è finito in un repository, in un ticket o in un log, e quando cambi hosting. Il segreto di Chiama il mio webhook appartiene all'automazione e lo vede solo il proprietario dell'account. Dove l'editor mostra Nuovo segreto, sotto un trigger «Il tuo sistema chiama un URL», quel pulsante lo sostituisce e il vecchio smette di funzionare subito; su un'automazione senza quel pulsante, crea di nuovo l'automazione, indica al tuo ricevitore il nuovo segreto, poi elimina la vecchia automazione.
Quali indirizzi possono chiamare le automazioni?
Solo indirizzi HTTPS pubblici. Un URL di Chiama il mio webhook o un URL di inoltro che inizia con http://, punta a localhost, a una rete privata, a un nome .internal o .local, oppure a un indirizzo di metadati cloud viene rifiutato al salvataggio, e controllato di nuovo dopo il DNS prima di ogni richiesta, così un nome pubblico non può essere poi indirizzato verso una rete privata. I reindirizzamenti non vengono seguiti: un 301 o un 302 fa fallire il passaggio, quindi salva l'indirizzo finale.
Tieni i segreti fuori dall'URL stesso. list_automations restituisce i passaggi di ogni automazione, URL del webhook incluso, a qualsiasi assistente collegato al tuo account, quindi un token nei parametri dell'URL sarebbe leggibile lì. Lascia che sia la firma a fornire la prova.
Come limiti l'accesso al minimo?
Concedi a ogni persona e a ogni strumento solo l'accesso che serve al suo lavoro, e rimuovi quello non più usato. Il lato connettore, con accesso, conferme e strumenti bloccati, è trattato nella pagina su come collegare WhatsApp a un'AI in sicurezza; sul lato automazioni, queste abitudini contano di più:
- Richiedi
get_api_credentialssolo in una chat privata: il token di accesso del numero finisce in quella trascrizione. - Preferisci Chiama il mio webhook o un URL di inoltro piuttosto che passare il token a uno strumento di terze parti.
- Elimina le automazioni ritirate; così ritiri anche i loro segreti di firma.
- Ricorda che i log delle esecuzioni conservano messaggi e risposte dei clienti per 30 giorni, e Conversazioni conserva le chat per il tuo periodo di conservazione (30, 90 o 365 giorni), entrambi leggibili nella dashboard e tramite l'assistente collegato.
- Su un numero impostato su Direttamente al tuo sistema, inserisci un segreto casuale lungo nel percorso dell'URL di callback, perché la firma di Meta non può essere verificata lì.
Errori comuni
- Verificare la firma su un JSON che il framework ha riserializzato. Molti parser modificano spaziatura, escape o ordine delle chiavi; calcola l'HMAC sui byte grezzi della richiesta ovunque lo stack li esponga.
- Eseguire effetti collaterali sulle chiamate di prova. Prova chiama il webhook con dry_run impostato su true; un ordine, un rimborso o una scrittura nel CRM fatta in quel momento è reale.
- Incollare una chiave AI in una chat con il tuo assistente per risparmiare tempo. Nessuno strumento la accetta e resta nella trascrizione; usa le chiavi AI dalla dashboard.
- Controllare un inoltro con il segreto di Chiama il mio webhook, o viceversa. Sono segreti separati: uno per numero per gli inoltri, uno per automazione per le chiamate webhook.
Il tuo numero resta sulla Cloud API ufficiale di Meta tramite Coexistence, monitorato 24/7. Da US$ 9 a US$ 0,75 per numero al mese, con il prezzo che scende man mano che aggiungi numeri, e i primi 3 giorni gratuiti.
Domande frequenti
Il personale o il supporto di easyCoexistence può vedere la mia chiave AI?
La chiave non viene mai visualizzata dopo il salvataggio, né nella dashboard, né nei risultati MCP, né nei fatti che l'assistente di supporto legge. Viene decifrata solo dal sistema, nel momento in cui chiama il tuo fornitore per una risposta AI.
Chi può leggere i log delle esecuzioni delle automazioni?
Chiunque abbia effettuato l'accesso al tuo account easyCoexistence, comprese le persone che hai invitato, nella scheda Esecuzioni, e qualsiasi assistente collegato all'account, tramite list_automation_runs e get_automation_run. I log includono il messaggio del cliente e la risposta, e vengono eliminati dopo 30 giorni.
Come rimuovo una chiave AI in sicurezza?
Disattiva prima le automazioni che la usano e qualsiasi agente che ne dipende, poi seleziona Rimuovi sotto Chiavi AI e revoca la chiave presso il fornitore. Rimuoverla mentre le automazioni la usano ancora le mette in pausa alla risposta AI successiva e ti invia un'e-mail.
Prova invia dati dei clienti al mio webhook?
Invia solo il testo di esempio che hai digitato, con dry_run impostato su true e una cronologia vuota. Le esecuzioni reali inviano il messaggio in arrivo e i messaggi recenti della chat, fino a 10, quindi tratta il tuo endpoint come un gestore di dati dei clienti.
Continua a leggere
Pronto per iniziare?
Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.
Inizia la prova gratuitaVerificato il