--- title: "Bubblehouse App Platform Installation" slug: "bubblehouse-app-platform-installation" updated: 2026-10-15T06:20:16Z published: 2026-10-15T06:20:16Z canonical: "help.gladly.com/bubblehouse-app-platform-installation" --- > ## Documentation Index > Fetch the complete documentation index at: https://help.gladly.com/llms.txt > Use this file to discover all available pages before exploring further. # Bubblehouse App Platform Installation 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](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/bubblehouse-app-platform-config.png?sv=2026-02-06&spr=https&st=2026-11-05T17%3A43%3A29Z&se=2026-11-05T18%3A43%3A29Z&sr=c&sp=r&sig=V8HWILRGUI4y14eORagWLleGZJI8WQBIcJcxmWz%2FKpg%3D) Switch the configuration to active and save it. ![](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/bubblehouse app plat.png?sv=2026-02-06&spr=https&st=2026-11-05T17%3A43%3A29Z&se=2026-11-05T18%3A43%3A29Z&sr=c&sp=r&sig=V8HWILRGUI4y14eORagWLleGZJI8WQBIcJcxmWz%2FKpg%3D) ### 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](https://help.gladly.com/product-docs/pages/en/contact-gladly-support-team). 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. *Customer* or C*ustomers* refers to the people you support through Gladly who buy or use your products or services. Contains everything about a Customer. Their Conversation history, contact details, order details, and other Customer-specific information. *Conversation* or *Conversations* (with a capital "C") provides a holistic view of Customer communications and interactions contained in the Conversation Timeline. Users assigned the **Team Manager** or **Administrator** roles can contact [Gladly Support](https://help.gladly.com/product-docs/pages/en/contact-gladly-support-team). Log into Gladly as one of these roles, click![hamburger-menu-icon(1)](https://cdn.us.document360.io/7047b671-c4f2-4df0-bb0a-b9b511fd2452/Images/Documentation/hamburger-menu-icon(1).svg?sv=2026-02-06&spr=https&st=2026-11-05T17%3A43%3A29Z&se=2026-11-05T18%3A43%3A29Z&sr=c&sp=r&sig=V8HWILRGUI4y14eORagWLleGZJI8WQBIcJcxmWz%2FKpg%3D)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.