LEKCJA 3 – Konfiguracja szablonu wiadomości (treść i załącznik)

Ostatnia aktualizacja: 31.08.2023 10:36
Dotyczy rozwiązania: Program dla hoteli KWHotel
Kliknij tutaj, aby zgłosić sugestie lub uwagi do tego artykułu
Instrukcja video:
LINK

SPIS TREŚCI (kliknij na nazwie, aby szybko przejść do tego fragmentu artykułu)

◾ Tworzenie szablonu wysyłki od podstaw – TREŚĆ
◾ (VIDEO) Wysyłanie SMSów z KWHotel
◾ Tworzenie szablonu wysyłki od podstaw – ZAŁĄCZNIK
◾ (VIDEO) Zobacz instrukcję video
◾ Lista zmiennych dla wiadomość HTML / XML (lista aktualizowana)

W poprzednim materiale wspólnie skonfigurowaliśmy kryteria wysyłki wiadomości. Pozostaje nam wybranie odpowiedniego szablonu.

📌 PORADA

Szablon to kombinacja treści i załącznika w Twojej wiadomości. Oczywiście możesz również stworzyć szablon zawierający jedynie załącznik z potwierdzeniem rezerwacji, czy zwykłą wiadomość SMS.

Tworzenie szablonu wysyłki od podstaw – TREŚĆ

Wróćmy do naszego kreatora wiadomości. W poprzedniej lekcji zatrzymaliśmy się na wyborze szablonu.

Jeżeli posiadasz już odpowiedni szablon, wystarczy wybrać go z listy i kliknąć Next.

Wybrany szablon możesz edytować w każdej chwili.

W tym materiale skupimy się na stworzeniu nowego szablonu od podstaw. Wybierzemy domyślne potwierdzenie rezerwacji KWHotel, które będzie wysyłane jako PDF w załączniku maila, a także napiszemy treść samej wiadomości.

Kliknij przycisk Nowy szablon.

Na początek nazwij szablon. W moim przypadku będzie to “Potwierdzenie rezerwacji My Dream Hotel”.

Poniżej znajdziesz zakładki Treść i Załącznik. Zacznijmy od Treści.

Znajdziesz tu 5 opcji:

Plik FRX: to format, który możesz edytować we wbudowanym programie Fast Report. Zapewnia on duże możliwości konfiguracji, ale jednocześnie wymaga nieco czasu, aby opanować jego obsługę.

Wiadomości SMS – jeżeli założysz konto w portalu SMSAPI oraz aktywujesz u nas opcję Synchronizacji z SMSAPI, możesz zacząć wysyłać SMSy bezpośrednio z programu KWHotel. Więcej o wysyłce SMSów z programu KWHotel znajdziesz w poniższej instrukcji video.

Plik HTML / XML: pozwala na stworzenie wiadomości, korzystając z prostego edytora HTML. Bardzo polecam Ci tę opcję, ponieważ możesz szybko przygotować atrakcyjną wizualnie wiadomość, a dodatkowo możesz automatycznie podstawiać wiele danych z programu KWHotel.

Treść – pozwala na wpisanie prostej wiadomości do treści maila. Tutaj również możesz podstawiać dane z programu KWHotel, jednak nie masz wpływu na sferę wizualną wiadomości.

URL – pozwala wprowadzić adres URL, który będzie wyświetlany przez program KWHotel.

Tym razem wybierzmy opcję Plik HTML / XML.

Kliknij opcję Nowy plik.

Znajdujemy się teraz w oknie tworzenia plików HTML.

W lewym górnym rogu znajdziesz dwie opcje:

File – pozwala wczytać istniejący plik HTML lub zapisać ten, który właśnie edytujesz.

Insert data – tutaj możesz wybrać parametry, które KWHotel będzie automatycznie wczytywał z bazy danych i podstawiał je w mailu. Za chwilę wykorzystamy kilka z nich.

Na środku zobaczysz pasek narzędzi – działanie każdej opcji możesz sprawdzić po najechaniu na jej ikonę.

Zaczynamy tworzenie wiadomości.

Na początek dodajmy logo naszego hotelu. Zalecamy, aby logo hotelu umieścić na serwerze i pobrać jego adres URL. Wówczas kliknij ikonę Image, a w polu Źródło obrazu wklej adres URL. Teraz naciśnij przycisk Enter.

Do wiadomości możesz wstawić dynamiczne zmienne – są to informacje pokroju Daty rozpoczęcia pobytu lub Ceny za rezerwację, które KWHotel pobiera bezpośrednio z bazy danych i umieszcza w szablonie.

Przykładowo: Państwa pobyt rozpocznie się w dniu {{Stay.From}}.

📌 PORADA

Opis dostępnych zmiennych znajdziesz na końcu tego artykułu.

Gdy skończysz pracę nad tekstem i jego formatowaniem, warto go zapisać jako plik. Dzięki temu będziesz mógł go w przyszłości wykorzystać jako podstawę tworzenia kolejnego szablonu HTML. Oszczędzisz w ten sposób sporo czasu!

