Konfiguracja webhooków w SalesCRM
W jaki sposób działa funkcja Webhooki w SalesCRM?
Webhook w tworzeniu stron internetowych to metoda rozszerzania lub zmieniania zachowania strony internetowej lub aplikacji internetowej za pomocą niestandardowych wywołań zwrotnych.
1. Aby odnaleźć integrację w panelu, zaloguj się na swoje konto, przejdź do zakładki konfiguracja, następnie wybierz integracje.
2. Na samym dole odnajdziesz pozostałe zewnętrzne systemy, w tym Webhooki.
3. Aby skonfigurować webhooki w SalesCRM, wciśnij opcję "edytuj", a później "+dodaj".
4. Kolejnym krokiem jest konfiguracja nowego webhooka.
- aktywuj webhook
- wybierz status zamówienia z systemu
- określ typ webhooka. Podstawowy webhook w formacie key-value lub Zaawansowany webhook w formacie JSON
- dodaj adres URL
- wpisz klucz zabezpieczający (klucz zabezpieczający służy do weryfikacji, czy webhook pochodzi z SalesCRM - chcemy uniknąć odbierania webhooków z nieznanych źródeł. Używany jest do generowania podpisu, który przekazywany jest w nagłówku SHOPLO_HMAC_SHA256 i obliczany w nastepujący sposób w języku Ruby:
Base64.urlsafe_encode64(OpenSSL::HMAC.hexdigest(OpenSSL::Dig est::SHA256.new, webhook_secret_key, body_json))
- potwierdź poprzez przycisk "utwórz".
"order": {
"order_identifier": "#1111",
"email_address": "email",
"first_name": "Testowe",
"last_name": "G",
"delivery_address": "Testowa 14",
"delivery_city": "Miasto",
"delivery_postal_code": "01-120",
"delivery_country": "Polska",
"invoice_company_name": "Nazwa firmy",
"invoice_nip": "1112223322",
"invoice_address": "ul. Nowowiejska 14",
"invoice_city": "Miasto",
"invoice_postal_code": "01-120",
"invoice_country": "Polska",
"payment_type": "PayU",
"delivery_type": "Paczkomat InPost",
"currency": "PLN",
"placed_at": "2021-11-17T20:57:33.447+01:
"products_cost": "314.9",
"delivery_cost": "0.0",
"delivery_vat_rate": 23,
"payment_cost": "0.0",
"payment_vat_rate": 23,
"gift_packing_cost": "0.0",
"discount": "0.0",
"total": "314.9",
"status": "Wysłane",
"order_items": [
{
"product_id": 1154,
"name": "Testowy",
"sku": "Test",
"unit_price": "17.9",
"vat_rate": 23,
"quantity": 1,
"discount": "0.0"
},
{
"product_id": 3951,
"name": "Testowy",
"sku": "Test",
"unit_price": "297.0",
"vat_rate": 23,
"quantity": 1,
"discount": "0.0"
}
]
}
}