Important product naming update: Sidekick is now called Gladly (AI) and Gladly Hero (the Platform) is now Gladly Team. Please keep this in mind as you read through our documentation.

Bubblehouse App Platform Installation

Prev Next

The Bubblehouse app is set up entirely from Gladly's Settings, with no command-line tools required. Once it is connected, your team sees each Customer's loyalty record on the Customer Profile and can adjust points, redeem points and undo redemptions from the Conversation.

Before you start

Gather from Bubblehouse:

  • Your shop slug: the part of your Bubblehouse admin address after /s/. For example, in https://app.bubblehouse.com/admin/s/gladly-integration/ the shop slug is gladly-integration.

  • A shared secret for Gladly: its key ID and its secret (see Step 1).

Step 1: Create a shared secret in Bubblehouse

In the shop admin sidebar, open API. Create a shared secret just for Gladly, so it can be revoked on its own, and copy its key ID and its secret. The secret is shown only once, so copy it before closing the dialog. Bubblehouse Support may need to turn on API access for your shop first.

Step 2: Open the Apps settings

In Gladly, go to Settings > Apps. This is where you manage your App Platform integrations.

Step 3: Create a configuration

Click Create Configuration. When prompted for the External App, choose the Bubblehouse app (gladly.com/bubblehouse) and select the latest version available.

Step 4: Enter your configuration

  • Shop slug: the shop slug from Bubblehouse.

  • Key ID: the key ID of the shared secret you created in Step 1.

  • Shared secret: the base64 value Bubblehouse showed once when the secret was created.

  • Most points per adjustment (optional): the most points an agent may add or remove in one adjustment. Leave it blank to turn adjusting off.

  • Most points per redemption (optional): the most points an agent may turn into a discount code at once. Leave it blank to turn redeeming off.

  • Store timezone (optional): for example America/Los_Angeles, so dates on the card match the store's. Leave it blank to use America/New_York.

Each points limit turns on one action that moves points, so choose the limits your team should work within.

Add App Platform Configuration form for Bubblehouse

Switch the configuration to active and save it.

Step 5: Add the card to the Customer Profile

In Gladly, go to Settings > Agent Experience > Customer Profile and add the App Platform Card for the Bubblehouse loyalty card.

Step 6: Add the agent forms

Go to Settings > Agent Experience > Agent Actions and add each Bubblehouse form:

  • Adjust points

  • Redeem points for a discount code

  • Undo a redemption

The remaining three actions (redeem points onto a subscription order, update the birthday, and opt in or out of the loyalty program) have no form. Use Agent Actions to choose which actions Gladly AI can use.

Contact Support

Users assigned the Team Manager or Administrator roles can contact Gladly Support. Log into Gladly as one of these roles, click the hamburger menu on the top-left corner, then click Contact Gladly Support. Gladly Support's primary operating hours are Monday through Friday, 6 AM to 6 PM Pacific Time, but you can submit a request anytime.

  • Please select the correct business impact (P1 to P4).

  • Most requests should be sent as a P4.