📌 PORADA

Rekomendujemy, aby wszystkie szablony zapisywać w folderze KWHotel > Doc > pl (np. C:/Kajware/KWHotel Pro/Doc/pl). Dzięki temu nie ryzykujesz przypadkowego usunięcia szablonu, a na dodatek KWHotel będzie domyślnie wczytywał powyższą ścieżkę podczas wyszukiwania szablonów.

Po zapisaniu pliku szablonu, wystarczy nacisnąć krzyżyk w prawym górnym rogu. Przejdźmy teraz do załącznika.

Tworzenie szablonu wysyłki od podstaw – ZAŁĄCZNIK

Aby dodać załącznik do wiadomości, włącz opcję Dodaj załącznik.

Do wyboru masz 4 opcje:

Plik FRX – to format, który możesz edytować we wbudowanym programie Fast Report. Zapewnia on duże możliwości konfiguracji, ale jednocześnie wymaga nieco czasu, aby opanować jego obsługę. Podczas wysyłki załącznik zostanie przekonwertowany na plik PDF.

Plik RDLC – jest to starsza wersja formatek dokumentów, używana w poprzednich wersjach KWHotel. Jej edycja jest możliwa jedynie za pomocą zewnętrznego programu Microsoft Visual Studio.

Dowolny plik – pozwala na załadowanie dowolnego pliku, na przykład regulaminu obiektu w formacie PDF.

Plik POST – pozwala na załadowanie plików typu POST.

Na potrzeby naszego poradnika wybierzmy opcję Plik FRX. Wczytaj domyślny plik potwierdzenia rezerwacji w programie KWHotel. Znajduje się on w folderze instalacyjnym KWHotel > Doc > pl > BookingConfirmation.frx.

📌 PORADA

Możesz zlecić nam przygotowanie atrakcyjnego wizualnie dokumentu, w którym znajdziesz wszystkie wymagane przez siebie informacje. W tym celu napisz do nas na adres bok@kwhotel.pl.

Potwierdzenie rezerwacji wczytane, szablon jest gotowy! Możesz teraz zakończyć pracę kreatora wiadomości. Na koniec przetestujmy jeszcze, czy nasza wysyłka działa.

W tym celu zapraszam Cię do kolejnej lekcji.

Instrukcja video

Lista zmiennych dla wiadomości HTML / XML (lista aktualizowana)

📌 PORADA

Jeżeli utworzysz własne zmienne w oknie klienta lub rezerwacji, możesz je wykorzystać w potwierdzeniach HTML. Pojawią się w polu Insert data > Custom.

