Przejdź do treści

Czym są webhooki i jak je uruchomić?

A

Czym są webhooki i jak je uruchomić?

Category: Integracje

Webhooki to automatyczne wiadomości wysyłane z jednej aplikacji do drugiej, gdy coś się dzieje. Przypominają powiadomienia SMS wysyłane przez twój bank, np. po otrzymaniu płatności. Zachodzi akcja (zapłata), a następnie reakcja banku (SMS). Podobnie działają webhooki.

W ten sposób Konfeo może wysyłać powiadomienia do innej aplikacji, gdy ktoś zarejestruje się na bezpłatne wydarzenie lub zapłaci za płatne wydarzenie (gdy status uczestnika zmieni się na zaakceptowany). Powiadomienia zawierają: imię i nazwisko, adres e-mail, tytuł wydarzenia, nazwę biletu/miejsca, cenę i walutę, informacje o dodatkowych uczestnikach.

Struktura webhooków wygląda następująco:

{
    "type": "attendee_accepted",
    "attendee": {
        "id": 123,
        "name": "John",
        "surname": "Doe",
        "email": "john@doe.com"
    },
    "fee": {
        "price": 123.45,
        "currency": "USD"
    },
    "event": {
        "id": 234,
        "name": "Event name"
    },
    "group": {
        "id": 345,
        "name": "Group name"
    },
    "form_fields": [
        {
            "id": 45,
            "type": "text",
            "label": "Phone",
            "value": "123 456 789"
        },
        {
            "id": 46,
            "type": "text_area",
            "label": "Bio",
            "value": "Text"
        },
        {
            "id": 47,
            "type": "select",
            "label": "Food type",
            "value": "vegetarian"
        },
        {
            "id": 48,
            "type": "select",
            "label": "Weather",
            "value": null
        },
        {
            "id": 49,
            "type": "radio",
            "label": "T-shirt size",
            "value": "L"
        },
        {
            "id": 50,
            "type": "check_box",
            "label": "Newsletter",
            "value": true
        },
        {
            "id": 51,
            "type": "check_box",
            "label": "Marketing",
            "value": false
        }
    ],
    "additional_attendees": [
        {
            "id": 124,
            "name": "Jane",
            "surname": "Doe"
        }
    ]
}

Uruchomienie wysyłki webhooków jest bardzo proste – wystarczy podać w zakładce Ustawienia wydarzenia | Webhooki adres URL, na który Konfeo ma je wysyłać. To wszystko.

Permalink