app2email API Cennik

Dokumentacja

Rezerwacja wizyt na WhatsApp

Pozwól klientom rezerwować, przekładać i odwoływać wizyty w WhatsApp. Rezerwacje trafiają do Google Calendar, Microsoft 365, Apple iCloud albo do własnego kalendarza app2email, z potwierdzeniami i przypomnieniami. Obejmuje aplikację kalendarza, stronę rezerwacji online, płatności i zespół kalendarza.

Klient pisze na Twój numer WhatsApp słowo „book” i wybiera usługę, dzień oraz godzinę, nie wychodząc z czatu.

Rezerwacja trafia do Twojego kalendarza, klient dostaje potwierdzenie, a przed wizytą wychodzi przypomnienie.

Co widzi klient

  1. Wysyła słowo rezerwacji (book, appointment, reserve — słowa wybierasz sam) albo stuka „Zarezerwuj teraz” w wiadomości od Ciebie.
  2. Otwiera się formularz w WhatsApp (WhatsApp Flow): wybiera usługę, dzień z kalendarza, wolny termin, podaje imię i potwierdza.
  3. Dostaje wiadomość potwierdzającą ze szczegółami, numerem rezerwacji i, jeśli chcesz, plik kalendarza do dodania wizyty do telefonu.
  4. Przed wizytą dostaje przypomnienie z przyciskami Potwierdź, Zmień termin i Anuluj. Odpisanie CANCEL albo RESCHEDULE w każdej chwili też działa.

Klient nic nie instaluje i nie dostaje linku do innej strony: formularz jest częścią WhatsApp i otwiera się w czacie.

Konfiguracja w pięć minut

  1. Usługi: co można zarezerwować i jak długo to trwa (konsultacja 30 minut, strzyżenie 45 minut).
  2. Dostępność: godziny otwarcia w poszczególne dni tygodnia, siatka terminów (co 15, 30 lub 60 minut), przerwy między wizytami, z jakim wyprzedzeniem klient musi się umówić i jak daleko w przód może rezerwować. Dni specjalne (zamknięte albo inne godziny) ustawiasz w tym samym miejscu.
  3. Kalendarz: połącz Google Calendar, Microsoft 365 / Outlook.com albo Apple iCloud albo trzymaj rezerwacje w kalendarzu app2email. Zajęte terminy w podłączonym kalendarzu nigdy nie są proponowane.
  4. Wiadomości: potwierdzenie, przypomnienia i tekst anulowania, w Twoich słowach, z miejscami na usługę, datę i godzinę.
  5. Publikacja: formularz rezerwacji jest wysyłany do WhatsApp i publikowany z Przeglądu. Wyślij sobie wiadomość testową, a potem włącz Book-and-Pay.

Personel: dodaj osoby, z którymi klienci mogą się umawiać, każdą z własnymi godzinami i, jeśli chcesz, własnym kalendarzem. Formularz pyta wtedy „Do kogo chcesz się umówić?”, a na pierwszym miejscu jest „Ktokolwiek dostępny”.

Wszystko na tej stronie ustawiasz na stronie Book-and-Pay w panelu (/dashboard/app/book, otwieranej też z Integracji).

Słowa wyzwalające

Słowo wyzwalające to słowo lub krótka fraza, która coś uruchamia, gdy klient ją wyśle. Słowa wybierasz na zakładce Wyzwalacz.

  • Słowa rezerwacji (book, booking, appointment, reserve, reservation, schedule na początek) wysyłają formularz rezerwacji.
  • Słowa anulowania (cancel) pytają klienta z nadchodzącą wizytą „Anulować?” z przyciskami.
  • Słowa zmiany terminu (reschedule, change booking) zaczynają nową rezerwację, która zastępuje nadchodzącą.
  • Przy kilku formularzach każdy może mieć własne słowa na zakładce Flows. Mają pierwszeństwo przed słowami rezerwacji.

Słowa są dopasowywane jako całe wyrazy. Wielkość liter i znaki diakrytyczne nie mają znaczenia: „Book”, „BOOK” i „book!” to to samo, a „bookshelf” się nie liczy.

Długie wiadomości są pomijane

