Skip to main content

SevenRooms integration

Connect SevenRooms so guests can check table availability, book, find, reschedule, and cancel reservations by phone or chat.

Connect SevenRooms to your AI Employee to let restaurant guests check live table availability, book a table, find an upcoming reservation, reschedule it, or cancel it — all through a phone or chat conversation, without waiting for restaurant staff.

Before you begin

  • An active SevenRooms account with external integration access. Ask your SevenRooms representative to enable it for the venue.

  • The restaurant's Client ID, Client Secret, and Venue ID, supplied by your SevenRooms representative. SevenRooms console navigation varies by account, so if you can't see these values, request them rather than creating substitute values.

  • A venue in SevenRooms with bookable dates and times, including the dates you plan to use for testing.

  • Access to the Builder with permission to edit project settings, edit the canvas, and click Publish All.

Setup takes about 15 minutes once you have the credentials. Credential provisioning by SevenRooms may take additional time.

Add a project

Add the SevenRooms integration module to the customer's Builder. Follow the steps in Create a new project using these values:

Field

Value

Idn

sevenrooms_integration

Title

sevenrooms_integration

Registry

production

Module

sevenrooms_integration

Ensure Auto update enabled is on, then click Create. Once created, click the three dots next to the project and select Force Update Project to pull the latest module version.

Configure the SevenRooms integration in the Builder

  1. Open the project in the Builder and find the Module - SevenRooms settings group.

  2. Paste the supplied values into Client ID, Client Secret, and Venue ID. Keep both credentials private. The Venue ID must belong to a venue those credentials can access.

  3. Keep API Base URL set to https://api.sevenrooms.com/2_4 for US production. Change it to https://api.eu.sevenrooms.com/2_4 only when SevenRooms confirms that the venue is hosted in the EU production environment.

  4. Confirm that the project's Business Time Zone matches the SevenRooms venue. Availability and reservation times are interpreted in this time zone.

  5. Leave the feature switches on unless the restaurant intentionally doesn't offer that action through the AI Employee.

  6. Set Availability Search Radius (Hours) to how far before and after the guest's preferred time the AI Employee should search. The default is 3 hours.

  7. Keep Automatically Add Default Scenarios to Canvas on for a new project.

  8. Click Publish All.

The integration manages its temporary access token automatically. Don't paste a token into the Builder.

Setting

IDN

Purpose

Default

Client ID

sevenrooms_client_id

Client ID supplied by SevenRooms. Required.

(empty)

Client Secret

sevenrooms_client_secret

Client Secret paired with the Client ID. Required.

(empty)

Venue ID

sevenrooms_venue_id

Venue ID for the restaurant this instance manages. Required.

(empty)

API Base URL

sevenrooms_base_url

Selects the SevenRooms production environment used by the configured credentials.

https://api.sevenrooms.com/2_4

Enable Availability Check

sevenrooms_enable_availability

Allows the AI Employee to retrieve open table times.

on

Availability Search Radius (Hours)

sevenrooms_availability_search_radius_hours

Searches this many hours before and after the requested time, within the same calendar day.

3

Enable Reservation

sevenrooms_enable_reservation

Allows the AI Employee to create reservations.

on

Enable Cancellation

sevenrooms_enable_cancellation

Allows the AI Employee to cancel a selected reservation.

on

Enable Reservation Rescheduling

sevenrooms_enable_reschedule

Allows the AI Employee to move one selected reservation to a confirmed live slot.

on

Enable Booking Lookup

sevenrooms_enable_booking_lookup

Loads and searches upcoming reservations by phone number.

on

Automatically Add Default Scenarios to Canvas

sevenrooms_setup_scenarios

Adds the booking, cancellation, and rescheduling canvas content on publish.

on

The module also contains settings that are managed automatically or reserved for advanced support use. Leave them as they are: sevenrooms_access_token (refreshed automatically), sevenrooms_override_agent_attributes (installs the standard booking configuration during publish), sevenrooms_search_booking_schema and sevenrooms_search_booking_instructions (built-in phone-number extraction for chat), sevenrooms_setup_persona_id (internal identity created during setup), and sevenrooms_venue_group_id (reserved for future multi-venue support and unused in this version).

What happens on Publish All

After you click Publish All, the integration:

  • prepares the secure SevenRooms connection;

  • enables the availability, reservation, lookup, rescheduling, and cancellation actions you left switched on;

  • adds the standard booking and cancellation canvas content plus the rescheduling intent and scenario, when Automatically Add Default Scenarios to Canvas is on;

  • preserves any existing edited copies of those canvas items.

To verify, open the canvas library and confirm that the intents Regular Table Booking, Cancellation via Agent, and Restaurant Reservation Reschedule via Agent appear, with Make a Regular Table Booking, Canceling Appointment via Agent, and Rescheduling a Restaurant Reservation via Agent as their scenarios.

