Square Appointments
Znajdź lub dodaj klientów Square, sprawdź wolne terminy i twórz wizyty.
Twoja recepcjonistka może znaleźć dzwoniącego w Square lub dodać go jako klienta, a następnie utworzyć wizytę w Square Appointments. Możesz to skonfigurować na dwa sposoby:
- Opcja 1: Narzędzia webhook (zalecane). Narzędzia webhook wywołują API Square bezpośrednio, więc recepcjonistka może też sprawdzać wolne terminy i proponować dostępne godziny. Nie wymagają konta Zapier ani nie wykorzystują żadnych zadań Zapier.
- Opcja 2: Zapier. Akcje Zapier logują cię do Square, ale recepcjonistka nie może sprawdzać wolnych terminów. Rezerwuje godzinę, o którą prosi dzwoniący.
Opcja 1: Narzędzia webhook (zalecane)
Sprawdź swój plan
API Square pozwala tylko tokenowi z pełnym dostępem tworzyć rezerwacje, gdy sprzedawca korzysta z planu Square Appointments Plus lub Premium, a poniższy token dostępu ma pełny dostęp. W bezpłatnym planie narzędzie do rezerwacji zwróci błąd 403.
Pobierz token dostępu
Zaloguj się do Square Developer Console na konto Square i utwórz aplikację, na przykład Reception.ai. Otwórz ją, wybierz Credentials, u góry wybierz Production, a potem skopiuj Production access token.
Ten osobisty token dostępu ma pełny dostęp do twojego konta Square, w tym do płatności i danych klientów, a Square nie pozwala go ograniczyć. Zapisz go wyłącznie w nagłówku Secret w Reception.ai, nie umieszczaj go w udostępnianych dokumentach i zmień go w Developer Console, jeśli wycieknie.
Utwórz narzędzia
Dla każdego narzędzia przejdź do Integrations, wybierz Add integration, następnie Webhook Tool, a w Assign to agents ustaw Receptionist. Każde narzędzie wysyła te same dwa nagłówki żądania:
Authorization(Secret):Bearer, a po nim token dostępuSquare-Version(Value):2026-09-16
Pola oznaczone poniżej jako „stała wartość” mają w Value ustawione Fixed value. Wszystkie pozostałe pola są From the conversation i mają podany opis.
Znajdź dzwoniącego
Parametry body:
query(object, required)filter(object, required)phone_number(object, required)exact(string, required): “Numer telefonu dzwoniącego w formacie międzynarodowym, na przykład +14155550123.”
limit(integer): stała wartość5
find_square_customer zwraca wszystko, co zapisano przy kliencie, a dzwoniący może podać dowolny
numer telefonu. Dodaj regułę, która nakaże
recepcjoniście nigdy nie odczytywać danych klienta dzwoniącemu i używać ich tylko do
rozpoznania dzwoniącego oraz utworzenia rezerwacji.
Dodaj nowego dzwoniącego
Sprawdź wolne terminy
Parametry body:
query(object, required)filter(object, required)start_at_range(object, required)start_at(string, required): “Początek wyszukiwanego zakresu w UTC, w formacie RFC 3339, na przykład 2026-11-20T00:00:00Z.”end_at(string, required): “Koniec zakresu w tym samym formacie. Co najmniej 24 godziny i najwyżej 32 dni po rozpoczęciu.”
location_id(string): stała wartośćLOCATION_IDsegment_filters(array, required): “Wyślij dokładnie jeden element.” Każdy element to obiekt z jednym polem:service_variation_id(string): stała wartośćSERVICE_VARIATION_ID
Utwórz wizytę
Parametry body:
booking(object, required)location_id(string): stała wartośćLOCATION_IDcustomer_id(string, required): “idklienta dzwoniącego zfind_square_customerlubcreate_square_customer.”start_at(string, required): “start_atwybranego terminu, dokładnie w formie zwróconej przezcheck_square_availability.”seller_note(string): “Czego potrzebuje dzwoniący, w jednym lub dwóch zdaniach.”appointment_segments(array, required): “Wyślij dokładnie jeden element z wartościami zappointment_segmentswybranego terminu.” Każdy element to obiekt:service_variation_id(string): stała wartośćSERVICE_VARIATION_IDteam_member_id(string, required): “team_member_idwybranego terminu.”service_variation_version(integer, required): “service_variation_versionwybranego terminu.”
Twój recepcjonista rezerwuje członka zespołu, którego Square oferuje w wybranym terminie. Square oferuje tylko członków zespołu dostępnych do rezerwacji danej usługi w twojej lokalizacji.
Wybierz Enable przy każdym narzędziu, a następnie przetestuj recepcjonistę jako nowy dzwoniący, który prosi o wizytę. Klient i wizyta pojawią się w Square.
Dodaj procedurę dla rezerwacji: znajdź lub dodaj dzwoniącego, sprawdź wolne terminy, ustal termin, odczytaj datę i godzinę, a potem utwórz wizytę. Dodaj regułę, że recepcjonista nigdy nie odczytuje dzwoniącym danych klientów.
Aby oferować kilka usług, w obu narzędziach zmień service_variation_id ze stałej wartości na From the conversation i dodaj opis z identyfikatorami wariantów, na przykład: “Użyj ABC123 dla strzyżenia i DEF456 dla koloryzacji.”
Opcja 2: Zapier
Aplikacja Square w Zapier nie sprawdza wolnych terminów, więc twój recepcjonista nie może oferować wolnych slotów ani sprawdzić, czy termin jest zajęty. Do rezerwacji w czasie rzeczywistym użyj narzędzi webhook albo własnej rezerwacji Reception z Google Calendar, Calendly lub Cal.com.
Dodaj akcje Square
Na serwerze Zapier MCP pod adresem mcp.zapier.com dodaj poniższe akcje i zaloguj się do Square, gdy Zapier o to poprosi. Dla każdego pola ustaw stałą wartość lub pozwól AI je uzupełnić, zgodnie z listą.
Przypisz narzędzia
W Reception.ai otwórz kartę Tools integracji Zapier, wybierz Refresh tools i przypisz każdą akcję do Client (recepcjonisty).
Przetestuj
Przetestuj recepcjonistę jako nowy dzwoniący, który prosi o wizytę. Klient i wizyta pojawią się w Square.
Akcje
Znajdź dzwoniącego
Dodaj nowego dzwoniącego
Utwórz wizytę
Jeśli oferujesz kilka usług, dodaj też Find Service z Location ustawionym jako stała wartość i pozwól AI uzupełnić Appointment Service ID na podstawie wyniku.
Dodaj procedurę dla rezerwacji: znajdź lub dodaj dzwoniącego, ustal termin, odczytaj datę i godzinę, a potem utwórz wizytę.
Ograniczenia
- Żadna z opcji nie zmienia terminu ani nie anuluje wizyt.
- Przy narzędziach webhook recepcjonista rezerwuje wizyty w jednej lokalizacji.
- W Zapier recepcjonista nie może sprawdzać dostępności. Rezerwuje termin, o który prosi dzwoniący, bez wglądu w kalendarz.
- W Zapier Team Member ID jest stałe, więc każda wizyta trafia do tego samego członka zespołu. Recepcjonista nie może wybierać między pracownikami.
- Każda akcja Zapier uruchomiona przez recepcjonistę zużywa zadania z twojego planu Zapier. Zapier obecnie liczy dwa zadania za każde udane wywołanie; nieudane wywołania nie są liczone. Gdy plan się wyczerpie, akcje zatrzymają się do czasu jego odnowienia.