Słowo wyzwalające liczy się tylko w krótkiej wiadomości, czyli takiej, w której jest mniej niż 10 innych słów. Dłuższa wiadomość, która przypadkiem zawiera „booking” albo „cancel”, niczego nie uruchamia i jest obsłużona jak każda inna.

Liczbę możesz zmienić na zakładce Wyzwalacz („Ignoruj słowa w długich wiadomościach”), od „tylko wtedy, gdy słowo to cała wiadomość” do „w wiadomości dowolnej długości”.

Kalendarze

Przy Google Calendar i Microsoft 365 logujesz się raz i wybierasz kalendarz, do którego zapisują się rezerwacje, oraz kalendarze, które mają blokować terminy.

Apple iCloud i inne serwery CalDAV łączą się hasłem do aplikacji.

Kalendarz tylko do odczytu (link .ics) może blokować terminy, a same rezerwacje zostają w kalendarzu app2email.

Jeśli podłączony kalendarz przestaje odpowiadać, rezerwacje dalej działają, a panel informuje, że trzeba go połączyć ponownie.

Zasada 24 godzin i przypomnienia

WhatsApp pozwala firmie wysyłać wolny tekst przez 24 godziny od ostatniej wiadomości klienta. Potwierdzenia przychodzą w tym oknie, więc są Twoim własnym tekstem.

Przypomnienia zwykle wychodzą później. Dlatego app2email tworzy na Twoim numerze kilka zatwierdzonych szablonów wiadomości zaraz po włączeniu rezerwacji (Meta je sprawdza, zwykle w ciągu godziny) i używa pasującego szablonu zawsze, gdy okno jest zamknięte.

Przypomnienia o ponownej wizycie („dawno się nie widzieliśmy”) to wiadomości marketingowe i idą tylko do kontaktów, które wyraziły zgodę na marketing.

Wiadomości po wizycie i raporty

Po wizycie może przyjść notatka z poleceniami (z linkami do produktów) oraz ocena jednym dotknięciem.

Zakładka Raporty pokazuje rezerwacje według źródła, nieobecności bez odwołania (no-show), oceny oraz to, które usługi i osoby z personelu są najbardziej obciążone.

Aplikacja kalendarza

Twoje rezerwacje mają własną aplikację pod adresem /calendar (www.app2email.com/calendar). Jest zrobiona pod ekrany dotykowe: tablet przy recepcji albo telefon w kieszeni. Przyciski są duże, a arkusze wysuwają się od dołu na wąskim ekranie.

  1. Otwórz ją pozycją „Calendar” w menu panelu albo wchodząc na /calendar i logując się. Jeśli masz kilka firm, przełączaj się między nimi na górnym pasku.
  2. Wybierz widok: Dzień, Tydzień, Miesiąc albo Lista. Przesuń palcem w lewo lub w prawo, żeby przejść do następnego albo poprzedniego dnia (tygodnia, miesiąca). Dotknij daty, żeby przeskoczyć przez wybór miesiąca. Przy personelu dotknij znacznika osoby, żeby zobaczyć tylko jej terminy.
  3. Zarezerwuj: dotknij „+ Nowy” albo puste miejsce o danej godzinie w widoku dnia. Wybierz klienta (wyszukaj albo wpisz numer z kodem kraju), usługę, osobę z personelu („Ktokolwiek dostępny” jest opcją) i jeden z wolnych terminów. Włącz „Powiadom klienta”, żeby wysłać potwierdzenie.
  4. Przenieś: otwórz wizytę, dotknij Przenieś i wybierz nowy termin. Wizyta zachowuje swój numer. Klient dostaje informację, jeśli zostawisz włączone „Powiadom klienta”.
  5. Anuluj, zakończona, nieobecność: otwórz wizytę i dotknij odpowiedniego przycisku. Anulowanie pyta o powód.
  6. Zablokuj czas: dotknij „+ Nowy”, potem „Zablokuj czas”. Wybierz jedną osobę albo wszystkich, godziny lub całe dni i tytuł (lunch, urlop). Zablokowany czas nigdy nie jest proponowany klientom.
  7. Notatki: wewnętrzne notatki o kliencie albo o jednej wizycie. Przypnij te ważne. Klient ich nie widzi. Notatka może mieć datę „Przypomnij mi”; tego dnia dostajesz e-mail.

