Duve is excited to announce its new integration with Alice, a leading task management platform in the hospitality industry. This integration enables hotels to streamline operations by automatically creating tasks in Alice based on guest activity or service requests within Duve.
The integration is designed to:
- Enhance operational efficiency through automation
- Eliminate manual task creation
- Ensure consistent task management from guest request to completion
Pricing
In order to open Alice integration, customers must purchase the Add-on. Alice is an add-on feature that will be available upon request and at an additional monthly cost of $0.50 per unit with a monthly minimum of 50 eur required. For more information contact our Support Team or your dedicated Customer Success Manager.
How It Works
The integration uses unique identifiers and webhooks to map tasks between Duve and Alice. The workflow includes:
- Custom upsell Setup: Hosts define free upsells - custom services in Duve (e.g., towel service or deep cleaning).
- Custom Service Setup: Hosts define external IDs for each custom service in Duve (see below).
- Trigger Configuration: Hosts set up webhooks to send data to Alice whenever a guest requests a custom service.
- Task Mapping: Task attributes such as room number, guest name, service type, and delivery time are mapped to corresponding fields in Alice.
- Task Confirmation: Alice confirms task creation, which is logged in Duve for transparency.
How to set it up?:
Setup Custom Service Upsells in Duve
Go to Upsells > Manage and click '+New Upsell' and select 'Custom'
Go to 'Pricing & Cancellation Policy' and select 'Free' upsells
Note: Only Free Upsells are supported to sync to the Hub OS integration.
For Single Products, add the External ID in the field
For Multiple Items, click on each item to add the External ID
Setup Trigger
Step 1: Go to Settings > Duve Connect > Add Incoming connection.
Name the connection "Alice" for easy access.
Show the Access Token and Copy (to add in later setup!)
Type: Reservation
Add the Order Details data fields:
- Order External id
- Order external status
- Status timestamp
Set Up the Outgoing Webhook
Step 2: Go to Settings > Connections > Outgoing > +Add New Webhook
- Set to fire when:
- Order Status = Created
- Order Type = Custom Service, add all the relevant services
Endpoint URL: Please inquire with Duve Support for the endpoint URL
- Add Custom Headers
-
alice_api_key: (Your Alice API Key) -
alice_user_name: (Your Alice Username) -
alice_password: (Your Alice Password) -
alice_hotel_id: (Your Alice Hotel ID) -
incoming_access_token: (Generated from Duve Incoming Webhook)
- Add Data Points to Alice
- First Name / Verified First Name
- Last Name / Verified Last Name
- Order Details / Product Details
- Room Number / Verified Email
- External ID
- Booking ID / Reservation ID
Setup in Alice:
Important! Ask Alice Support team to set up the status update URL: https://incoming-prod.duve.com/webhook/alice-listen-webhook
- In the Alice admin panel:
- Do not set "Service Options" as required
- Set default values for each Service Option to prevent API failure
Common Errors and Troubleshooting
-
Invalid Credentials
- Error: 400, WEB_HUK_INVALID_CREDS
- Solution: Double-check API keys, username, password
-
Missing Required Data
- Error: 403, WEB_HUK_INVALID_BODY
- Solution: Ensure Room Number, External ID, and First Name are present
-
Invalid Room or Service ID
- Error: 400, WEB_HUK_HUBOS_REQUEST_FAIL
- Solution: Check room mapping and service IDs
-
Failed After Retries
- Error: 403, WEB_HUK_REQUEST_ATTEMPT_FAILED
- Solution: Validate payload and authentication data; contact support if needed
Comments
0 comments
Please sign in to leave a comment.