Skip to content

Connect TheFork

The TheFork tool connects your KonversAI assistant to one restaurant in TheFork. You add the tool on the Assistant tools screen in the KonversAI console. Select Settings in the left sidebar, then select AI tools. Once connected, the assistant does two things. It checks which times have a free table on a date for a number of guests. It also tells a guest the status of their upcoming reservations, after the guest verifies their phone number. The assistant only reads from TheFork. It never makes, changes or cancels a reservation.

A team member with the View tools permission opens the Assistant tools screen in the KonversAI console. A team member with the Modify tools permission adds, edits, tests and deletes the tool. A Tenant Admin holds both permissions, always. Without View tools, the item AI tools does not appear under Settings in the left sidebar. Ask a Tenant Admin to grant Modify tools on the User permissions screen.

With TheFork: TheFork may ask the restaurant’s owner or manager to confirm that KonversAI may access the restaurant.

Sign in to the KonversAI console and select your tenant. Select Settings in the left sidebar, then select AI tools. The screen heading is Assistant tools.

The restaurant must be listed on TheFork and take its reservations in TheFork Manager. The TheFork tool reads the reservations and free tables that TheFork Manager holds.

KonversAI connects to TheFork with its own API access. You do not need API keys from TheFork. KonversAI support asks TheFork to give KonversAI access to your restaurant, and links the restaurant to your tenant.

One tenant covers one restaurant in TheFork.

The reservation lookup needs a verified phone number. Add a Phone Verification tool on the Assistant tools screen, so guests can verify their number in the chat.

  1. In KonversAI: Contact KonversAI support. Give the restaurant’s name and city as they appear on TheFork.
  2. In KonversAI: Wait for KonversAI support to confirm that the restaurant is linked. TheFork grants the access, so this can take a few days.
  1. In KonversAI: Select Settings in the left sidebar, then select AI tools. The screen opens with the heading Assistant tools.
  2. In KonversAI: Select + Add tool. Type TheFork in the search field, or select the category Booking and calendar.
  3. In KonversAI: Select TheFork. The form opens with the heading Add tool.
  4. In KonversAI: Type a label in Display name, for example the restaurant’s name. KonversAI fills Slug while you type.
  5. In KonversAI: Type your instruction in Usage guidance for the AI assistant. For example: Use this when a guest asks for a free table or about their reservation. Bookings are made on our website.
  6. In KonversAI: Keep Enabled switched on.
  7. In KonversAI: Select Add tool at the bottom. KonversAI saves the tool. The tool has no settings to fill in.

What can the assistant do once TheFork is connected?

Section titled “What can the assistant do once TheFork is connected?”

The TheFork tool gives your KonversAI assistant two abilities. It checks which times have a free table at the restaurant on one date for a number of guests. When the date is full, it suggests other dates in the next two weeks that have tables. It also tells a guest the status of their upcoming reservations at the restaurant: confirmed, waiting for the restaurant to accept, declined or cancelled. The assistant never makes, changes or cancels a reservation. Tell the assistant where guests book in Usage guidance for the AI assistant.

Does a free time mean the table is booked for the guest?

Section titled “Does a free time mean the table is booked for the guest?”

No. The TheFork tool only reads which times are free when the guest asks. The assistant does not hold or book the table, so the time can be gone by the time the guest books. When a time needs a card guarantee or a prepayment in TheFork, the assistant tells the guest the amount and how many hours before the meal the guest can cancel without a charge.

Why does the assistant ask the guest to verify their phone number?

Section titled “Why does the assistant ask the guest to verify their phone number?”

TheFork finds a guest’s reservations by the phone number the reservation was made with. The TheFork tool uses only a phone number the guest has proved is theirs in the chat, so nobody can read another guest’s reservation. Without one, the tool answers No verified phone number found for this conversation. Add a Phone Verification tool on the Assistant tools screen in the KonversAI console, so guests can verify their number.

The guest verified their phone, but the assistant finds no reservation. Why?

Section titled “The guest verified their phone, but the assistant finds no reservation. Why?”

The TheFork tool only sees upcoming reservations at the one restaurant linked to your tenant. It does not see past reservations. TheFork also matches the phone number exactly, so a reservation made with another number, or by someone else in the party, does not show. Ask the guest which number they used to book, and at which restaurant.

Why does the assistant not say how many guests the reservation is for?

Section titled “Why does the assistant not say how many guests the reservation is for?”

TheFork did not return the number of guests for that reservation. The assistant still gives the date, the time and the status. Contact KonversAI support if this happens for every reservation.

Where do I see a guest’s reservations in the console?

Section titled “Where do I see a guest’s reservations in the console?”

Open the conversation in the KonversAI console. The Conversation Details pane on the right shows the guest under End user. When the guest has verified their phone number, a TheFork card lists their upcoming reservations: date and time, number of guests, status and the guest’s note. The same card shows on the guest’s page under Contacts. Past reservations do not show, because TheFork does not return them.

How do I see which free tables the assistant found?

Section titled “How do I see which free tables the assistant found?”

Open the conversation in the KonversAI console. The Conversation Details pane shows a section Availability checks. Each row is one time the assistant asked TheFork: the date, the number of guests, and the times that were free. When the date was full, the row shows the other dates TheFork offered. When TheFork could not be reached, the row says so. Use it to see what the assistant knew when it answered the guest.

The assistant says TheFork is not set up for this restaurant yet. What now?

Section titled “The assistant says TheFork is not set up for this restaurant yet. What now?”

KonversAI has not linked a TheFork restaurant to your tenant yet, or the link is switched off. Contact KonversAI support with the restaurant’s name and city as they appear on TheFork.

Last reviewed . Tell us when a step no longer matches the product.