𝐏𝐑𝐄𝐑𝐄𝐐𝐔𝐈𝐒𝐈𝐓𝐄𝐒
Before you start, you’ll need an active Intercom account:
1. Find your Intercom workspace ID (app_id in Settings → Workspace → General). Add it to the plugin settings in the Bubble editor.
2. Find your Secure Key (go to Settings → Channels → Messenger → Security). Add it to the plugin settings in the Bubble editor.
3. Protect sensitive attributes if needed (Settings → Data).


𝐒𝐄𝐓𝐔𝐏 𝐏𝐑𝐎𝐂𝐄𝐒𝐒

To securely install the Intercom Messenger to a page in your Bubble app, add these two steps in a workflow (for example, when the page loads or a button is clicked):

1️⃣ Generate JWT (apply condition: only if user is logged in).
Add any user details you want to send securely to Intercom. Use JSON format like this example:
"user_id": "12345abc",
"email": "[email protected]",
"attribute_name": "value"

2️⃣ Load Intercom JWT
For logged-in users, this starts a safe connection using the JWT and updates their details in Intercom.
For guests (not logged in), the chat opens in anonymous visitor mode.


𝐀𝐃𝐕𝐀𝐍𝐂𝐄𝐃 𝐎𝐏𝐓𝐈𝐎𝐍

🛠️ Use the action 'Load Intercom JWT (Advanced)' if you want to add both the JWT and extra attributes that don't need protection. List the extra details in JSON format.

🔓 If you don't want to use secure mode, use this advanced action and just add your details to the "Unprotected attributes" input, and skip generating the JWT.

👉 No need to add "app_id" in any action as it will be added automatically from the plugin parameters.