Centro assistenzaIntegrazioni

Per: Amministratori

Configura un webhook per l'attività del feed

Invia un messaggio al tuo sistema ogni volta che un post, un commento o un allegato viene aggiunto, modificato o eliminato.

In questo articolo8 sezioni

A WebhookWebhook Un indirizzo che fornisci all'hub in modo che possa inviare un messaggio ai tuoi sistemi ogni volta che un post o un commento del feed subisce delle modifiche. Inoltra un messaggio al proprio sistema ogni volta che si verifica qualcosa nel caso selezionato. Fornire informazioni/ricompenseAlimentazione La cronologia dei post relativi a un caso, in cui lo studio legale condivide notizie e tutti coloro che sono coinvolti nel caso possono commentare., Ad esempio, un nuovo messaggio o un commento. Ogni messaggio viene crittografato; quindi, il sistema che lo riceve ha bisogno del codice di un programmatore per poterlo leggere.

  1. Webhook aperti

    Vai a Integrazione › Webhook e seleziona NUOVO.

  2. Inserisci l'indirizzo

    Sotto URL, inserite l’indirizzo del sistema in cui vengono ricevute le messaggi. Ad esempio: https://crm.example.com/hooks/caseactive. L’indirizzo deve iniziare con https:// o http:// e deve essere accessibile tramite Internet. Le lettere maiuscole vengono mantenute durante la scrittura dell’indirizzo.

    Descrizione è opzionale: si tratta di una nota da condividere con il proprio team, ad esempio informazioni riguardanti i casi che vengono seguiti nel sistema CRM.

  3. Scegli gli eventi

    Sotto eventi, selezionare quelli che dovrebbero inviare dei messaggi: ad esempio il post è stato creato e il commento del post è stato creato. In totale, ci sono dieci elementi che possono essere aggiunti o rimossi: post, commenti sui post, file. “Informazioni sugli eventi webhook e sui dati inviati” indica cosa viene inviato da ciascun elemento.

  4. Accendilo e salva

    Attivo inizia da questo punto. Lasciato attivo: un webhook inattivo non riceve alcun messaggio; tutto ciò che manca viene inviato in seguito. Scegliete SALVA. Viene visualizzato il messaggio “Webhook aggiunto”.

  5. Mantieni il segreto

    La finestra Webhook segreto mostra la “chiave segreta” del webhook: si tratta della chiave privata che permette di accedere a ogni messaggio inviato tramite il webhook. Questa informazione viene visualizzata soltanto una volta. Selezionare Scarica come file .pem per salvarla come file, oppure Copia negli appunti per copiare l’intero contenuto, comprese le righe di testo. È necessario trasmettere questa informazione al proprio sviluppatore, ad esempio tramite un gestore di password. Infine, selezionare Fatto.

  6. Provalo

    È necessario aggiungere una breve descrizione per ogni caso, senza che quel caso abbia davvero clienti. Si tratta di uno dei due esempi di casi presentati all’inizio del progetto. Il sviluppatore deve verificare che il messaggio sia stato ricevuto e che il codice segreto riesca a leggerlo correttamente.

Cosa succederà dopo?

Ogni volta che un evento specificato avviene in qualsiasi caso nel tuo hub, il webhook invia un messaggio al tuo sistema. Il messaggio indica chi è stato a effettuare la modifica: il tuo team, un cliente, l’Assistente VirtualeAssistente virtuale Un membro automatizzato del team che pubblica messaggi di benvenuto, check-in e post di aggiornamento per l'azienda; i suoi post sono contrassegnati da un badge di Assistente Virtuale., oppure una chiave API. Nessun altro viene informato di questo.

Se due tentativi di invio falliscono consecutivamente, il webhook si interrompe e viene inviata un’e-mail a ciascun amministratore. Vedi qui per maggiori informazioni. È necessario risolvere il problema relativo al webhook che smetteva di inviare i messaggi.. Per modificare l’indirizzo o gli eventi, selezionare l’icona a forma di matita. Modifica webhook, Nel suo posto, il segreto rimane lo stesso.

Se qualcosa va storto

  • Il limite impostato per i Webhook è stato raggiunto. Il tuo hub può avere fino a cinque webhook. Elimina quello che non utilizzi più: seleziona l’icona del contenitore in cui vengono conservati i webhook. Elimina il webhook, Sul suo posto, allora. Elimina. Si ferma immediatamente e non può essere riattivato.
  • L’URL è invio. Esempio: https://example.com/hook È necessario inserire l’intera intestazione web, iniziando con “https://” o “http://”. Le intestazioni che funzionano soltanto sul proprio computer non sono accettate.
  • Hai perso il segreto. Non è possibile mostrarlo di nuovo. È necessario aggiungere un nuovo webhook con lo stesso indirizzo e gli stessi eventi. Dare il segreto a tuo sviluppatore, poi eliminare l’originale.

Articoli correlati

Consulta gli eventi e i payload dei webhook.Cosa invia ciascuno dei dieci eventi del feed, come viene crittografato il messaggio e come decrittografarlo con la tua chiave segreta.IntegrazioniRisolvi un webhook che ha smesso di inviarePerché un webhook si disattiva dopo due consegne fallite o quando è inattivo, e come salvarlo nuovamente lo riattiva.IntegrazioniComprendere cosa può fare l'APIScopri quali funzioni possono svolgere un tasto di gestione e un tasto hub, perché ogni tasto funge da Assistente Virtuale e dove trovare l'elenco tecnico completo.Integrazioni