1. Sync-O didn't update my page
Symptoms:
Ticket moved to "Done", but no update appeared on Confluence.
Possible Causes:
- No Link: The Jira ticket description did not contain a link to a Confluence page.
- Permissions: The Sync-O app user doesn't have edit permission on that specific Confluence page/space.
- Irrelevant: The AI deemed the ticket "Not Relevant" (Confidence Score = 0).
Steps to Fix:
- Check Links: Ensure the full URL to the Confluence page is present in the Jira ticket description or comments.
- Check Logs: Look for a comment on the Jira ticket. If none exists, check if the app is active in Jira settings.
- Check Permissions: Verify that "Apps" or the Sync-O user has "Add/Edit" permission in the Confluence Space settings.
2. Updates are always saved as Drafts
Symptoms:
You see comments saying "Draft Created" but nothing is published
automatically.
Cause: Your Auto-Publish Threshold is set too high, or the AI is not confident enough in the changes.
Steps to Fix:
- Go to Sync-O Settings → Quality Control.
- Lower the threshold (e.g., try 80% or 75%).
- Review the draft manually to see why the AI was hesitant (usually ambiguous ticket info).
3. "BYOM Verification Failed"
Cause: Invalid API Key, expired credits, or network restrictions.
Steps to Fix:
- Regenerate a new key from your provider (OpenAI/Anthropic).
- Check your billing status with the provider.
- Ensure no firewalls block outbound requests to
api.openai.comorapi.anthropic.com.
4. Smart Hub shows "Upgrade to Advanced"
Cause: Your license is Standard Edition; Smart Hub requires Advanced Edition.
Steps to Fix:
- Upgrade to Advanced Edition via the Atlassian Marketplace.
- Once upgraded, the Smart Hub will be fully accessible.
Note: Standard Edition includes automatic doc updates on ticket completion - you don't need Smart Hub for the core automation to work.