KategoriaNazwa zmiennejOpis
Customer
NamePełna nazwa klienta (imię i nazwisko)
Customer.FirstNameTylko imię klienta
Customer.LastNameTylko nazwisko klienta
Customer.EmailEmail klienta
Customer.PhoneTelefon klienta
Customer.NationalityNarodowość klienta w formacie „PL”
Customer.IDCardNumberNumer dowodu klienta
Customer.CountryKraj klienta w formacie „Polska”
Customer.CompanyNazwa firmy klienta
Customer.CompanyAdressAdres firmy klienta
Customer.CompanyTaxIDNIP firmy klienta
Stay
FromData początku rezerwacji w formacie 2023-08-28
From2formatData początku rezerwacji w formacie 28.08.2023
ToData końca rezerwacji w formacie 2023-08-29
To2formatData końca rezerwacji w formacie 29.08.2023
Persons0Ilość osób dorosłych w rezerwacji
Persons1Ilość osób z pierwszej grupy wiekowej
Persons2Ilość osób z drugiej grupy wiekowej
Persons3Ilość osób z trzeciej grupy wiekowej
RateplanNameNazwa planu cenowego
ReservationIDNumer rezerwacji
RemarksUwagi do rezerwacji
DaysCountIle dni potrwa rezerwacja (suma, czyli dla pojedynczej rezerwacji jeden dzień, ale dla grupowej dwa dni, ponieważ 2 pokoje x 1 dzień)
DaysCountByRoomIle dni potrwa rezerwacja w każdym pokoju (symbol pokoju: ilość dni, np. 133: 1)
DaysCountByRoomIle dni potrwa rezerwacja w każdym pokoju (pierwszy pokój: ilość dni, drugi pokój: ilość dni, itd.). Na przykład 1,1
StatusStatus rezerwacji np. Pobyt
RoomNamesNazwy pokoi w rezerwacji (006, 133)
GroupNamesNazwy grup pokoi w rezerwacji (np. Dwuosobowy, Deluxe)
RoomDescriptionFirstWyświetla treść wpisaną w zakładce Pokoje > edytujemy konkretny pokój > Zaawansowane > Dodatkowy opis 1
RoomDescriptionSecondWyświetla treść wpisaną w zakładce Pokoje > edytujemy konkretny pokój > Zaawansowane > Dodatkowy opis 2
RoomDescriptionThirdWyświetla treść wpisaną w zakładce Pokoje > edytujemy konkretny pokój > Zaawansowane > Dodatkowy opis 3
RoomGroupsDescriptionFirstWyświetla treść wpisaną w zakładce Pokoje > edytujemy konkretny typ pokoju > Zaawansowane > Dodatkowy opis 1
RoomGroupsDescriptionSecondWyświetla treść wpisaną w zakładce Pokoje > edytujemy konkretny typ pokoju > Zaawansowane > Dodatkowy opis 2
RoomGroupsDescriptionThirdWyświetla treść wpisaną w zakładce Pokoje > edytujemy konkretny typ pokoju > Zaawansowane > Dodatkowy opis 3
ResSourceNameŹródło rezerwacji
KeyCodeKod klucza do zamka w formacie numer pokoju: kod klucza (np. 006: 58072511)
KeyCode2Kod klucza do zamka w innym formacie (58072511, 45552311)
KeyCodeHostelKod klucza do zamka w formacie hostelowym (np. Apartament 1: 58072511# Apartament 1: 45552311#)
KeyCodeQRKod klucza do zamka w formie kodu QR
GuestNamesImiona klientów (po przecinku)
RoomGroupAllRoomsWszystkie nazwy grup pokoi, np. 2 x Apartament 1, jeśli w rezerwacji grupowej dwukrotnie występuje ta sama grupa pokoi
GuestNames2Alternatywny format imion klientów (imiona jedno pod drugim)
RoomDescriptionPodstawowy opis pokoju – znajdziesz go w zakładce Pokoje > edytujemy wybrany pokój > pole Opis
RoomDiscriptionFirstAllRoomParametr dla potwierdzeń grupowych. Wyświetla treść wpisaną w zakładce Pokoje > edytujemy konkretny pokój > Zaawansowane > Dodatkowy opis 1
RoomDiscriptionSecondAllRoomParametr dla potwierdzeń grupowych. Wyświetla treść wpisaną w zakładce Pokoje > edytujemy konkretny pokój > Zaawansowane > Dodatkowy opis 2
RoomDiscriptionThirdAllRoomParametr dla potwierdzeń grupowych. Wyświetla treść wpisaną w zakładce Pokoje > edytujemy konkretny pokój > Zaawansowane > Dodatkowy opis 3
RoomEquipmentsWyświetla wyposażenie pokoi (np. 006: wyposażenie)
RoomGroupEquipmentsWyświetla wyposażenie grup pokoi (Apartament1: wyposażenie)
Payment
PriceCena rezerwacji
Price50percent50% ceny rezerwacji
Price30percent30% ceny rezerwacji
Price40percent40% ceny rezerwacji
DiscountWartość procentowa zniżki w rezerwacji (np. 10,00) – nie dopisuje procenta
PaidWpłata (nie dolicza zaliczki)
PricePerDayCena za dzień w rezerwacji pojedynczej
PriceMealsCena za posiłki
PriceServiceSingleResCena towarów dodanych w rezerwacji pojedynczej
PriceServiceGroupResCena towarów i usług dodanych w rezerwacji grupowej
LocalTaxCena opłaty miejscowej
LocalTaxPaidWpłata za opłatę miejscową
PriceAllDaysCena za same noclegi
AdvanceDueDateTermin zaliczki w formacie 2023-09-01
AdvanceDueDate2formatTermin zaliczki w formacie 01.09.2023
Function
LeftToPayIle zostało do zapłacenia (nie uwzględnia opłaty miejscowej)
RoomsCountIlość pokoi w rezerwacji
CreationDateAddDaysData utworzenia rezerwacji
GetAsortymentPobiera nazwy towarów z zakładki Towary w oknie rezerwacji
Hotel
NameNazwa obiektu (Narzędzia >Dane obiektu)
CityMiasto, w którym znajduje się obiekt (Narzędzia > Dane obiektu)
StreetUlica, na której znajduje się obiekt (Narzędzia > Dane obiektu)
PostalCodeKod pocztowy obiektu (Narzędzia > Dane obiektu)
EmailEmail kontaktowy obiektu (Narzędzia > Dane obiektu)
WwwStrona internetowa obiektu (Narzędzia > Dane obiektu)
BankNameNazwa banku przypisana do danego obiektu (Narzędzia > Dane obiektu)
BankAccountNumer bankowy przypisany do danego obiektu (Narzędzia > Dane obiektu)
Pozostałe
PaymentLinkLink płatności TPay
PaymentLinkDueDateData ważności linku do płatności TPay
ConfirmationSignedByUżytkownik, który utworzył daną rezerwację
CheckInUrlLink do odprawy online

Zamów program

Skomponuj swój KWHotel

W naszym sklepie dobierasz tylko te rozwiązania, których naprawdę potrzebujesz. Kolejne rozszerzenia możesz dodać kiedy tylko chcesz!

Przejdź do sklepu