What the AI Employee can do

  • Check live table availability: asks for the preferred date, time, and party size, then searches the configured number of hours before and after that time. Results name the restaurant location and present bookable times in 12-hour format in the project's business time zone.

  • Create a reservation: after the guest chooses an available time and confirms, creates the reservation in SevenRooms.

  • Recognize returning callers: on a phone call, quietly loads the caller's upcoming SevenRooms reservations into the guest profile as soon as the phone number is identified.

  • Find reservations in chat: uses the phone number already supplied in the conversation, or asks for one when it is missing.

  • Handle several upcoming reservations safely: lists the matches and asks the guest which one they mean, rather than choosing automatically.

  • Reschedule an existing reservation: identifies one reservation, checks live replacement availability, asks for explicit confirmation, and moves the original reservation to the selected time. If the move fails, the original reservation is unchanged.

  • Cancel a confirmed reservation: reconfirms the selected date and time, asks for final approval, and then cancels it in SevenRooms.

After a successful lookup, the guest profile is refreshed with future SevenRooms reservations whose phone number exactly matches the requested number. Cancelled reservations are removed from the upcoming list, and reservations from other connected booking systems are preserved.

Scenarios and trigger phrases

The integration ships with three editable scenarios. Booking and cancellation come from Newo's standard canvas library; rescheduling is supplied by this integration. These are a reference implementation: you can edit them in the canvas and publish your changes, and the AI Employee uses the changes after the next Publish All.

Each scenario contains exact sentences that start an integration action. The AI Employee says the phrase, the integration runs the action, and the AI Employee reads the result before continuing.

Important: Do not remove, shorten, merge, or paraphrase a trigger phrase. You may translate a phrase into the guest's language while preserving its meaning, as the standard scenarios direct. A changed phrase stops the integration from reacting.

Phrase (verbatim)

Fires

Scenario

"Give me a moment to check available slots right now. I'll get back to you shortly."

Availability lookup

Make a Regular Table Booking; Rescheduling a Restaurant Reservation via Agent

"I'm submitting your booking right now. Please give me a moment, and I'll get back to you shortly."

Reservation creation

Make a Regular Table Booking

"Thanks. I'm submitting your booking right now. Please wait a moment, I'll get back to you shortly."

Reservation retry after clarification

Make a Regular Table Booking

"Give me a moment to double-check if I have information about your bookings, I will get back to you shortly."

Reservation lookup

Canceling Appointment via Agent; Rescheduling a Restaurant Reservation via Agent

"Give me a moment, I will cancel your booking right now."

Reservation cancellation

Canceling Appointment via Agent

"Give me a moment, I will reschedule your reservation right now."

Reservation rescheduling

Rescheduling a Restaurant Reservation via Agent

Make a Regular Table Booking

Runs when a guest wants to reserve a table for a regular-size party. The AI Employee gathers the date, time, and party size, routes large parties according to the restaurant's large-reservation policy, says the availability phrase, lets the guest pick one of the returned times, gathers the guest's name and phone number, asks permission to submit, and then says the reservation phrase. It only offers times returned by the availability check, and it waits for the booking action to report success before confirming the reservation.

Canceling Appointment via Agent

Runs when a guest explicitly asks to cancel a reservation. The AI Employee says the lookup phrase, presents the matching reservation (or lists all matches and asks the guest to choose), reconfirms the selected day and time, asks for final approval, says the cancellation phrase, and confirms only after SevenRooms reports success.

Rescheduling a Restaurant Reservation via Agent

Runs when a guest wants to move an existing reservation to another date, time, or party size. The AI Employee says the lookup phrase, requires the guest to select exactly one reservation, gathers the replacement date, time, and party size, says the availability phrase and offers only the live returned times, reads back the original and replacement details, asks for explicit final confirmation, and then says the rescheduling phrase. On an error, it explains that the original reservation is unchanged.

Safe customization

Within each scenario you can reword greetings, questions, and confirmations around the trigger phrases, add restaurant-specific questions or policy wording (deposits, seating, accessibility, arrival guidance) before final confirmation, and adjust tone and supported languages. Don't skip the explicit confirmation of the selected reservation or replacement slot, and don't let the AI Employee claim success before the action result reports it.

To turn an action off entirely, switch off the matching feature in Module - SevenRooms and click Publish All.

Note: Once you edit an intent or scenario, later integration updates don't overwrite your edited copy. To receive a newer shipped default, delete the edited copy from the canvas and click Publish All. The original is restored from the library, after which you can reapply your changes.

Test the integration

Use a test guest and a time that is genuinely open in SevenRooms. Cancel the test reservation when you're finished.

