Usare API e webhook in modo sicuro
SmartChat protegge ogni collegamento con i tuoi programmi e le tue app AI, così i dati dei tuoi contatti WhatsApp arrivano solo dove lo permetti tu.
SmartChat non salva la tua chiave mai in chiaro.
Vedi la chiave API completa una sola volta, subito dopo averla creata. SmartChat ne salva solo un valore di controllo, da cui non si può risalire alla chiave.
- 1
Sei tu a decidere cosa può fare
Ogni chiave ha un nome e un permesso: Solo lettura oppure Lettura e scrittura. Di più non potrà mai fare.
- 2
La copi una volta sola
Dopo, SmartChat mostra solo l'inizio e gli ultimi quattro caratteri. A ogni richiesta SmartChat confronta la chiave con il valore di controllo salvato.
Authorization: Bearer DEIN_API_SCHLUESSEL - 3
La blocchi con un clic
Se rigeneri o elimini una chiave, quella vecchia smette subito di funzionare. SmartChat rifiuta ogni altra richiesta fatta con essa.
# Risposta 401 "key": "apikey_widerrufen"
Le app AI le colleghi solo con il tuo consenso.
Un'app AI la colleghi a SmartChat tramite MCP . Accedi con il tuo account SmartChat e confermi i permessi: non devi copiare nessuna chiave.
Solo gli admin collegano
I collaboratori non possono collegare un'app AI al tuo account. Ogni collegamento vale per un solo account.
Ruolo controllato a ogni richiesta
Se un admin diventa collaboratore o lascia il tuo team, il suo collegamento termina alla richiesta successiva.
Accessi rubati inutili
Se qualcuno usa una seconda volta un accesso già utilizzato, SmartChat interrompe l'intero collegamento.
Le richieste ripetute non vengono inviate due volte.
Molti programmi ripetono una richiesta se la risposta tarda troppo. Se il tuo programma invia anche un Idempotency-Key, SmartChat esegue la richiesta una sola volta e a ogni ripetizione restituisce la stessa risposta.
curl -X POST https://api.smartchat.marketing/v1/messages \ -H "Authorization: Bearer LA_TUA_CHIAVE_API" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: promemoria-appuntamento-4711" \ -d '{"contact_id": "ID_CONTATTO", "text": "A domani alle 10!"}' # Risposta 201: il messaggio parte { "ok": true, "message_id": "…" }# La stessa richiesta con la stessa Key, ad esempio dopo un timeout # Risposta: esattamente la risposta della prima richiesta Idempotent-Replayed: true { "ok": true, "message_id": "…" } # Il messaggio non viene inviato di nuovo.# Stessa Key, ma un testo diverso # Risposta 422 { "error": { "key": "idempotency_key_mismatch", "message": "This Idempotency-Key was already used for a different request." } }I tuoi webhook sono protetti.
Un programma avvia le tue automazioni solo tramite un indirizzo segreto, il tuo sito con una chiave propria. I messaggi che SmartChat invia al tuo sistema hanno una firma.
Indirizzo segreto per ogni automazione
Solo chi conosce l'indirizzo avvia la tua automazione. Appartiene a una sola automazione del tuo account.
<script src="…"></script> <script> smartchatTrigger({ "email": "{{email}}" }); </script>Chiave propria per il tuo sito
Sul tuo sito l'indirizzo segreto non compare mai. Se un browser lo richiama comunque, SmartChat lo rifiuta.
1ª chiamata → L'automazione parte. 2ª chiamata, stesso evento → Questo evento è già stato elaborato.Ogni evento una sola volta
Se un programma invia di nuovo lo stesso evento poco dopo, SmartChat riconosce la ripetizione e non invia nulla due volte.
X-SmartChat-Event: contact.created X-SmartChat-Timestamp: 1792400000 X-SmartChat-Signature: v1=…Messaggi firmati al tuo sistema
Ogni messaggio di SmartChat porta data, ora e firma. Così il tuo sistema verifica che arrivi davvero da SmartChat.
https://… consentito http://… rifiutatoSolo verso indirizzi sicuri
SmartChat invia solo a indirizzi https su internet pubblico e non segue reindirizzamenti. Se il tuo sistema non è raggiungibile, SmartChat riprova più tardi.
Domande frequenti su API e webhook.
SmartChat può mostrarmi di nuovo la mia chiave API?
No. SmartChat mostra la chiave completa solo subito dopo averla creata e poi salva solo un valore di controllo. Nell'elenco vedi solo l'inizio e gli ultimi quattro caratteri. Se perdi una chiave, ne generi una nuova.
Cosa succede se una chiave API finisce nelle mani sbagliate?
La rigeneri o la elimini nelle impostazioni in Integrazioni. Da quel momento SmartChat rifiuta ogni richiesta con la vecchia chiave. Per ogni chiave vedi anche quando è stata usata l'ultima volta.
Cosa può fare una chiave API?
Esattamente quello che scegli quando la crei: Solo lettura oppure Lettura e scrittura. Se un programma chiede qualcosa per cui la chiave non ha il permesso, SmartChat rifiuta la richiesta.
Chi può creare chiavi API e collegare app AI?
Solo gli admin del tuo account. I collaboratori non possono né creare chiavi né collegare un'app AI. Chi perde il ruolo di admin perde, alla richiesta successiva, anche le app AI che ha collegato. Maggiori dettagli in Team.
Un programma può inviare a qualsiasi numero tramite l'API?
No. Anche tramite l'API le newsletter partono solo dopo la conferma. Chi si è disiscritto con STOP non riceve più nulla, da qualunque programma arrivi la richiesta.
Cos'è un Idempotency-Key?
Un testo a scelta che il tuo programma invia nell'intestazione di una richiesta, per esempio il numero di una prenotazione. Se la stessa richiesta arriva di nuovo con la stessa key, SmartChat non la esegue un'altra volta e restituisce la prima risposta.
Cosa succede se il mio programma usa la stessa key per un'altra richiesta?
SmartChat rifiuta la seconda richiesta, perché la key appartiene già a un'altra richiesta. Se la prima richiesta è ancora in corso, SmartChat chiede al tuo programma di riprovare tra poco.
Come verifica il mio sistema che una notifica arriva davvero da SmartChat?
Quando crei un abbonamento webhook ricevi un segreto. Con questo il tuo sistema calcola da solo la firma da timestamp e contenuto e la confronta con l'intestazione X-SmartChat-Signature. Se il timestamp è troppo vecchio, scarti la notifica.
Cosa succede se il mio sistema non accetta una notifica?
SmartChat riprova più tardi.
SmartChat salva i contenuti delle notifiche inviate al mio sistema?
No. SmartChat si ricorda solo quale notifica è ancora in attesa e legge il contenuto solo al momento dell'invio. Se nel frattempo un contatto è stato eliminato, su di lui non parte più nulla. Prima di ogni invio SmartChat controlla anche che l'abbonamento sia attivo e che la chiave sia ancora valida.
Cosa faccio se l'indirizzo webhook di un'automazione finisce nelle mani sbagliate?
Apri l'automazione e generi un nuovo indirizzo. Quello vecchio poi non funziona più. Inserisci il nuovo indirizzo in tutti i programmi che inviano eventi a SmartChat. Il codice sul tuo sito resta lo stesso.
Dove trovo la guida tecnica all'API?
Nella Guida rapida all'API. Tutto quello che puoi fare con l'API lo trovi in API.
Collega i tuoi programmi in modo sicuro a SmartChat.
Inserisci il tuo sito web. SmartChat AI crea il tuo sistema di marketing su WhatsApp in 60 secondi, gratis. La tua prima chiave API la crei poi nelle impostazioni.