install-messenger
Install Intercom Messenger
Help the user install the Intercom Messenger on their website or application with JWT-based identity verification. This is the secure default — it prevents user impersonation by cryptographically signing user identity on the server.
Only use the insecure (non-JWT) installation if the user explicitly asks for an "insecure installation". Never default to it.
Requirements
Gather these from the user before proceeding:
-
Workspace ID (also called App ID) — A short alphanumeric string like
abc12345.- Found on the Intercom Messenger install page
- Or in the URL bar:
https://app.intercom.com/a/apps/<workspace_id>/...
-
Identity Verification Secret (also called Messenger API Secret) — Found on the Messenger Security page. This is the HMAC secret used to sign JWTs. It must never appear in frontend code.
Ask the user for both values. Do not proceed without the Workspace ID. If they don't have the Identity Verification Secret yet, direct them to the Messenger Security page to enable it.
In all generated code, replace YOUR_WORKSPACE_ID with the user's actual Workspace ID. Do not leave placeholders — substitute the real values they provided.