Webhooks
Hva webhooken sender
En webhook er en adresse hos deg som BulkGate rapporterer til om hva som har skjedd
med meldingene dine. Portalen kaller den Leveringsrapporter, men sender to ting
til den samtidig:
| Hva som kommer | Hvordan du kjenner det igjen |
|---|---|
| Leveringsrapport | En post med statusen til en sendt melding og dens smsID |
| Innkommende SMS (et svar) | En post med status 10, avsenderen i from og meldingsteksten |
Det er altså ikke to separate innstillinger — én adresse håndterer både leveringsrapporter og svar.
Dataformatet avhenger av om massesending er slått på:
| Modus | Hvordan dataene kommer | Formatet er beskrevet på |
|---|---|---|
| standard | Én forespørsel per melding, med GET | Leveringsbekreftelser |
Bulk DLRs - bulk forespørsel |
En samling poster, med POST og application/json |
Leveringsbekreftelser for masseutsendinger |
Hvor webhooken angis
Stedet avhenger av hvilket grensesnitt du bruker. De to første trinnene er de samme i
alle tilfeller — klikk på Moduler og APIer i portalmenyen og åpne kortet for
applikasjonen din under Mine APIer og moduler.
| Grensesnitt | Hvor i applikasjonsdetaljene |
|---|---|
| HTTP API | Fanen Innstillinger, delen Web hooks, kortet Leveringsrapporter |
Email > SMS |
Bare E-postleveransrapporter — rapportene kommer på e-post, ikke til en URL |
Slik slår du på webhooken
Kortet viser om noe er angitt. Så lenge ingenting er det, viser det
Du har ingen innstillinger. og knappen Konfigurer.
Knappen Konfigurer (eller Redigere hvis du allerede har innstillinger) åpner
vinduet Innstillinger for leveringsrapporter.
Skriv inn en adresse som begynner med http:// eller https:// i feltet URL-leveringsrapporter
— portalen godtar ingen annen skrivemåte. Tre avkrysningsbokser hører
til:
| Alternativ | Hva det gjør |
|---|---|
Slå av sjekk for tilgjengelighetsadresser |
Portalen sjekker ikke at adressen svarer før lagring |
Rapporter kun når feil oppstår |
En rapport kommer bare for en mislykket melding |
Bulk DLRs - bulk forespørsel |
Rapportene kommer samlet i stedet for én og én |
Du lagrer oppsettet med knappen Lagre.
Massesending er nyttig ved store volumer — i stedet for én forespørsel per melding kommer én enkelt forespørsel med en array av poster. Formatet for samlingen er beskrevet på Leveringsbekreftelser for masseutsendinger.
Når webhooken er angitt, viser kortet tre rader — URL med adressen, og
et ikon for hver av Rapporter kun når feil oppstår og Bulk DLRs - bulk forespørsel
som viser om de er slått på.
Slik fjerner du webhooken
Pilen ved siden av knappen Redigere åpner en meny med valget Slett. Bekreftelsesvinduet
Slett innstillinger advarer om at du mister innstillingene for
leveringsrapporter, og at de slutter å komme.
Når du fjerner webhooken, stopper også innkommende meldinger — svar på SMS-ene dine har ingen steder å bli levert.
Takk for tilbakemeldingen.