Vai al contenuto
Canali e integrazioni

Webhook

Avvisa i tuoi altri strumenti nel momento in cui succede qualcosa in Entagl.

Panoramica

Un webhook è un breve messaggio che Entagl invia a un altro strumento quando succede qualcosa nel tuo workspace: una nuova prenotazione, una chat chiusa, un ordine pagato. Scegli gli eventi e incolla l'indirizzo web (URL) fornito dall'altro strumento. Da quel momento Entagl invia lì i dettagli entro pochi secondi, così il tuo CRM, foglio di calcolo o scenario di Make può reagire senza che nessuno copi i dati a mano. Lo trovi in Canali → Webhook.

Per gli sviluppatori: riferimento API
Ogni endpoint, campo ed evento webhook, con esempi di codice.

Funzionalità

Scegli gli eventi che ti interessano

Gli eventi sono organizzati in gruppi: Contatti, Conversazioni, Messaggi, Passaggi al team, AI agent, Prenotazioni, Promemoria, Ordini, Prodotti, Chiamate, Campagne, Moduli, Account e canali, e Impostazioni del workspace. Apri un gruppo e seleziona i singoli eventi, oppure premi Seleziona tutto per prendere l'intero gruppo. Non sai dove si trova qualcosa? Scrivilo nel campo di ricerca, per esempio "booking" o "tag". Tocca un evento per vedere un esempio esatto di ciò che invierà Entagl. Alcuni eventi ti permettono anche di scegliere da dove provengono, così puoi ricevere solo le prenotazioni create dalla tua AI ed escludere quelle inserite dal team nel calendario.

Messaggio in arrivo e messaggio in uscita: leggi prima l'avviso

Messaggio in arrivo e Messaggio in uscita si attivano per ogni singolo messaggio. In un account molto attivo possono essere migliaia al giorno. Per questo Seleziona tutto li salta: devi selezionarli uno a uno, accanto a un avviso. Attivali solo se lo strumento dall'altra parte può gestire un volume così alto. Se vuoi solo sapere quando una chat inizia o finisce, Conversazione aperta e Conversazione chiusa generano molto meno traffico.

I dati dei clienti restano fuori, a meno che tu non decida di includerli

Due interruttori decidono quante informazioni del cliente escono da Entagl. Includi il contenuto dei messaggi aggiunge ciò che hanno scritto i clienti: messaggi, note e riepiloghi delle chiamate. Includi i dettagli del contatto aggiunge nome, numero di telefono ed email del cliente. Entrambi sono disattivati all'inizio. Ricevi comunque tutti gli eventi anche senza di essi, con un ID contatto al posto dei dettagli. Solo il proprietario del workspace o un admin può attivarli, e solo se lo strumento che riceve i dati è autorizzato a conservarli. In un workspace HIPAA i dati dei clienti non vengono mai inviati, qualunque cosa dicano gli interruttori.

App collegate

Strumenti e sviluppatori possono registrare i propri webhook tramite l'API di Entagl e compaiono da soli in App connesse. Per ciascuno vedi quanti eventi ascolta e quando ne ha ricevuto l'ultimo. Puoi aprire le sue Consegne recenti, usare Metti in pausa e Riprendi, oppure Rimuovi. Gli scenari Make hanno una pagina tutta loro: Canali → Make.

Vedi cosa è stato inviato e reinvialo

Premi Invii recenti per vedere gli ultimi 50 eventi che Entagl ha provato a inviare, in ordine dal più recente. Per ciascuno vedi se è arrivato, la risposta restituita dallo strumento (come 200 o 500), quanti tentativi sono serviti e quando è previsto il prossimo. Quando un invio è fallito definitivamente, risolvi il problema dalla tua parte e premi Invia di nuovo. Entagl lo reinvia entro pochi secondi.

Tentativi di nuovo e cosa succede quando uno strumento continua a fallire

Se il tuo strumento è inattivo o risponde con un errore, Entagl riprova dopo 30 secondi, 2 minuti, 10 minuti, 1 ora, 6 ore e 24 ore. Sono circa 31 ore prima che un invio venga segnato come fallito. Se un'app collegata continua a fallire per 3 giorni di fila, Entagl la mette in pausa e invia una notifica al proprietario del workspace. Sistema lo strumento, poi premi Riprendi. Se Make segnala che il webhook di uno scenario non esiste più, Entagl smette subito di inviare lì.

Verifica che una richiesta provenga davvero da Entagl

Ogni richiesta include una firma nell'header X-Entagl-Signature, creata con il tuo signing secret. Il tuo sviluppatore la usa per dimostrare che la richiesta proviene da Entagl e che nessuno l'ha modificata durante il percorso.

  • App collegate e webhook creati tramite l'API inviano t=1767225600,v1=5257a869…. La parte t indica quando è stata inviata, in secondi. Ogni v1 è un HMAC-SHA256 del testo timestamp.body (il valore t, un punto, poi il corpo grezzo della richiesta), creato con il tuo secret. Rifiuta qualsiasi richiesta il cui t abbia più di 5 minuti, così una richiesta vecchia non può essere riprodotta. Subito dopo un cambio di secret potresti vedere due valori v1: accetta la richiesta se uno dei due corrisponde.
  • Il webhook configurato in questa pagina invia sha256= seguito da un HMAC-SHA256 del corpo grezzo della richiesta.

Attività comuni

Collega un webhook

Circa 3 min
  1. Vai su Canali e apri Webhook.
  2. Incolla in URL del webhook l'URL fornito dall'altro strumento. Deve iniziare con https://.
  3. In Eventi, seleziona ciò che vuoi ricevere. Lascia disattivati i due interruttori sui dati del cliente, a meno che lo strumento ricevente non abbia davvero bisogno di nomi o messaggi.
  4. Salva. Copia il signing secret dalla finestra che si apre e conservalo in un posto sicuro. Viene mostrato solo una volta.
  5. Controlla che l'interruttore in alto nella scheda sia attivo e mostri Attivo. Da quel momento gli eventi iniziano a fluire.

Testa il tuo webhook

Circa 1 min
  1. Apri Canali → Webhook e trova Test di consegna.
  2. Premi Invia test. Entagl invia subito un evento di esempio al tuo URL.
  3. Leggi il risultato. Test inviato significa che il tuo strumento ha risposto. Se è fallito, il messaggio ti spiega perché (ad esempio un timeout), così puoi sistemare il problema e riprovare.

Suggerimenti

Ogni richiesta ha un event ID nell'header X-Entagl-Event-Id. Se arriva un retry per qualcosa che il tuo strumento ha già gestito, usa quell'ID per ignorarlo.
Nel webhook che configuri in questa pagina, Appuntamento creato e Documenti della prenotazione aggiunti vengono inviati una sola volta, nel momento in cui accadono, senza il programma di retry. Mantieni raggiungibile quell'URL.
Rispondi in fretta. Il tuo strumento dovrebbe restituire un codice di successo (qualsiasi 2xx) entro 5 secondi e fare il lavoro lento dopo. Una risposta lenta conta come errore e viene ritentata.
Metti in pausa è l'opzione più soft: la connessione resta, non viene inviato nulla, e Riprendi riprende con i nuovi eventi. Rimuovi elimina la connessione.

Domande frequenti

Questa pagina ti è stata utile?