Introduction

Overview

DuveConnect enables seamless data exchange between Duve and third-party systems, enhancing automation and guest experience.

image info

How It Works

To integrate, the third-party system connects to Duve’s API using an access token provided during setup. Once configured, hosts can leverage third-party data throughout the guest journey, including online check-in, guest apps, communications, and check-out processes.

Prerequisites

Ensure the following are set up:

  1. Outgoing API Calls: Sync data from Duve to the third party using webhooks, including the Reservation ID.
  2. Additional Fields: Set up fields to capture third-party data.
  3. Incoming API Calls: Configure the third party to send data back to Duve.

Setup Instructions

1. Create a Connection in Duve

  1. Navigate to Settings > Connections > DuveConnect.
  2. Click Create New Connection and provide:
    • Name: Name your connection.
    • Scope: Add the additional field names to be populated by the third party.
  3. Click Create to proceed to the Configuration page.

2. Share Details with the Third Party

Provide the following to the third-party supplier:

  • Access Token: Click “Show” and copy the token.
  • Code Example: Update the authorization header with the access token. The Reservation ID must be included in the webhooks, and the Value Field should contain the third-party data.

3. Token Management

  • Rotate Later: Generates a new token, valid for 7 days alongside the old token.
  • Rotate Now: Creates a new token, immediately revoking the old one.

4. Logs and Monitoring

  • The Logs Tab shows request details and status codes:
    • 200 - Success (Green)
    • 400 - Failure (Red)
  • View request history for the past 30 days.

Testing the Integration

  1. Create a test reservation in Duve.
  2. Perform an action that triggers a webhook (e.g., complete a Pre Check-in).
  3. Confirm the third party received the webhook.
  4. Have the third party push data to the additional fields defined in the scope.
  5. Verify logs in Duve for success messages.
  6. Check the reservation page to ensure values are populated in additional fields.

Notes

  • If the scope is updated, regenerate and update the access token in the third party’s code.
  • Allow a few minutes for data to populate.

Success!

If all tests pass, your DuveConnect integration is successfully set up.

Built with