Przejdź do nawigacji

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)

1

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.

2

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.

3

Znajdź swoje identyfikatory

Poniższe narzędzia używają tych wartości zamiast symboli zastępczych.

Symbol zastępczyGdzie go znaleźć
LOCATION_IDW Developer Console otwórz aplikację i wybierz Locations. Skopiuj identyfikator lokalizacji, w której dzwoniący rezerwują wizyty.
SERVICE_VARIATION_IDW terminalu uruchom curl "https://connect.squareup.com/v2/catalog/list?types=ITEM" -H "Authorization: Bearer YOUR_TOKEN". Znajdź usługę po jej name i skopiuj id z jej variations, a nie własne id pozycji. Każdy czas trwania lub cena usługi to osobny wariant.

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ępu
  • Square-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

PoleWartość
Namefind_square_customer
Description”Znajdź dzwoniącego wśród naszych klientów Square po numerze telefonu. Użyj na początku rezerwacji, aby sprawdzić, czy już go znamy.”
MethodPOST
URLhttps://connect.squareup.com/v2/customers/search
Request HeadersAuthorization i Square-Version, jak wyżej
Body ParametersZobacz poniżej.
Assign to agentsReceptionist

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

PoleWartość
Namecreate_square_customer
Description”Dodaj dzwoniącego jako nowego klienta Square, gdy find_square_customer go nie znajdzie.”
MethodPOST
URLhttps://connect.squareup.com/v2/customers
Request HeadersAuthorization i Square-Version, jak wyżej
Body Parametersgiven_name (string, required): “Imię dzwoniącego.”
family_name (string, required): “Nazwisko dzwoniącego.”
phone_number (string, required): “Numer telefonu dzwoniącego w formacie międzynarodowym, na przykład +14155550123.”
email_address (string): “Adres e-mail dzwoniącego, jeśli go podał.”
Assign to agentsReceptionist

Sprawdź wolne terminy

PoleWartość
Namecheck_square_availability
Description”Wyświetl wolne terminy wizyt. Użyj przed zaproponowaniem dzwoniącemu terminu. Każdy wynik ma start_at i appointment_segments; zachowaj oba, aby zarezerwować termin wybrany przez dzwoniącego. Terminy są w UTC, więc przed podaniem ich przelicz je na naszą lokalną strefę czasową.”
MethodPOST
URLhttps://connect.squareup.com/v2/bookings/availability/search
Request HeadersAuthorization i Square-Version, jak wyżej
Body ParametersZobacz poniżej.
Assign to agentsReceptionist

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_ID
      • segment_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ę

PoleWartość
Namecreate_square_booking
Description”Zarezerwuj dzwoniącemu wolny termin, gdy go wybierze. Najpierw potwierdź z nim datę i godzinę. Użyj identyfikatora klienta z find_square_customer lub create_square_customer oraz wartości wybranego terminu z check_square_availability.”
MethodPOST
URLhttps://connect.squareup.com/v2/bookings
Request HeadersAuthorization i Square-Version, jak wyżej
Body ParametersZobacz poniżej.
Assign to agentsReceptionist

Parametry body:

  • booking (object, required)
    • location_id (string): stała wartość LOCATION_ID
    • customer_id (string, required): “id klienta dzwoniącego z find_square_customer lub create_square_customer.”
    • start_at (string, required): “start_at wybranego terminu, dokładnie w formie zwróconej przez check_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 z appointment_segments wybranego terminu.” Każdy element to obiekt:
      • service_variation_id (string): stała wartość SERVICE_VARIATION_ID
      • team_member_id (string, required): “team_member_id wybranego terminu.”
      • service_variation_version (integer, required): “service_variation_version wybranego 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.

1

Połącz Zapier

Jeśli jeszcze tego nie zrobiono, połącz Zapier w Reception.ai.

2

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ą.

3

Przypisz narzędzia

W Reception.ai otwórz kartę Tools integracji Zapier, wybierz Refresh tools i przypisz każdą akcję do Client (recepcjonisty).

4

Przetestuj

Przetestuj recepcjonistę jako nowy dzwoniący, który prosi o wizytę. Klient i wizyta pojawią się w Square.

Akcje

Znajdź dzwoniącego

PoleWartość
Zapier actionFind Customer
Set in ZapierNic.
Let the AI fill inPhone Number (numer dzwoniącego) lub adres e-mail.
Assign toClient

Dodaj nowego dzwoniącego

PoleWartość
Zapier actionCreate Customer
Set in ZapierNic.
Let the AI fill inFirst Name, Last Name, numer telefonu i adres e-mail.
Assign toClient

Utwórz wizytę

PoleWartość
Zapier actionCreate Appointment
Set in ZapierLocation i Team Member ID. Appointment Service ID, jeśli oferujesz jedną usługę.
Let the AI fill inCustomer ID (z Find Customer lub Create Customer), Date and Time of Appointment i Note.
Assign toClient

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.

Rozwiązywanie problemów

ProblemCo sprawdzić
Błąd 401 ze SquareZacznij wartość Authorization od Bearer i spacji, a potem użyj tokena Production, nie Sandbox.
Rezerwacja nie udaje się z powodu błędu uprawnień lub subskrypcjiTwój plan Square Appointments nie pozwala na rezerwacje przez API z własnym tokenem. Przejdź na Plus lub Premium albo użyj Zapier.
Nie zwrócono dostępnych terminówSprawdź, czy usługę można rezerwować online, czy członek zespołu oferuje ją w tej lokalizacji i czy zakres obejmuje co najmniej 24 godziny.
Rezerwacja nie udaje się dla zaproponowanego terminuTermin został zajęty albo usługa się zmieniła. Powiedz recepcjoniście, by ponownie sprawdził dostępne terminy i użył nowych wartości.
Rezerwacja nie udaje się z powodu błędu klientaSprawdź, czy customer_id to id zwrócone przez find_square_customer lub create_square_customer, i zachowaj wymagane phone_number w create_square_customer, aby następnym razem można było znaleźć klienta.
Akcja Square nie pojawia się w Reception.aiPo dodaniu akcji w Zapier wybierz Odśwież narzędzia w integracji Zapier.
Akcja ma status Zmieniono i nie jest używanaEdytowano ją w Zapier. Wybierz Aktualizuj na karcie Narzędzia.
Utwórz spotkanie nie działaSprawdź, czy członek zespołu może przyjmować rezerwacje w tej lokalizacji i oferuje tę usługę.
Spotkania trafiają na niewłaściwą godzinęSprawdź strefę czasową lokalizacji Square i poproś recepcjonistę o powtórzenie godziny. Narzędzia webhook wysyłają i pobierają godziny w UTC.
Powracający dzwoniący są dodawani dwa razyDodaj procedurę, by recepcjonista najpierw wyszukiwał dzwoniącego, zanim go doda.