Skip to content

feat: add intercom-webhooks skill#46

Merged
leggetter merged 2 commits into
mainfrom
feat/intercom-webhooks
May 11, 2026
Merged

feat: add intercom-webhooks skill#46
leggetter merged 2 commits into
mainfrom
feat/intercom-webhooks

Conversation

@leggetter
Copy link
Copy Markdown
Collaborator

Summary

Adds a complete intercom-webhooks provider skill — X-Hub-Signature (Facebook-style) HMAC-SHA1 verification using the app's Client Secret.

What's included

  • skills/intercom-webhooks/SKILL.md — entry point
  • skills/intercom-webhooks/references/ — overview, setup, verification
  • skills/intercom-webhooks/examples/ — Express, Next.js, FastAPI handlers with passing tests

Notes

  • Header: X-Hub-Signature (Facebook-style)
  • Algorithm: HMAC-SHA1 over the raw request body, hex-encoded, formatted as sha1=<hex>
  • Signing key: App's Client Secret (from Basic Info page in Developer Hub)
  • Common topics: conversation.user.created, conversation.user.replied, conversation.admin.replied, conversation.admin.assigned, contact.created, ticket.created, ping (handshake)

Test plan

  • cd skills/intercom-webhooks/examples/express && npm test
  • cd skills/intercom-webhooks/examples/nextjs && npm test
  • cd skills/intercom-webhooks/examples/fastapi && pytest test_webhook.py -v
  • Verify against a real Intercom-signed webhook with ping topic
  • Confirm topic names match https://developers.intercom.com/docs/webhooks

Generation details

https://claude.ai/code/session_01NNTgQRJss1V7gyzzJ9rjnB


Generated by Claude Code

claude and others added 2 commits May 11, 2026 23:16
Receive and verify Intercom webhooks using X-Hub-Signature (HMAC-SHA1
over the raw body with the app's client_secret). Includes runnable
Express, Next.js, and FastAPI examples with passing tests, plus
overview/setup/verification references and providers.yaml + README
integration.
…urce arg

Applies the new project convention from PR #40: use
`npx hookdeck-cli listen <port> <source> --path /webhooks/<source>`
everywhere instead of `hookdeck listen <port> --path /webhooks/<source>`.
Skips the global-install prereq (webhook-skills is provider-neutral) and
passes the required `[source]` positional so the command is copy-paste-
runnable without falling into an interactive prompt.

https://claude.ai/code/session_01NNTgQRJss1V7gyzzJ9rjnB
@leggetter leggetter force-pushed the feat/intercom-webhooks branch from df38c88 to fd48b91 Compare May 11, 2026 22:16
@leggetter leggetter marked this pull request as ready for review May 11, 2026 22:16
@leggetter leggetter merged commit 36541ac into main May 11, 2026
6 checks passed
@leggetter leggetter deleted the feat/intercom-webhooks branch May 11, 2026 22:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants