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

# Support

> How to reach the TrueFoundry support team — when to use the shared Slack/Teams channel and when to use the in-product Support Portal.

TrueFoundry tracks every customer issue, bug, and feature request in a single Support Portal so nothing gets lost in chat history. You can also visit [truefoundry.com/support](https://www.truefoundry.com/support) for an overview of all support channels and SLAs.

There are two ways to open a ticket:

1. **From your shared Slack or Microsoft Teams channel** *(recommended)* — tag **`@TrueFoundry Team`** in the thread, and a portal ticket is created automatically.
2. **From the in-product Support Portal** — open it directly when Slack/Teams is restricted on your network, when you don't have a shared channel set up, or when you want to attach long descriptions, screenshots, or logs through a structured form.

<Tip>
  Prefer Slack or Teams for everything — even bugs and feature requests. The integration logs the message into the Support Portal automatically, so you keep the conversation in your team's chat **and** get the same tracking, SLAs, and history as a portal-raised ticket.
</Tip>

## Walkthrough

<iframe src="https://drive.google.com/file/d/1VDimAHfJ2o0sbAaOa0d13Q_UVjuaFuBI/preview" width="100%" height="475px" allow="autoplay" style={{ border: "none", display: "flex", margin: "auto" }} />

## Option 1 — Raise a ticket from Slack or Microsoft Teams (recommended)

If TrueFoundry has set up a shared Slack or Microsoft Teams channel with your organisation, this is the fastest way to reach us — the message stays in the conversation thread your team is already using, and the integration mirrors it into the Support Portal so it gets the same tracking and SLAs.

<Steps>
  <Step title="Tag the TrueFoundry team in your shared channel">
    In the shared Slack or Teams channel, start a thread describing your issue and tag **`@TrueFoundry Team`**. The bot replies in-thread to confirm a ticket has been opened and shares the ticket ID.

    <Frame caption="Tag @TrueFoundry Team in Slack to open a ticket">
      <img src="https://mintcdn.com/truefoundry/xnxwG9wbAPzCd_DD/images/support-portal-5.png?fit=max&auto=format&n=xnxwG9wbAPzCd_DD&q=85&s=50b09e3e2c140eb5fd3679e7e982be2a" alt="Slack thread tagging the TrueFoundry Team and the bot replying with a new ticket ID" width="276" height="192" data-path="images/support-portal-5.png" />
    </Frame>
  </Step>

  <Step title="Add priority and component details">
    The bot follows up in the same thread with a short form asking for **Priority** (P0–P3) and **Question Type** (component affected — gateway, infra, MCP, etc.). Fill them in and click **Submit**.

    <Frame caption="Slack/Teams follow-up form for priority and component">
      <img src="https://mintcdn.com/truefoundry/xnxwG9wbAPzCd_DD/images/support-portal-6.png?fit=max&auto=format&n=xnxwG9wbAPzCd_DD&q=85&s=14805e6cebd7b5528a5c9185facc7717" alt="TrueFoundry Support bot asking for Priority and Question Type before submitting the ticket" width="314" height="338" data-path="images/support-portal-6.png" />
    </Frame>
  </Step>

  <Step title="Track the ticket in the Support Portal">
    The ticket is now visible in the Support Portal alongside any tickets you raised through the UI. You can keep replying in the Slack/Teams thread — every message is mirrored to the portal automatically.
  </Step>
</Steps>

## Option 2 — Raise a ticket from the in-product Support Portal

Use the portal directly when:

* Your organisation has not set up a shared Slack/Teams channel with TrueFoundry.
* Slack or Teams is restricted on your corporate network.
* You want to attach a long description, structured logs, or multiple screenshots through a form.
* You want to file a ticket on behalf of someone else, or browse and filter the full ticket history.

### Prerequisites

* You have access to your TrueFoundry tenant.
* The Support Portal is enabled for your account.

<Note>
  **If you do not see the “Support” button** in the left navigation, the portal may not be enabled for your tenant or your control plane could be on an older version. Reach out to your TrueFoundry Customer Success contact to enable it.

  <Frame caption="Support entry point in the TrueFoundry sidebar">
    <img src="https://mintcdn.com/truefoundry/xnxwG9wbAPzCd_DD/images/support-portal-1.png?fit=max&auto=format&n=xnxwG9wbAPzCd_DD&q=85&s=3098a257392d963f5b84db3bd2121f56" alt="Support menu item in the TrueFoundry left sidebar with Raise a ticket and Chat with us options" width="312" height="90" data-path="images/support-portal-1.png" />
  </Frame>
</Note>

<Steps>
  <Step title="Open the Support Portal">
    Sign in to TrueFoundry, click **Support** in the left sidebar (under **Help & Support**), and choose **Raise a ticket**. You'll be redirected to the Support Portal in a new tab.

    <Frame caption="Support menu expanded from the bottom-left of the TrueFoundry UI">
      <img src="https://mintcdn.com/truefoundry/xnxwG9wbAPzCd_DD/images/support-portal-2.png?fit=max&auto=format&n=xnxwG9wbAPzCd_DD&q=85&s=467323992506a4bdeadd1b3fb8c38ee4" alt="TrueFoundry UI with the Support menu expanded showing Raise a ticket and Chat with us options" width="3022" height="1646" data-path="images/support-portal-2.png" />
    </Frame>
  </Step>

  <Step title="Click Create Ticket and pick the ticket type">
    In the portal, click **Create Ticket** and choose:

    * **Support Ticket** — general help, guidance, or how-to questions.
    * **Bug** — something is not working as expected.
  </Step>

  <Step title="Fill in the ticket details">
    | Field                  | What to put                                                                                                                                                                                  |
    | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Subject**            | Short, specific title. e.g. *"Service deployment failing in `prod` cluster"*                                                                                                                 |
    | **Description**        | What you expected, what actually happened, reproduction steps (for bugs), relevant timestamps, error messages or log snippets. Links to logs/dashboards help us debug faster.                |
    | **Priority**           | `P0` blocking production / major outage · `P1` core feature broken or major workflow blocked · `P2` issue with a workaround, moderate impact · `P3` minor issue, cosmetic, small improvement |
    | **Component Affected** | The product area the issue belongs to (infra, gateway, MCP, deployments, …).                                                                                                                 |

    <Frame caption="Support Ticket form with Subject, Description, Priority, and Component Affected">
      <img src="https://mintcdn.com/truefoundry/xnxwG9wbAPzCd_DD/images/support-portal-3.png?fit=max&auto=format&n=xnxwG9wbAPzCd_DD&q=85&s=c4490a3e869a45983050c382f6d2366f" alt="TrueFoundry Support Portal ticket form showing Name, Email, Subject, Description, Priority and Component Affected fields" width="1508" height="1394" data-path="images/support-portal-3.png" />
    </Frame>

    Click **Submit** when you're done.
  </Step>

  <Step title="Track ticket status and history">
    The ticket appears immediately in the portal. Returning to the portal at any time shows you:

    * **Issue ID**
    * Who raised it
    * Priority
    * Created time
    * Current status and the latest updates from the TrueFoundry team

    <Frame caption="Support Portal ticket list grouped by ownership">
      <img src="https://mintcdn.com/truefoundry/xnxwG9wbAPzCd_DD/images/support-portal-4.png?fit=max&auto=format&n=xnxwG9wbAPzCd_DD&q=85&s=dc19107cb20c1d72264bc07797f3c694" alt="TrueFoundry Support Portal listing tickets under On TrueFoundry and On you sections with Issue ID, Requester, Issue title, Priority, Due On and Created columns" width="3010" height="1630" data-path="images/support-portal-4.png" />
    </Frame>
  </Step>
</Steps>

## Best practices

To help us resolve your tickets faster, include:

* **Environment** — `prod`, `staging`, or `dev` (and which cluster/workspace).
* **Impact** — who is blocked, what is failing, and how many users are affected.
* **Logs and screenshots** — links to logs in your observability stack are even better than pasted snippets.
* **Reproduction steps** — for bugs, the minimum sequence we need to follow to see the same failure.
* **What changed recently** — recent deployments, config changes, version upgrades, or new integrations are usually where bugs live.

## FAQ

<AccordionGroup>
  <Accordion title="Should I raise a ticket for every question?">
    No — small, quick questions can stay in your shared Slack/Teams channel without tagging `@TrueFoundry Team`. Open a ticket (either through the channel tag or the portal) when the issue needs tracking, has business impact, or is anything that affects production.
  </Accordion>

  <Accordion title="I raised something on Slack/Teams — will it actually be tracked?">
    Yes, as long as you tag **`@TrueFoundry Team`** in the thread. The integration creates a portal ticket and links the conversation to it. If you forgot to tag, just edit the message or post a follow-up that tags us.
  </Accordion>

  <Accordion title="Can I switch from Slack/Teams to the portal mid-conversation?">
    Yes. Every Slack/Teams ticket has a portal ticket ID; you can open that ticket in the Support Portal at any point to attach files, reply with a longer description, or hand off the issue to a teammate.
  </Accordion>

  <Accordion title="What if my organisation does not have a shared Slack or Teams channel with TrueFoundry?">
    Use the in-product Support Portal (Option 2 above) for all tickets. If you'd like a shared channel set up, ask your TrueFoundry Customer Success contact.
  </Accordion>
</AccordionGroup>