Klienci i ankiety

Klienci to lista wszystkich, którzy się umawiali, z wizytami, nieobecnościami, nadchodzącymi i minionymi wizytami, notatkami, pakietami i płatnościami. Stamtąd możesz edytować tagi i dane, wysłać wiadomość WhatsApp albo e-mail oraz poprosić asystenta o szkic albo krótką notatkę przygotowawczą.

Ankiety pozwalają zaproponować od dwóch do dziesięciu terminów i pozwolić ludziom głosować (zobacz Typy wydarzeń).

Kalendarz pokazuje zajęte terminy podłączonego kalendarza Google, Microsoft lub Apple na szaro, więc nic nie jest przed Tobą ukryte. Ekran odświeża się co 30 sekund.

Zespół kalendarza

Możesz zaprosić ludzi tylko do kalendarza. Nie widzą Twojego panelu, wiadomości ani ustawień.

  1. Otwórz kalendarz, potem menu, potem Zespół (tylko administratorzy).
  2. Wpisz adres e-mail osoby, wybierz rolę i, jeśli chcesz, pracownika, którym ta osoba jest.
  3. Wyślij zaproszenie. Osoba dostaje e-mail z linkiem, loguje się albo zakłada konto i trafia do Twojego kalendarza.
  4. Rolę możesz zmienić, ponownie wysłać zaproszenie albo usunąć osobę w każdej chwili.

Role

RolaCo osoba może zrobić
AdministratorWszystko w kalendarzu: rezerwować, przenosić, anulować, blokować czas każdego, wszystkie notatki, zespół, udostępnianie, płatności i zwroty, usuwanie danych klientów.
PersonelWidzi kalendarz, rezerwuje, przenosi i anuluje, blokuje swój czas, pisze notatki i wysyła wiadomości do klientów. Tylko własny kanał udostępniania.
WidzTylko patrzy. Brak przycisków, które coś zmieniają.

Dwie opcje dla każdej osoby

Są przeznaczone głównie dla personelu:

  • Tylko własne wpisy: osoba widzi i zmienia tylko wizyty swojego pracownika (musisz wybrać pracownika).
  • Ukryj dane kontaktowe klientów: numery telefonów i adresy e-mail pokazują się jako „•••• 4567”. Dotyczy to także tego, co idzie do asystenta.

Osoby, które już mają rolę w panelu, dostają automatycznie odpowiednią rolę w kalendarzu: owner i admin są administratorami, member to personel, viewer to widz.

Strona rezerwacji online

Oprócz formularza WhatsApp klienci mogą rezerwować na stronie mobilnej w przeglądarce. Nie wymaga logowania ani aplikacji. Ustawiasz ją na stronie Book-and-Pay w panelu, na zakładce Rezerwacja online.

  1. Włącz stronę.
  2. Wybierz adres: www.app2email.com/book/ plus krótka nazwa własna (od 5 do 40 liter, cyfr lub myślników). Naciśnij „Sprawdź i zapisz”. Jeśli nazwa jest zajęta, dostaniesz informację.
  3. Napisz nagłówek i krótkie wprowadzenie, jeśli chcesz zmienić domyślne.
  4. Skopiuj link, wydrukuj kod QR albo skopiuj fragment osadzenia dla swojej strony (iframe; dodaj ?embed=1, żeby ukryć nagłówek, i ustaw kolory parametrami color, bg i text).

Znacznik osobistego linku

Wpisz {booking_link} w dowolnym tekście do klienta, a app2email zamieni go na link przygotowany dla tego klienta. Otwiera się już rozpoznany: nie musi wpisywać numeru, a rezerwacja jest powiązana z jego czatem.

Możesz go użyć w odpowiedzi na słowo wyzwalające, w potwierdzeniu, przypomnieniach, wiadomościach o anulowaniu i zmianie terminu, w wiadomości po wizycie oraz w tekście „brak wolnych terminów”.

Link wygasa po liczbie dni, którą ustawisz (domyślnie 7). Teksty wysyłane jako szablony poza oknem 24 godzin nie mogą go zawierać. Jeśli strona jest wyłączona, znacznik staje się pusty.

