PolyAI’s OpenTable integration enables AI voice assistant capability for both Core and Pro OpenTable customers. The integration is handled by providing a unique identifier provided by PolyAI to the OpenTable marketplace.

Before getting started, you should have both an OpenTable and PolyAI account.

Getting started

  1. Log in to the OpenTable for Groups dashboard.
  2. Use the OpenTable marketplace search to find the PolyAI tile.
  3. Click “Integrate with PolyAI”.
  4. You will be redirected to a page within OpenTable and asked for a unique identifier.
    • If you are not yet a PolyAI customer, click “Contact PolyAI” and trigger a sales form.
  5. If you do have your identifier, enter it into the “Unique identifier” text field.
  6. PolyAI and OpenTable will enable your integration and contact you once it is ready to use.
See the OpenTable article on PolyAI for more details. You must contact PolyAI directly if you want to deactivate your integration.

Authorization

OpenTable uses OAuth 2.0 for secure access to its API. To get started:

  1. Request your client_id and client_secret from OpenTable.
  2. Exchange your credentials for an access token.

OpenTable provides two endpoints:

  • Production: https://oauth.opentable.com
  • QA: https://oauth-pp.opentable.com

You will POST to the following URI (Production example):

POST https://oauth.opentable.com/api/v2/oauth/token?grant_type=client_credentials

Submitting client credentials

Credentials are passed in the Authorization header as specified in the OAuth spec. Use the following steps to submit your client credentials:

Making a booking

Below is a simplified Python example referencing the make_booking logic:

Next steps

  1. Error handling: In production, handle normal HTTP status codes like 401 Unauthorized, 403 Forbidden, and 400 Bad Request.
  2. Data validation: Add logic to ensure users provide all required fields (e.g., names, valid phone numbers, reservation token).
  3. Token renewal: Monitor token expiration and re-run the OAuth flow to obtain fresh tokens.

For more advanced usage—such as seat preferences, custom error flows, or credit card holds—expand on these snippets with your own business logic.

For support, contact PolyAI at support@polyai.com