> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rodyne.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Diagnose common setup, identity, role, ticket, and provider-job problems.

Start with the affected record, then check **Bot Management → Activity** and the relevant integration health page.

## Setup and connection

<AccordionGroup>
  <Accordion title="The Discord server is missing during activation">
    Confirm the signed-in Discord account can manage the guild. Retry the managed-server lookup. If the account recently gained access, sign out and back in before retrying.
  </Accordion>

  <Accordion title="The bot was invited but setup does not advance">
    Confirm Rodyne joined the exact selected guild. Check that the invitation was not authorized for another server, then retry the membership check.
  </Accordion>

  <Accordion title="The Roblox key is active but rejected">
    Confirm it belongs to an individual account, not the group; includes `group:read` and `group:write`; targets the correct group; and its owner can administer that group.
  </Accordion>

  <Accordion title="Studio has no heartbeat">
    Confirm HTTP requests are enabled, the server script is published, the credential uses the universe ID, the hooks origin has no trailing slash, and the credential is not revoked.
  </Accordion>
</AccordionGroup>

## Verification and roles

<AccordionGroup>
  <Accordion title="Verification says providers disagree">
    Ask the member to complete first-party Cnect verification. Do not select one provider result manually unless the ownership conflict is reviewed through the supported flow.
  </Accordion>

  <Accordion title="A mapped Discord role did not change">
    Check verified identity, group membership lookup, Group ID and Rank ID, protection, shared-role behavior, bot hierarchy, and the job detail.
  </Accordion>

  <Accordion title="Promote or demote is blocked">
    Check for duplicate order numbers, a protected adjacent mapping, stale current rank, missing permission, or an active request for the mapping.
  </Accordion>
</AccordionGroup>

## Tickets and announcements

<AccordionGroup>
  <Accordion title="Ticket panel preflight fails">
    Review every type, not only the selected one. Confirm panel channel, private category, support roles, questions, button count, emoji availability, and bot permissions.
  </Accordion>

  <Accordion title="A Discord delivery is uncertain">
    Inspect the actual channel/message first. If it exists, do not retry the provider write. Use repair only after the live state is understood.
  </Accordion>

  <Accordion title="Ticket history has a gap">
    Keep the worker online for the history sweep. A message deleted during downtime cannot be reconstructed, and expired attachment URLs cannot be recovered by Rodyne.
  </Accordion>
</AccordionGroup>

## Rank and moderation jobs

<AccordionGroup>
  <Accordion title="The request is waiting forever">
    Check required approval count, approver access, expiry, entitlement, and whether the requester attempted to self-approve.
  </Accordion>

  <Accordion title="Roblox changed but Discord did not">
    Treat this as partial completion. Do not repeat the Roblox change. Inspect and repair only the Discord synchronization target.
  </Accordion>

  <Accordion title="A moderation DM was not delivered">
    The moderation can still be complete. Closed or blocked DMs are recorded as undelivered; an interrupted result can be unknown to prevent duplicates.
  </Accordion>
</AccordionGroup>

## What to include in a support request

Provide the workspace name, affected record/reference, approximate time and timezone, current outcome label, and the page where it occurred. Never include passwords, tokens, API keys, connector secrets, or private evidence unless a trusted support process explicitly requests an approved secure transfer.

## Guided walkthrough

<Frame caption="Activity is the first stop for correlation IDs, target outcomes, retries, and provider failures.">
  <img src="https://mintcdn.com/rodyne/3VLEvtRzxXCeXuB_/assets/screenshots/activity-main.png?fit=max&auto=format&n=3VLEvtRzxXCeXuB_&q=85&s=aa34e91db4b6746d0f6a4291cb29f70f" alt="Rodyne Activity page used to diagnose background work" width="990" height="742" data-path="assets/screenshots/activity-main.png" />
</Frame>

The screenshot above is from the live Rodyne product. Use it to orient yourself, but rely on the current record state and live provider checks when operating the workspace.

## Operating procedure

<Steps>
  <Step title="Name the affected record">
    Capture the workspace, record ID, actor, and approximate time.
  </Step>

  <Step title="Open its job">
    Use Activity or the record link to find every provider target.
  </Step>

  <Step title="Read the terminal detail">
    Distinguish validation failure, safe failure, partial completion, and uncertainty.
  </Step>

  <Step title="Check live state">
    Inspect the Discord, Roblox, or Studio object before any retry.
  </Step>

  <Step title="Repair narrowly">
    Use the offered action for only the failed or unconfirmed target.
  </Step>
</Steps>

## Acceptance checks

| Check   | Ready when                             | If it is not ready                        |
| ------- | -------------------------------------- | ----------------------------------------- |
| Context | Workspace and record are exact         | Return to the source record               |
| State   | Every provider target is accounted for | Wait or investigate the unresolved target |
| Retry   | Live state proves retry is safe        | Escalate without retrying                 |

## Failure recovery

If no safe repair is offered, preserve the job ID and current provider state. Include timestamps and outcome codes in support requests, but never include credentials or restricted evidence in an unapproved channel.

## Continue the workflow

<CardGroup cols={2}>
  <Card title="Outcomes and jobs" href="/reference/outcomes-and-jobs" icon="activity" />

  <Card title="Integration setup" href="/setup/discord" icon="message-circle" />
</CardGroup>
