
# TheFork

> **Dla kogo jest to rozwiązanie?** Ta integracja jest przeznaczona dla restauracji, które przyjmują rezerwacje przez TheFork (TheFork Manager). Jeśli nie korzystasz z TheFork, możesz pominąć tę stronę.
>
> Korzystasz z innego systemu rezerwacyjnego? Każde rozwiązanie z API można podłączyć: zobacz [Łączenie narzędzia, którego nie mamy na liście](connecting-other-tools.md), gdzie opisano funkcje niestandardowe, API oraz webhooks.

> **Availability.** The TheFork connection is built, but it is not switched on yet. It runs on TheFork's partner API, and TheFork issues those partner credentials only after approving a partnership, so the TheFork card stays hidden until that approval comes through. There is no date to give you yet — if you run your reservations in TheFork and want to know the moment it opens up, send us a note via [email support](mailto:hi@dmchamp.com).

TheFork to platforma rezerwacyjna stojąca za serwisem thefork.com, używana przez restauracje w całej Francji, Hiszpanii, Włoszech i na innych rynkach europejskich do rezerwacji online i zarządzania stolikami. Połączenie TheFork z <span data-t="appName">DM Champ</span> pozwala Twojemu Agentowi AI sprawdzać rzeczywistą dostępność, rezerwować stolik oraz zmieniać lub anulować rezerwację gościa bezpośrednio w czacie na WhatsApp, SMS, Instagramie lub na stronie internetowej, z którego gość już korzysta.

---

## Co Agent AI może zrobić z TheFork

Po połączeniu i wybraniu jako dostawcy rezerwacji w Agencie AI, Agent może:

- **Sprawdzanie dostępnych terminów** dla danej daty i liczby osób w oparciu o aktualną dostępność w TheFork oraz przeglądanie zakresu dat, aby poinformować gościa, w które dni są jeszcze wolne stoliki.
- **Informowanie o kosztach przed dokonaniem rezerwacji.** Jeśli dany termin wymaga gwarancji kartą kredytową lub można go zarezerwować tylko w połączeniu z konkretną ofertą lub menu, Agent poinformuje o tym zamiast dokonywać rezerwacji w ciemno.
- **Rezerwowanie stolika** z podaniem imienia i nazwiska gościa, adresu e-mail, liczby osób, daty, godziny oraz wszelkich specjalnych życzeń.
- **Wyszukiwanie nadchodzących rezerwacji gościa**, aby móc je potwierdzić lub nimi zarządzać. W WhatsApp i SMS wyszukuje je na podstawie numeru telefonu, z którego prowadzona jest rozmowa; w innych kanałach ma dostęp tylko do rezerwacji dokonanych w tym samym czacie.
- **Zmiana** daty, godziny lub liczby osób w rezerwacji.
- **Anulowanie** rezerwacji.

Twój zespół widzi każdą z tych rezerwacji w TheFork Manager tak samo jak każdą inną, z oznaczeniem **TheFork Manager API** jako źródła pochodzenia.

### Warto wiedzieć

