intercom-webhooks-events

Featured

Implement Intercom webhook handling and data event tracking. Use when setting up webhook endpoints, processing Intercom notifications, or submitting custom data events for contact activity tracking. Trigger with phrases like "intercom webhook", "intercom events", "intercom webhook signature", "handle intercom events", "intercom data events", "track intercom events".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Intercom Webhooks & Events ## Overview Handle incoming Intercom webhooks (notifications) with signature verification and implement outbound data event tracking via the Events API. ## Prerequisites - HTTPS endpoint accessible from internet - Webhook secret from Intercom Developer Hub - `intercom-client` SDK installed - Redis or database for idempotency (recommended) ## Part 1: Incoming Webhooks (Notifications) ### Step 1: Webhook Endpoint with Signature Verification Intercom signs webhooks with HMAC-SHA1 via the `X-Hub-Signature` header. ```typescript import express from "express"; import crypto from "crypto"; const app = express(); // IMPORTANT: Use raw body for signature verification app.post( "/webhooks/intercom", express.raw({ type: "application/json" }), async (req, res) => { const signature = req.headers["x-hub-signature"] as string; const secret = process.env.INTERCOM_WEBHOOK_SECRET!; if (!signature) { return res.status(401).json({ error: "Missing X-Hub-Signature" }); } // Verify HMAC-SHA1 signature const expected = "sha1=" + crypto .createHmac("sha1", secret) .update(req.body) .digest("hex"); if (!crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) { console.error("Webhook signature verification failed"); return res.status(401).json({ error: "Invalid signature" }); } // MUST respond within 5 seconds or Intercom treats as failure // Parse and queue for as...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category