Co wysyła słowo wyzwalające

Wybierasz jedno z trzech: formularz WhatsApp (jak dotąd), przycisk, który otwiera stronę online, albo formularz z linkiem do strony pod tekstem. Jeśli żaden formularz nie jest jeszcze opublikowany, wysyłany jest link.

Klient, którego app2email jeszcze nie zna

  1. Klient otwiera Twój publiczny adres i wybiera usługę, termin oraz podaje imię.
  2. Termin jest zarezerwowany na kilka minut (domyślnie 10; możesz ustawić od 5 do 30).
  3. Strona pokazuje przycisk, który otwiera WhatsApp z gotową wiadomością „Confirm booking BK-...”. Klient ją wysyła.
  4. Rezerwacja jest zrobiona, strona pokazuje „Masz rezerwację”, a potwierdzenie przychodzi na WhatsApp, z przyciskiem „Zapłać teraz”, gdy usługa jest płatna online. Jeśli czas się skończy, termin zostaje zwolniony i klient może wybrać ponownie.

To potwierdza, że klient jest właścicielem numeru WhatsApp. Klient, który przychodzi z osobistym linkiem, nie potrzebuje tego kroku.

Zarządzanie i limity

Z osobistym linkiem klient widzi swoje nadchodzące wizyty i może je anulować lub przenieść (możesz to wyłączyć).

Możesz ustawić najpóźniejszy czas przed początkiem, do którego klienci mogą coś zmieniać, oraz limit wizyt na dzień. Ty, API i aplikacja kalendarza nigdy nie są ograniczani tymi ustawieniami.

Kanał kalendarza (.ics)

W kalendarzu otwórz Udostępnianie i utwórz link do kanału dla siebie albo dla jednego pracownika. Dodaj go w Google Calendar, Apple Calendar lub Outlook jako subskrypcję, a Twoje wizyty i zablokowane czasy pojawią się tam.

Kanał zawiera imiona, usługi i numery rezerwacji, nigdy numerów telefonów klientów. Link do kanału możesz unieważnić w dowolnej chwili.

Typy wydarzeń

  • Jeden na jeden: jeden klient na dany termin. To domyślne.
  • Grupowe: ustaw „miejsca” przy usłudze (od 1 do 200). Ten sam czas startu jest dostępny, dopóki wszystkie miejsca nie zostaną zajęte. Każdy klient ma własną rezerwację, wiadomości i płatność. Strona pokazuje, ile miejsc zostało.
  • Wszyscy uczestniczą: wybierz od dwóch do dziesięciu osób z personelu. Termin jest proponowany tylko wtedy, gdy wszystkie są wolne, a wydarzenie trafia do kalendarza każdej z nich.
  • Round robin (po kolei): w ustawieniach personelu wybierz, jak „Ktokolwiek dostępny” wybiera osobę: pierwsza wolna albo wolna z najmniejszą liczbą wizyt w tym czasie.
  • Ankiety: w kalendarzu otwórz Ankiety i dotknij od dwóch do dziesięciu wolnych terminów. Wyślij link. Ludzie głosują na stronie bez logowania. Gdy wybierzesz termin, zostaje zrobiona wizyta dla wskazanego klienta albo termin zostaje zablokowany. Terminy nie są wstrzymywane w trakcie głosowania.

Przyjmowanie płatności

Podłączasz własne konto Stripe albo PayPal. Pieniądze idą od klienta prosto na Twoje konto.

app2email nie pobiera prowizji i nigdy nie trzyma Twoich pieniędzy. Obowiązują opłaty i potwierdzenia samego dostawcy płatności. Jedna waluta na numer.

Podłączenie i ceny

  1. Otwórz Rezerwacje, Płatności. Strona mówi, gdzie znaleźć każdy klucz.
  2. Stripe: wklej klucz tajny albo ograniczony. app2email go sprawdza i dodaje swój webhook na Twoim koncie. PayPal: wpisz identyfikator klienta i sekret aplikacji REST oraz wybierz tryb produkcyjny (live) albo sandbox. Podłączyć lub odłączyć konto może tylko właściciel albo administrator.
  3. Wybierz walutę i metody, z których mogą korzystać klienci (jedną lub obie).
  4. Przy każdej usłudze ustaw cenę i to, czy płatność jest wymagana, opcjonalna czy żadna. Dodaj zaliczkę, jeśli chcesz pobrać tylko część teraz; reszta jest płacona na wizycie.

