# Confluence ### What you get * **Live sync from Confluence to Siit.** Selected spaces and pages sync into Siit Articles and refresh automatically — edits made in Confluence flow into Siit on the next sync. * **Source of truth stays in Confluence.** Siit reads from Confluence. It never modifies your pages. * **Powers every Siit AI surface.** Synced articles are used by AI Assist (agent reply suggestions) and the IT Agent (autonomous answers in Slack, Teams, and the Portal), with source citations linking back to the original Confluence page. * **Searchable Portal Knowledge Base.** Employees browse and search synced Confluence content directly in the Siit Portal. * **Agent-friendly inserts.** Agents can insert synced articles directly into request replies as rich cards. * **Source tracking.** Every synced article in Siit shows "Source: Confluence" with a link back to the original page. ### How the sync works * **Initial import** — once you authorize Confluence and pick the spaces or pages you want synced, Siit pulls them in and converts each one into a Siit Article. * **Continuous sync** — synced content refreshes on a schedule. Confluence edits flow into Siit automatically. * **Scope-by-space** — you control exactly what's synced. Start with one or two high-value spaces, then expand. * **Permissions are respected** — Siit honors Confluence's space and page restrictions. Pages the connected user can't access won't appear in Siit. * **Status preserved** — synced articles can be Draft or Published in Siit. You decide when to make them visible to employees. ### Where synced Confluence content shows up * **Portal Knowledge Base** — employees search and browse synced articles in the Siit self-service portal. * **AI Assist** — when an agent opens a request, AI Assist suggests relevant Confluence-sourced articles for the reply. * **IT Agent** — the AI Agent cites Confluence-sourced articles when answering employees in Slack, Teams, or the Portal. * **Request replies** — agents insert synced articles directly into responses as rich cards. * **Workflow actions** — automated replies can attach Confluence-sourced articles (e.g., "send the VPN setup guide when an access request is submitted"). ### Before you connect * A Confluence admin able to authorize the connection. * An Atlassian account with read access to the spaces you want synced. A dedicated service user is recommended so the integration survives admin turnover. * A clear idea of which spaces to sync first. Quality beats quantity for AI accuracy — start with your most-used internal docs. ### Connect Confluence 1. In Siit, go to **Settings → Integrations**, find **Confluence** in the Knowledge Base section, and click **Connect**. 2. Enter your Confluence site URL (e.g., `yourcompany.atlassian.net`) and authorize with an Atlassian account that has read access to your target spaces. 3. Pick the space(s) you want imported as Articles. 4. Run the initial sync and review the imported Articles in **Resources → Articles**. For the detailed walkthrough, see our Help Center guide: [Confluence integration setup](https://help.siit.io/confluence-integration). ### After the connection * **Review imported Articles** in **Resources → Articles**. Each one shows "Source: Confluence" with a link to the original page. * **Publish what's ready.** Synced articles default to a state where you can review and publish them deliberately. * **Categorize** — organize Articles by team or topic (IT, HR, Policies, Security) so the Portal browsing experience is clean. * **Enable AI** — make sure AI Assist and the IT Agent are configured to use your Articles. The more high-quality content you sync, the better the AI performs. * **Validate suggestions** — over the first week, watch which articles AI surfaces in real conversations. Retire or rewrite anything that's outdated or noisy. ### Sync frequency Confluence content refreshes automatically on a schedule. Trigger an immediate refresh from **Settings → Integrations → Confluence → Sync now** if you've just edited a critical page and need it reflected in Siit straight away. ### Common use cases * **AI-powered self-service.** Employees ask "How do I request VPN access?" in Slack. The IT Agent searches synced Confluence pages, finds the matching guide, and answers with a source link — no ticket created. * **Faster agent replies.** An agent opens a new password-reset request. AI Assist surfaces the three most relevant Confluence pages, and the agent inserts the right one with one click. * **Portal browsing for new hires.** A new hire lands on the Siit Portal and browses synced Confluence onboarding pages — finding answers before their Day-1 questions pile up. * **Deflection at submission.** When an employee starts submitting a service in the Portal, Siit suggests the relevant Confluence article first; many employees resolve it themselves. * **Content lifecycle alignment.** Your IT or HR team edits a policy page in Confluence. On the next sync, every Siit surface reflects the update — no manual republishing. ### Tips * **Start with a focused scope.** Sync the one or two spaces where your highest-quality, most-used documentation lives. Don't sync your entire Confluence site. * **Title pages as questions employees ask.** "How do I request VPN access?" retrieves better than "VPN Access Procedure." * **Use a dedicated service account.** Atlassian access is tied to a user — a dedicated service user keeps the integration stable across team changes. * **Keep one source of truth per topic.** If the same content exists in Confluence and another tool, pick one. AI can't judge which version is canonical. * **Review what AI is surfacing.** In **Resources → Articles**, the analytics view shows which articles AI suggests most often. Low-quality or outdated ones can be retired. ### Help Center guides * [Confluence integration setup](https://help.siit.io/confluence-integration) — step-by-step setup with screenshots ### Troubleshooting **Spaces missing from the picker.** The connecting user lacks access to those spaces in Confluence. Either grant the user access or reconnect with a different account. **A synced article is empty or partial.** Some Confluence macros (especially third-party ones) may not render in Siit. Edit the Confluence page to use native macros where possible, then re-sync. **Edits in Confluence aren't reflected in Siit.** The sync runs on a schedule. Trigger an immediate refresh from **Settings → Integrations → Confluence → Sync now**. **AI isn't suggesting Confluence articles.** Confirm the Article is set to **Published** in Siit (Drafts are excluded from AI). Also check that AI Assist or the IT Agent has Articles enabled as a source. **"Authorization failed" on connect.** The Atlassian account doesn't have access to the Confluence site, or the site has restricted third-party app installs. Try with a Confluence admin account. **"Connection lost" or reauthorization needed.** The Atlassian token has been revoked or expired. Reconnect from **Settings → Integrations → Confluence**. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.siit.io/integrations/knowledge-base/confluence.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.