Webhook-uri
Anunță alt sistem în momentul în care o rezervare este confirmată sau o factură este emisă, în loc să interogheze periodic sau să rescrie cineva manual.
Un webhook este un mesaj pe care Voyant îl trimite altui sistem atunci când se întâmplă ceva. Programul tău de contabilitate află despre o rezervare confirmată în secunda în care este confirmată.
Apasă Setări, apoi Webhook-uri. Ai nevoie de cineva tehnic care să le primească, dar alegerea a ceea ce se trimite îți aparține.
Creează unul
- Apasă Adaugă abonament.
- Introdu Endpoint URL, care trebuie să fie
https://. - Scrie o Descriere care spune la ce folosește.
- Bifează Evenimentele pe care le vrei.
- Apasă Creează abonament.
Evenimentele
Se împart în două grupuri.
Catalog și rezervări
catalog.booking.committed, catalog.booking.cancelled, plus un set de evenimente catalog.entity.* pentru produse create, actualizate, arhivate, șterse, reevaluate ca preț sau cu disponibilitatea modificată. Plus catalog.source.disconnected și catalog.source.reconnected pentru conexiunile de furnizare care cad.
Facturi
invoice.issued, invoice.proforma.issued, invoice.proforma.converted, invoice.payment.recorded și invoice.voided.
Fiecare are un număr de versiune, așa că forma mesajului este stabilă și afli când se schimbă.
Abonează-te doar la ce vei folosi
Este tentant să bifezi tot. Nu o face. Fiecare eveniment este un mesaj pe care cineva trebuie să îl trateze, iar un eveniment nefolosit este zgomot care ascunde o eroare reală.
Majoritatea operatorilor vor trei: booking committed, booking cancelled, invoice issued.
Secretul de semnare
Când creezi un abonament, Voyant afișează o singură dată un secret de semnare.
Sistemul tău îl folosește ca să verifice că un mesaj a venit într-adevăr de la Voyant și nu a fost falsificat de cineva care ți-a ghicit endpointul. Păstrează-l acolo unde ții parolele.
Dacă închizi fereastra fără să îl copiezi, șterge abonamentul și creează-l din nou.
Formatul mesajului
Structurile payload-urilor sunt documentate la voyant.travel/docs.
Ai găsit răspunsul căutat?
Mulțumim pentru feedback.