Documentation index for AI agents (llms.txt)
Skip to main content

Intercom

Add Intercom's Messenger to every page of your site, so visitors can chat with you and your team answers from Intercom.

Connect​

Intercom connects with your App ID.

  1. Open Settings > Connectors, click Intercom, then Connect.
  2. Intercom's Messenger install page opens. Copy the app_id from the install code.
  3. Come back to WebTwizz. The App ID is picked up and connected. You can also paste it into App ID yourself.

WebTwizz doesn't check the App ID with Intercom, so make sure you copied all of it.

The Messenger goes into your project's connector code right away. It shows in your preview too, so you can try it, and on your published site after you publish.

What you see​

Intercom in a project: the App ID account and its setting
  • Overview: The inbox needs Intercom sign-in. The Messenger works with the App ID alone, but showing your open conversations here needs a sign-in to Intercom.
  • Account: the App ID. To use another one, connect it as another account and switch to it.
  • Settings:
    • Show to signed-in users only: the Messenger only opens for users who signed in to your site, once your site starts it for them. Ask the AI to set that up.
    • Identity verification secret: so each conversation follows the signed-in user it belongs to. Click Add, paste the secret from Intercom's identity verification settings under Secret, and click Save secret. It stays on the server and is never shown again. Replace puts in a new one and Remove takes it out.
    • Live site: Running, Publish to update or After you publish.

What the AI can do​

  • Start the Messenger for signed-in users, with their name and email, and end it when they sign out
  • Sign each user with your identity verification secret on the server, when you've added one

It can't read your conversations: an App ID gives no access to your Intercom inbox.

Secrets​

  • NEXT_PUBLIC_INTERCOM_APP_ID: your Intercom App ID, used by the Messenger in the browser
  • INTERCOM_IDENTITY_SECRET: your identity verification secret, server-side only, when you add one

Good to know​

  • Signing in to Intercom, which would bring your inbox into the builder and the chat, isn't available yet.
  • Removing Intercom from a project takes the Messenger off the site and its secrets out. Your Intercom workspace and conversations are untouched.