En webhook sender hendelser fra Brigg til et annet system automatisk. Åpne Bedriftens innstillinger › Webhooks for å administrere dem. Bare eiere og administratorer i arbeidsområdet kan gjøre dette. Admin

Hva som sendes
Under Hendelse velger du hva som skal utløse en levering:
- Ressurs oppdatert er standardvalget. Det varsler systemet deres når et publisert felt på en delt ressurs endres.
- Ressurs opprettet varsler systemet deres når en ressurs opprettes eller gjøres delt.
- Ressurs slettet varsler systemet deres når en ressurs slettes eller gjøres privat.
- Møte fullført (eldre eksport) sender møtereferatet og hele vertens private transkripsjon, inkludert deltakeropplysninger. Når du oppretter denne webhooken, godkjenner du uttrykkelig at innholdet eksporteres til det valgte endepunktet. Det sendes når referatet er klart, og på nytt hvis møtet tas opp på nytt.
De tre ressurshendelsene bruker v1. De dekker bare de publiserte, delte ressurstypene du velger. De inneholder ressursidentifikatorer og, ved opprettelse og oppdatering, publiserte feltnavn, slik at systemet deres kan hente den gjeldende ressursen gjennom API-et. De inneholder ingen feltverdier eller private ressurser. Nye ressurstyper legges aldri til i abonnementet automatisk.
Publiserte, delte data omfattes også når endringene kommer fra API-et, importer og bakgrunnsoppdateringer. Private data, prosjektdata og interne medlemsprofiler er unntatt. Se veiledningen om hendelser for detaljer.
Opprette en webhook
Under Opprett webhook velger du Hendelse og skriver mottakeradressen i Mottakeradresse. Det må være en offentlig tilgjengelig HTTPS-adresse. Hver hendelse kan ha opptil tre endepunkter.
For en v1-hendelse bruker du App til å filtrere de publiserte ressurstypene. Standardvalget Alle apper viser hele listen. Kryss av for minst én ressurstype. Velg alle viste ressurser velger hele listen; når du filtrerer etter app, velger knappen appens ressurstyper. Fjern valg fjerner valget for typene som vises. Valgene beholdes når du endrer filteret.
Kontroller mottakeradressen, hendelsen og de valgte ressurstypene, og trykk Opprett webhook. En agent kan forberede et forslag, men en person må åpne Se gjennom webhook-forslag, kontrollere oppsettet og trykke Godkjenn og opprett før webhooken blir aktiv.
Etter opprettelsen lagrer du signeringsnøkkelen i mottakersystemet og behandler den som et passord. Bruk Kopier signeringsnøkkel for å kopiere den og Skjul for å skjule den på skjermen.
Reglene for endepunktet ditt
- Endepunktet må svare innen 10 sekunder. Omdirigeringer følges ikke.
- Brigg gjør opptil åtte forsøk per levering over omtrent 24 timer.
- Ved HTTP 429 og 503 følger Brigg
Retry-Afternår det angir lengre ventetid. - Etter 10 leveringer på rad som mislykkes etter alle nye forsøk, blir webhooken slått av. Aktiver gjenopptar leveringene og nullstiller antallet feil.
Hvis gjentatte feil fører til at en webhook blir deaktivert, får eiere og administratorer et varsel i samtalen sin i Brigg. Rett feilen hos mottakeren og test leveringen før du aktiverer webhooken igjen. Send lagrede, mislykkede leveringer på nytt, og avstem data som ble endret mens webhooken var deaktivert.
I listen
Hver webhook viser adressen, hendelsen, versjonen og siste vellykkede levering. V1-webhooks viser også antallet valgte ressurstyper. Listen markerer webhooks som er slått av, og viser feil på rad.
- Kopier signeringsnøkkel kopierer signeringsnøkkelen for en eksisterende webhook.
- Send test sender en eksempelhendelse og forteller deg om endepunktet godtok den. Tester eksporterer ikke en faktisk ressurs eller et faktisk møte og vises ikke i leveringshistorikken.
- Deaktiver / Aktiver stopper eller gjenopptar leveringene.
- Slett fjerner webhooken etter bekreftelse. Signeringsnøkkelen kan ikke hentes tilbake etter sletting.
Leveringshistorikk
For v1-webhooks åpner du Leveringshistorikk · 30 dager for å se lagrede leveringer, hendelse, dato, status, antall forsøk, HTTP-status, feil og hendelses-ID. Oppdater oppdaterer listen; Last flere viser eldre leveringer når de finnes.
Send på nytt sender en lagret levering på nytt. Webhooken må være slått på, og leveringen må være avsluttet. Brigg kontrollerer den gjeldende mottakeradressen og tilgangen før leveringen sendes på nytt. Den bruker samme hendelsesidentitet, så systemet deres må håndtere duplikater. Historikk og ny sending er tilgjengelig i 30 dager; den eldre møteeksporten har ingen leveringshistorikk her.
Motta og verifisere hendelser
Åpne Motta og verifisere hendelser for å se kravene til mottakeren. V1-signaturer dekker signeringstidspunktet og det nøyaktige innholdet i forespørselen. Systemet deres må verifisere signaturen, avvise gamle tidsstempler og håndtere duplikater eller hendelser som kommer i feil rekkefølge. Den eldre møteeksporten beholder sitt opprinnelige signaturformat.
Bruk Webhook-dokumentasjon (engelsk) for å åpne den engelske webhook-veiledningen, med eksempler på innholdet og instruksjoner for verifisering.