Jak to działa

  • Wymagana, na stronie online: przez osobisty link termin jest wstrzymany, gdy klient płaci, a rezerwacja powstaje po potwierdzeniu płatności (płatność, która wygasa lub zostaje anulowana, zwalnia termin). Na publicznym adresie klient najpierw potwierdza termin na WhatsApp, jak wyżej, dzięki czemu wiesz, czyja to rezerwacja. Rezerwacja powstaje wtedy z przyciskiem „Zapłać teraz” w potwierdzeniu WhatsApp i jest anulowana, jeśli nie zostanie opłacona w ciągu 1 dnia i najpóźniej 2 godziny przed wizytą (rezerwacja zrobiona później dostaje jeszcze 30 minut).
  • Formularz WhatsApp i rezerwacje, które wprowadzasz sam: rezerwacja powstaje, a potwierdzenie zawiera link „Zapłać teraz”. Przy opcji „opcjonalna” nic nigdy nie jest anulowane. Przy „wymagana” możesz automatycznie anulować nieopłacone rezerwacje po liczbie minut, którą wybierzesz (0 oznacza nigdy).
  • Kupony: kod, procent albo kwota, dla części lub wszystkich usług, z maksymalną liczbą użyć i datą końcową.
  • Pakiety przedpłacone: na przykład 10 sesji za jedną cenę, ważne przez kilka dni. Klienci kupują je na stronie online albo Ty przyznajesz pakiet przy stanowisku. Rezerwacja z pakietem nie pobiera opłaty i zużywa jedną sesję. Anulowanie zwraca sesję, gdy anulujesz Ty albo klient anuluje w porę.
  • Jednorazowe linki do płatności: w kalendarzu poproś klienta o płatność z kwotą i opisem, wysłaną na WhatsApp albo skopiowaną, żebyś wysłał ją sam.
  • Zwroty: w Płatnościach wybierz, czy anulowanie nigdy nie zwraca pieniędzy, pyta Cię, czy zwraca w całości automatycznie. Zwrot możesz też zrobić z kalendarza, w całości albo częściowo.

Płatność liczy się jako opłacona dopiero wtedy, gdy Stripe lub PayPal ją potwierdzi. app2email zapisuje kwotę, status i numer referencyjny dostawcy, nigdy danych karty.

Powiadomienia

  • E-maile do klientów: gdy w rezerwacji jest adres e-mail klienta, potwierdzenie (z plikiem kalendarza), anulowanie, informacja o zmianie, przypomnienia i wiadomość po wizycie idą także e-mailem, oprócz WhatsApp. Odpowiedzi trafiają na adres, który wybierzesz. Włącz to w Rezerwacjach, Powiadomienia.
  • Dodatkowe reguły: do 20 reguł, na przykład „wyślij notkę o parkingu dzień przed”. Każda reguła ma wyzwalacz (zarezerwowana, anulowana, przeniesiona, przed startem, po zakończeniu, zakończona, nieobecność, opłacona), opóźnienie, usługi, których dotyczy, to, kto ją dostaje (klient, Ty albo pracownik), oraz kanał (WhatsApp lub e-mail).
  • Poza oknem 24 godzin: reguła na WhatsApp jest wysyłana jako wolny tekst tylko w oknie. Poza nim wiadomość idzie e-mailem, jeśli klient ma adres. Jeśli nie ma, zostaje pominięta, a dziennik o tym informuje. Wbudowane przypomnienia nadal używają zatwierdzonych szablonów, jak opisano wyżej.

Branding

Na zakładce Rezerwacja online możesz wgrać logo (PNG, JPEG lub WEBP, do 300 KB), wybrać kolor przycisku i kolor tła oraz ukryć wiersz „Powered by app2email”.

