Help us improve
Share bugs, ideas, or general feedback.
From interkasten
Webhook Setup — Configure Notion webhook sync
npx claudepluginhub mistakeknot/interagency-marketplace --plugin interkastenHow this skill is triggered — by the user, by Claude, or both
Slash command
/interkasten:webhook-setupThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Guide the user through configuring Notion webhook-driven sync for interkasten, including deployment path selection, config writing, and step-by-step external service setup.
Guides technical evaluation of code review feedback: read fully, restate for understanding, verify against codebase, respond with reasoning or pushback before implementing.
Share bugs, ideas, or general feedback.
Guide the user through configuring Notion webhook-driven sync for interkasten, including deployment path selection, config writing, and step-by-step external service setup.
Use when: user says "set up webhooks", "configure webhook sync", "interkasten webhook setup", "set up Notion webhooks", or invokes /interkasten:webhook-setup.
Call interkasten_config_get with key sync.webhook to see if webhooks are already configured.
Ask the user which deployment path to use (use AskUserQuestion):
Based on the deployment path, ask for additional details:
All paths:
/webhooks/notion)Cloud Bridge only (additional):
Use AskUserQuestion to gather these. Offer sensible defaults — most users should just accept them.
Call interkasten_config_set for each value:
interkasten_config_set key="sync.webhook.enabled" value=true
interkasten_config_set key="sync.webhook.port" value=<port>
interkasten_config_set key="sync.webhook.path" value=<path>
interkasten_config_set key="sync.webhook.secret" value=<secret> (if provided)
For cloud bridge deployments, also set:
interkasten_config_set key="sync.cloud_bridge.url" value=<url>
interkasten_config_set key="sync.cloud_bridge.token" value=<token>
interkasten_config_set key="sync.cloud_bridge.poll_ms" value=<poll_ms>
interkasten_config_set key="sync.cloud_bridge.batch_size" value=<batch_size>
Run the CLI guide command to display deployment-specific instructions:
cd <interkasten-server-dir> && node dist/cli/webhook-setup.js guide --deployment <path> --port <port> --path <webhookPath>
This prints markdown with:
Present the output to the user. The guide contains clickable links to Notion and Cloudflare documentation.
After the user confirms they've completed the external setup steps, run a quick verification:
interkasten_config_get to confirm config was writtenINTERKASTEN_NOTION_TOKEN is set (from interkasten_health if available)Present configuration results as a summary:
Webhook Configuration Complete
Deployment: cloudflare
Port: 8787
Path: /webhooks/notion
Secret: auto-detect
Next: Follow the setup guide above, then start the daemon with `npm start`.
interkasten_config_set fails, report the error and suggest checking file permissions on ~/.interkasten/config.yamlcd server && node dist/cli/webhook-setup.js configure --deployment <path> --port <port>