Test availability

  1. Ask: "Can I reserve a table for two tomorrow at 7 PM?"

  2. The AI Employee says: "Give me a moment to check available slots right now. I'll get back to you shortly."

  3. Confirm that the result names the restaurant location and that the 12-hour times match the venue's availability and local time zone in SevenRooms.

With the default radius, a request for 7 PM searches from 4 PM through 10 PM. Slots that require card payment are not offered, because the integration doesn't collect payment details.

Test reservation creation

  1. Choose one of the offered times, provide the guest name and phone number, and approve submission.

  2. The AI Employee says: "I'm submitting your booking right now. Please give me a moment, and I'll get back to you shortly."

  3. Confirm that the new reservation appears in SevenRooms with the selected date, time, party size, name, and phone.

Test chat lookup

  1. Start a new chat and ask to find or cancel the test reservation.

  2. The AI Employee says: "Give me a moment to double-check if I have information about your bookings, I will get back to you shortly."

  3. If asked, provide the same phone number used for the reservation.

  4. Confirm that the AI Employee presents the upcoming test reservation. If several reservations use that phone number, it lists them and asks which one you mean.

Test cancellation

  1. Select the test reservation and confirm that it should be cancelled.

  2. The AI Employee says: "Give me a moment, I will cancel your booking right now."

  3. Confirm in SevenRooms that the reservation is cancelled.

  4. Ask the AI Employee to search again. The cancelled reservation no longer appears in the upcoming list.

Test rescheduling

  1. Ask to move an upcoming test reservation to a different date or time.

  2. The AI Employee finds the reservation, checks live availability, and asks you to confirm the complete move. Use a replacement slot it just offered.

  3. After confirmation, the AI Employee says: "Give me a moment, I will reschedule your reservation right now."

  4. Confirm in SevenRooms that the same reservation now has the selected date, time, and party size.

Troubleshooting

Availability, booking, lookup, and cancellation all fail

The Client ID, Client Secret, or Venue ID is missing, mismatched, or doesn't have access to the configured venue.

  1. Ask your SevenRooms representative to verify all three values and their venue access.

  2. Re-enter them in Module - SevenRooms.

  3. Click Publish All.

  4. Run the availability test and confirm that the returned times match SevenRooms.

All reservation actions stop after credentials are rotated

SevenRooms issued a new Client ID or Client Secret, but the Builder still contains the previous value.

  1. Ask your SevenRooms representative to confirm the active credential pair and its access to the venue.

  2. Replace Client ID and Client Secret in Module - SevenRooms.

  3. Confirm that API Base URL matches the region of the new credentials.

  4. Click Publish All, then run the availability test.

The AI Employee stopped reacting after a canvas edit

A required trigger phrase was removed, shortened, or paraphrased.

  1. Open the affected scenario on the canvas.

  2. Compare its trigger phrases with the trigger phrase table in the Scenarios and trigger phrases section above.

  3. Restore every changed phrase.

  4. Click Publish All, then repeat the relevant test chat.

Chat can't find a known reservation

The phone number given in chat differs from the number stored on the SevenRooms reservation, or Enable Booking Lookup is off.

  1. Turn on Enable Booking Lookup and click Publish All.

  2. In the test chat, provide the exact phone number attached to the reservation, including the country code when it is available.

  3. Ask the AI Employee to search again.

If no reservation is found, the AI Employee asks the guest to verify the phone number and offers help from the restaurant team. It doesn't claim that the reservation was cancelled.

Cancellation fails after the reservation was selected

SevenRooms rejected the cancellation, or the reservation changed after it was loaded.

  1. Confirm the reservation still exists in SevenRooms.

  2. Ask the AI Employee to search again so it refreshes the guest's upcoming reservations.

  3. Retry once after reconfirming the correct reservation.

  4. If it still fails, complete the cancellation in SevenRooms and contact Newo support.

Rescheduling fails after final confirmation

The selected replacement slot is no longer current, the reservation was refreshed without its provider identity, or SevenRooms rejected the change. The original reservation is unchanged.

  1. Ask the AI Employee to search for the reservation again.

  2. Run a new availability check and choose one of the newly returned times.

  3. Reconfirm the complete move and retry once.

  4. If it still fails, keep the original reservation and complete the change in SevenRooms.

Limitations

  • One venue per integration instance. Use a separate project for each additional venue.

  • Lookup depends on phone matching. The phone number supplied by the guest must match the number on the reservation.

  • Card-required slots are not offered. The integration doesn't collect or tokenize payment-card details. Guests must contact the restaurant or use its online booking experience for those slots.

  • One-day availability search. The search radius expands around the preferred time but stays within the requested calendar day.

  • Turning off Enable Booking Lookup limits cancellation. Cross-session cancellation then depends on reservations already present in the guest profile or on help from restaurant staff.

Did this answer your question?