Możesz też napisać politykę anulowania, która pokazuje się na kroku przeglądu i przy wizycie, dodać do trzech przycisków na stronie „Masz rezerwację” oraz wysłać klientów na Twoją stronę kilka sekund po rezerwacji.

Usuwanie danych klientów

Administrator może wymazać dane rezerwacji jednego klienta: w kalendarzu otwórz klienta i wybierz „Usuń dane klienta” (musisz wpisać potwierdzenie). API ma tę samą funkcję.

  • Przyszłe wizyty zostają anulowane bez wiadomości do klienta.
  • We wszystkich wizytach imię, e-mail, notatki i opinie zostają wyczyszczone, a numer klienta zostaje zastąpiony losowym kodem.
  • Notatki, linki, blokady i głosy w ankietach tego klienta są usuwane. Płatności i pakiety zachowują kwotę i datę, ale tracą imię i numer.
  • Raporty nadal liczą zanonimizowane wizyty.

To nie usuwa kontaktu ani rozmowy WhatsApp; to zostaje na stronie Kontakty.

Do automatycznego usuwania ustaw w ustawieniach prywatności „zachowaj dane klientów przez N dni” (od 30 do 3650). Raz dziennie dane wizyt, które zakończyły się dawniej niż tyle dni, są wymazywane w ten sam sposób. 0 oznacza: zachowaj wszystko.

Dla programistów i agentów

Wszystko, co robi panel, jest w REST API pod /v1/{number}/bookings: wyświetlanie i tworzenie rezerwacji, ich anulowanie oraz odczyt wolnych terminów i ustawień rezerwacji.

Twój system może odbierać zdarzenia webhook booking.created, booking.cancelled i booking.rescheduled. Te same narzędzia są dostępne na serwerze MCP dla agentów AI.

Dokumentacja API zawiera parametry i przykłady. Według celu:

  • Kalendarz: odczyt zunifikowanego kalendarza rezerwacji i blokad; tworzenie, zmiana i usuwanie zablokowanego czasu.
  • Szukanie terminów: usługi, personel, najbliższe wolne terminy, wstrzymanie terminu.
  • Zmiana rezerwacji: aktualizacja danych, przeniesienie rezerwacji w miejscu.
  • Notatki: odczyt i zapis notatek do rezerwacji lub klienta, z przypomnieniami.
  • Linki: osobiste linki do rezerwacji, lista, unieważnianie.
  • Klienci: profile, aktualizacja, usuwanie danych rezerwacji.
  • Płatności: lista, linki do płatności, zwroty, oznaczanie rezerwacji jako opłaconej; pakiety i ich przyznawanie.
  • Ankiety: tworzenie, lista, zamykanie, rezerwacja terminu.
  • Webhooki: booking.updated, booking.note.created, calendar.block.created, calendar.block.deleted, booking.paid, booking.refunded, payment.paid, package.purchased, poll.voted, poll.closed, booking.customer.erased. Każdy webhook dostaje wszystkie zdarzenia.
  • MCP: odpowiadające narzędzia dla agentów, na przykład get_calendar, find_next_booking_slots, reschedule_booking, add_booking_note, create_booking_link, request_payment.

Zapisy wymagają zakresu bookings:manage. Klucze sandbox nie mogą zapisywać, zwracać pieniędzy ani usuwać danych.

Jeszcze niedostępne

  • Cykliczne wizyty i lista oczekujących.
  • Rezerwacje, które najpierw wymagają Twojego zatwierdzenia.
  • Subskrypcje i cykliczne obciążenia.
  • Podatki i faktury (paragon od Stripe lub PayPal jest paragonem).
  • Płatności częściowe poza jedną zaliczką oraz płacenie kartą wewnątrz samego WhatsApp.
  • Masowy e-mail do klientów (Broadcasts wysyła masowo WhatsApp).
  • Rezerwacja bez numeru WhatsApp: każdy klient go potrzebuje.
  • Przeciąganie i upuszczanie w kalendarzu (Przenieś to przycisk).
  • Języki inne niż angielski na stronie online.

Wszystko powyższe ustawiasz na stronie Book-and-Pay w panelu (/dashboard/app/book). Pytania: support@app2email.com.

Wróć na początek