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

# Interaction or conversation

> Generate a direct URL to any interaction or conversation in Nebuly.

Use a deep link to send authenticated Nebuly users directly to a specific interaction or conversation in Nebuly.

<Info>
  This feature is available only in the new frontend version. If you are using
  Nebuly SaaS, use `v2.platform.eu.nebuly.com`. If you are self-hosted, you need
  to use your own domain pointing to the new frontend version.
</Info>

***

## Preferred approach: `/go` URLs

For authenticated users, use a `/go` URL. This is the default recommendation when you want to link colleagues who already have Nebuly access to a specific interaction or conversation.

```
https://v2.platform.eu.nebuly.com/go/interactions/{id}
https://v2.platform.eu.nebuly.com/go/conversations/{id}
```

When you know the project ID, use a project-scoped path:

```
https://v2.platform.eu.nebuly.com/go/projects/{projectId}/interactions/{id}
https://v2.platform.eu.nebuly.com/go/projects/{projectId}/conversations/{id}
```

When a user opens a `/go` link, Nebuly resolves it via the platform deeplink API and redirects to the right interaction or conversation page. The user must be logged in to Nebuly.

`/go` links are also a good fit for spreadsheet-based workflows. For example, you can add a column with Nebuly links next to interaction or conversation IDs in a spreadsheet application such as Microsoft Excel, so reviewers can open the corresponding Nebuly page directly.

<Note>
  To share a page with someone who does not have a Nebuly account, use an
  anonymous Share link instead. See [Sharing pages in
  Nebuly](/guides/sharing-pages).
</Note>

***

## Alternative: External Deep Link API

When you need to generate deep links programmatically (for example, from a backend service with an API key), call the External Deep Link API. Nebuly resolves all the other parameters for you and returns the full `/live-activity` URL.

<CardGroup cols={2}>
  <Card title="Get Interaction Deep Link" icon="code" href="/embedded-pages/deeplinks/get-interaction-deeplink">
    Get the deep link URL for an interaction.
  </Card>

  <Card title="Get Conversation Deep Link" icon="code" href="/embedded-pages/deeplinks/get-conversation-deeplink">
    Get the deep link URL for a conversation.
  </Card>
</CardGroup>

**Example**

```python theme={null}
import requests

NEBULY_API_KEY = "<your-api-key>"
NEBULY_API_BASE_URL = "https://backend.nebuly.com/api/external"

def get_interaction_deeplink(interaction_id: str) -> str:
    response = requests.get(
        f"{NEBULY_API_BASE_URL}/deeplinks/interaction/{interaction_id}",
        headers={"Authorization": f"Bearer {NEBULY_API_KEY}"},
    )
    response.raise_for_status()
    return response.json()["url"]
```

***

## Fallback: Construct the URL manually

If you already have all the required IDs and cannot use a `/go` link or the API, you can build the `/live-activity` URL yourself.

A deep link looks like this:

```
https://v2.platform.eu.nebuly.com/live-activity?projectId=<projectId>&organizationId=<organizationId>&interactionId=<interactionId>&liveActivityPageTab=interactions
```

### URL structure

```
https://v2.platform.eu.nebuly.com/live-activity
  ?projectId=<projectId>
  &organizationId=<organizationId>
  &interactionId=<interactionId>
  &liveActivityPageTab=interactions
```

For a conversation, replace `interactionId` with `conversationId` and set `liveActivityPageTab=conversations`.

### Required parameters

| Parameter                          | Description                                                                        |
| ---------------------------------- | ---------------------------------------------------------------------------------- |
| `projectId`                        | Visible in the URL when you navigate to any page in Nebuly                         |
| `organizationId`                   | Visible in the URL when you navigate to any page in Nebuly                         |
| `interactionId` / `conversationId` | Retrievable via the Interactions API                                               |
| `liveActivityPageTab`              | Use `interactions` for interaction links or `conversations` for conversation links |

<CardGroup cols={2}>
  <Card title="Interactions API" icon="code" href="/embedded-pages/interactions/get-interactions">
    List interactions and retrieve their IDs.
  </Card>

  <Card title="Interaction Aggregates API" icon="code" href="/embedded-pages/interactions/get-interaction-aggregates">
    Retrieve interactions aggregated by conversation.
  </Card>

  <Card title="Interaction Details API" icon="code" href="/embedded-pages/get-interaction-details-v2">
    Retrieve details for a specific interaction.
  </Card>
</CardGroup>