How it works
SiteGPT connects to Intercom’s messaging platform to provide intelligent, automated responses:Automatic responses
Bot answers customer messages instantly using your trained knowledge base
Ticket deflection
Reduce support load by handling repetitive questions automatically
Human handoff
Seamlessly escalates to your Intercom team when the AI can’t help
Full visibility
All conversations sync to both Intercom and SiteGPT dashboards
Prerequisites
An Intercom account with Messenger enabled
Developer access to create an Intercom Access Token
A trained SiteGPT chatbot ready to deploy
Setup
Create an Intercom Access Token
Log in to your Intercom account and navigate to Settings → Developers → Developer Hub.Click New app to create a new developer application, or select an existing one.Navigate to Authentication and create a new Access Token with the following permissions:
- Read and write conversations
- Read users and leads
- Read and manage webhooks
For detailed instructions, see Intercom’s guide on creating access tokens.
Connect to SiteGPT
In your SiteGPT dashboard, navigate to Integrations → Intercom and click Get Started.Paste your Intercom Access Token in the provided field.Click Connect to establish the integration.SiteGPT will display a Webhook URL and Webhook Secret. Keep these for the next step.
Configure the Intercom webhook
Back in your Intercom Developer Hub, navigate to Webhooks.Click Add Webhook and paste the Webhook URL from SiteGPT.Enter the Webhook Secret provided by SiteGPT for request verification.Subscribe to the following webhook topics:
conversation.user.created— triggers when a user starts a new conversationconversation.user.replied— triggers when a user sends a message
Configuration options
Response behavior
Control how your bot responds in Intercom:| Setting | Description |
|---|---|
| Auto-respond | Bot replies immediately to all new conversations |
| Business hours only | Bot responds only outside your team’s working hours |
| Escalation keywords | Phrases that trigger immediate human handoff |
Human handoff
When escalation occurs, SiteGPT:- Stops responding to the conversation
- Marks the conversation for human review in Intercom
- Preserves full context for your support team
Troubleshooting
Bot not responding to messages
Bot not responding to messages
Check your webhook configuration:
- Verify the webhook URL is correct in Intercom
- Ensure webhook topics include
conversation.user.createdandconversation.user.replied - Confirm the webhook secret matches between Intercom and SiteGPT
- Ensure the token has the required permissions
- Regenerate the token if it may have expired
Duplicate responses
Duplicate responses
This can occur if multiple webhook subscriptions exist. In your Intercom Developer Hub, ensure you have only one active webhook pointing to SiteGPT.
Messages not appearing in SiteGPT
Messages not appearing in SiteGPT
Verify the integration is connected in SiteGPT (green status indicator). If disconnected, re-enter your Access Token to reconnect.
Disconnecting
To remove the integration:- In SiteGPT, go to Integrations → Intercom and click Disconnect
- In Intercom Developer Hub, delete or disable the webhook
- Optionally, revoke the Access Token if no longer needed