Bambuser Integration Guide

This document provides guidance on how to integrate Bambuser videoconference solution to Booxi.

Table of Contents 

Prerequisites

Integration for One-to-One meetings 

Integration for One-to-Many meetings

Prerequisites 

The following technical prerequisites are required to activate the Bambuser connector.

• Branded Bambuser active account 
• Receive from Bambuser a web conferencing url to be added at the service level
• Required webhook configuration 
  • List of events available here. Consider enabling the suggested events based on the module used : appointment.created, appointment.updated, appointment.status_updated or reservation.created, reservation.status_updated, reservation.updated
  • HTTP POST method 
  • Static authorization token to be included into the webhook request headers
  • Endpoint (webhook url) 
• If you’re using Booxi standard emails, the Bambuser web conferencing url is automatically added in the emails
• If you’re using any custom email, you will need to dynamically generate the Bambuser web conferencing url for your customers

Integration for One-to-One Meetings

Step 1. Confirmation Emails

First, customize the URLs at which you clients and staff should be redirected to join their scheduled calls. To do so, contact your Booxi representative and provide the URLs in the following format. Make sure to adapt the following examples with the actual data from your own website and Bambuser configuration.

 

For clients

https://your-website/your-meeting-page/?bambuserConnectId=ext:BooxiBookingId

For agents

https://lcx.bambuser.com/{orgId}/one-to-one/agent-tool?connectId=ext:BooxiBookingId

---

 

Step 2. Sync Booxi Meetings into Bambuser One-to-One​

Next, in your Bambuser dashboard, under Settings -> Configurations -> General, enable “Bookings” and select “Other” as a booking system.

Then, contact your Bambuser representative and request an API Key for a Booxi integration. Once your API key has been issued, you will find its details in the Bambuser Dashboard under Settings -> Integration -> API Keys.

 

Next, ask your Booxi presentative to set up a webhook integration for the following Booxi events with the configuration listed below.

 

Events

• appointment.created
• appointment.updated
• appointment.updated_status

Configuration

POST request to https://liveshopping-api.bambuser.com/v1/bookings/booxiWebhook with the header: Authorization: Token YOUR_API_KEY.

Make sure to replace “YOUR_API_KEY” with your Bambuser API key (e.g. Authorization: Token ABC123DEF456).

---

 

Step 3. Link a Booxi Staff to a Bambuser Agent

In Booxi, under a staff’s summary page locate and copy its staff id. Per the example below, the staff id would be 35372 (omit the # sign).

Then, in the Bambuser Dashboard access an agent’s profile and assign its calendar id with the staff id found in Booxi.

Once configured, all bookings made for a specific staff in Booxi will be available to the corresponding agent in Bambuser.

---

 

Step 4- Assign Your Services a Bambuser URL

In Booxi, assign your services a Bambuser videoconference link by following the below steps.

1. Select a service that will be provided using Bambuser videoconference.
2. Under the service’s details, locate the property “location”.
3. From the dropdown list, Select “By Video Conference” if it hasn’t been done.
4. Make sure “Generate video conference link” is unchecked.
5. In the text box below, type in the URL at which the videoconference is hosted.
   Example of a hosting URL

   https://your-website/your-meeting-page/?bambuserConnectId=ext:

6. Click on “Insert a variable” and select “Booking ID” in the list to create a unique URL for each booking.
   Example of URL with variable

   https://your-website/your-meeting-page/?bambuserConnectId=ext:[booking_id]

---

 

Integration for One-to-Many Meetings

Step 1- Create an event in Bambuser 

In Bambuser, create a one-to-many event and copy its URL.

Step 2- Create an event in Booxi

In the Back Office create a group event and paste the Bambuser URL in the text box found under the service details.

For further details about the Booxi+Bambuser integration, please consult with your Booxi representative.