Integrations
Connectors map external records to artifacts with explicit field ownership. Settings live in integrations/*.yaml (every save is a commit); credentials are encrypted on this server, outside the workspace repo.
Jira Cloud
disabledEpics/issues by JQL → roadmap items (status, dates, owner, progress), matched on jira_key. Optional feedback_jql → feedback. link.projects scopes the epic/issue pickers when delivery.tool is jira.
*/30 * * * *jira_searchjira_get_issuePostHog
disabledMetrics with source_system: posthog and query_ref insight:<id> or hogql:<query> → current value + dated history.
0 6 * * *posthog_queryposthog_get_insightposthog_list_eventsSalesforce
disabledCases → feedback with account, ARR and a link back to the case. Read-only SOQL tool for agents.
0 */2 * * *salesforce_soqlZendesk
disabledTickets matching a search filter → feedback with organization, ARR from an organization field and a link back. Read-only zendesk_search tool. Signs in with OAuth: add the OAuth client, then Connect the account.
0 */2 * * *zendesk_searchGoogle Sheets
disabledRows of shared sheets (Google Forms responses, CS trackers) → feedback with column mapping. Share each sheet with the service account.
*/30 * * * *Google Chat
enabled/feedback Acme: … anywhere/api/webhooks/google-chat: the Chat app audience not setConfigured in integrations/google-chat.yaml. Agents with notify: [google-chat] post their run summaries. Setup: docs/deploy-coolify.md → Google Workspace.
Sync log
| Finished | Connector | Trigger | Records | Created | Updated | Skipped | Errors | Problems |
|---|
No syncs yet. Connect an integration, then Test and Dry run it.
Import feedback from CSV
Inbound webhooks
Disabled: the webhook signing secret not set. Requests are signed with X-KANO-Signature: sha256=<HMAC of the body>.
POST /api/webhooks/inbound: one feedback item or an array (n8n, Make, Zapier). Idempotent onsource.system + source.external_id.POST /api/webhooks/jira(or any connector): queues an incremental sync of that connector.
body='{"verbatim":"Need SSO","channel":"support","source":{"system":"zapier","external_id":"4711"}}'
sig="sha256=$(printf %s "$body" | openssl dgst -sha256 -hmac "$KANO_WEBHOOK_SECRET" | cut -d' ' -f2)"
curl -X POST localhost:3000/api/webhooks/inbound -H "x-kano-signature: $sig" -d "$body"