- **Niektóre rezerwacje trafiają do systemu jako "na żądanie".** Restauracja potwierdza je później, zamiast od razu blokować stolik, a Agent informuje o tym gościa, zamiast obiecywać potwierdzony stolik.
- **Terminy wymagające depozytu lub preautoryzacji karty nie mogą być rezerwowane przez czat.** Agent wyjaśnia powód i kieruje gościa do Ciebie lub na Twoją stronę w TheFork, aby tam dokończyć proces.
- **Tylko rezerwacje, bez menu.** Zobacz [Pytania o menu](#menu-questions) poniżej.

---

## Gdzie pojawiają się rezerwacje

Każda rezerwacja dokonana przez Agenta pojawia się również na Twojej stronie **Spotkania** z plakietką THEFORK, dzięki czemu widzisz ją obok swoich pozostałych rezerwacji.

TheFork pozostaje głównym systemem ewidencji dla gościa: TheFork wysyła własną wiadomość e-mail z potwierdzeniem, więc <span data-t="appName">DM Champ</span> nie wysyła drugiej, a rezerwacje te nie są kopiowane do Kalendarza Google. Kalendarzem Twojej restauracji jest TheFork Manager.

---

## Łączenie z TheFork

> **Zanim zaczniesz:** Twoja restauracja musi mieć włączonego partnera <span data-t="appName">DM Champ</span> na swoim koncie TheFork. Jest to funkcja, którą TheFork włącza dla restauracji; poproś o to swojego opiekuna konta w TheFork lub wsparcie techniczne TheFork. Dopóki to nie zostanie zrobione, TheFork nie pozwoli nam połączyć się z restauracją, a krok z identyfikatorem restauracji (Restaurant ID) zakończy się odpowiednim komunikatem.

1. W lewym pasku bocznym kliknij **Ustawienia** (ikona koła zębatego).
2. W pasku bocznym ustawień, w grupie **Integracje**, kliknij **Rezerwacje i kalendarz**.
3. Znajdź kartę **TheFork** i kliknij **Dodaj restaurację**.
4. Wklej swój **Identyfikator restauracji (Restaurant ID)** i kliknij **Weryfikuj**. Jest to długi identyfikator, który TheFork nadaje Twojej restauracji (UUID, ciąg liter, cyfr i myślników); znajdziesz go w TheFork Manager lub uzyskasz od wsparcia TheFork. Przed kontynuowaniem sprawdzimy, czy restauracja jest osiągalna.
5. Nadaj restauracji **nazwę** (będzie ona widoczna na liście i tak będzie się do niej odnosić AI), a następnie zapisz.

W ten sposób możesz dodać kilka restauracji, po jednej na każdy identyfikator restauracji TheFork: kliknij **Dodaj restaurację** w wierszu połączonego TheFork dla każdej z nich. AI dokonuje rezerwacji w aktywnej restauracji; pozostałe możesz wstrzymać.

### Wstrzymywanie lub usuwanie restauracji

Każda podłączona restauracja posiada własne przyciski **Wstrzymaj** i **Usuń** na stronie Rezerwacje i kalendarz. Wstrzymanie powoduje, że sztuczna inteligencja przestaje przyjmować rezerwacje dla tej restauracji, zachowując jednocześnie jej konfigurację; usunięcie usuwa ją całkowicie, choć w każdej chwili możesz dodać ją ponownie przy użyciu tego samego identyfikatora.

---

## Instruowanie agenta AI w sprawie dokonywania rezerwacji przez TheFork

1. Kliknij **Agenci AI** na pasku bocznym i otwórz agenta.
2. Przejdź do kroku **Możliwości AI** i znajdź kartę **Rezerwacje**.
3. Włącz opcję **Pozwól temu agentowi rezerwować wizyty**.
4. Kliknij selektor dostawcy, wybierz **TheFork** i wskaż, dla której z podłączonych restauracji ten agent ma dokonywać rezerwacji.

Nie jest wymagany żaden typ wydarzenia: TheFork udostępnia własną dostępność, godziny otwarcia i plan stolików.

---

## Jak przebiega rozmowa dotycząca rezerwacji

1. Gość prosi o stolik. Agent pyta o datę, liczbę gości oraz preferowaną godzinę, jeśli gość ją posiada.
2. Agent sprawdza dostępność w TheFork i informuje gościa, jakie terminy są możliwe do zarezerwowania. Jeśli w danym dniu nie ma wolnych miejsc, agent może zasugerować inne dni, w których stoliki są dostępne. Jeśli wybrana godzina wymaga gwarancji kartą kredytową lub dotyczy konkretnej oferty bądź menu, agent poinformuje o tym przed dokonaniem rezerwacji.
3. Gość wybiera godzinę oraz podaje swoje imię i nazwisko oraz adres e-mail. Agent dokonuje rezerwacji i potwierdza ją lub wyjaśnia, że restauracja musi jeszcze potwierdzić rezerwację, gdy TheFork zwróci ją jako zapytanie.
4. Później gość może poprosić tego samego agenta o zmianę dnia, godziny, liczby osób lub o anulowanie rezerwacji.

Godziny są zawsze podawane według czasu lokalnego restauracji.

---

## Pytania dotyczące menu

Połączenie z TheFork obejmuje rezerwacje; nie odczytuje ono Twojego menu. Aby pozwolić AI odpowiadać na pytania dotyczące menu:

- **Dodaj menu do bazy wiedzy:** umieść swoje dania, ceny, informacje o alergenach i dania dnia w sekcji FAQ lub źródłach wiedzy swojego agenta AI, a bot będzie stamtąd odpowiadał na pytania typu „Jakie macie opcje wegetariańskie?” — zobacz [Zarządzanie FAQ](../ai-automation/faq-management.md).
- **Wyślij menu jako plik:** prześlij plik PDF lub obraz menu do biblioteki mediów z notatką „kiedy wysłać”, a bot wyśle go, gdy gość zapyta o menu lub cennik.

---

## Wskazówki dla restauracji

- **Podaj swój numer telefonu i stronę internetową** w swoim koncie oraz w ustawieniach restauracji, aby w sytuacji, gdy AI musi przekazać gościa dalej (np. termin wymagający wpłaty zaliczki lub zmiana, którą musi wprowadzić restauracja), gość miał możliwość bezpośredniego kontaktu z Tobą.
- **Dodaj operacyjne FAQ** do bazy wiedzy swojego agenta AI: godziny otwarcia, parking, prywatne sale, polityka dotycząca alergenów, dress code — zobacz [Zarządzanie FAQ](../ai-automation/faq-management.md).
- **Używaj tagów** do segmentacji listy gości — na przykład „miłośnik wina”, „urodziny”, „duża grupa” — i wysyłaj ukierunkowane komunikaty do każdego segmentu.

---

## Następne kroki

- [AI Agents](../ai-agents/ai-agents.md) — skonfiguruj Agenta AI swojej restauracji.
- [System rezerwacji](../appointments/booking-system.md) — jak działają rezerwacje u różnych dostawców.
- [Zarządzanie FAQ](../ai-automation/faq-management.md) — dodawaj pytania i odpowiedzi specyficzne dla restauracji.
