> ## 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.

# Deep-link to an interaction or conversation

> Generate a direct URL to any interaction or conversation in Nebuly's Live Activity page.

A deep link looks like this:

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

<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>

***

## Method 1: Use the Deep Link API (recommended)

The easiest way is to call the Deep Link API with just the `interaction id` or `conversation id` and your API key. Nebuly resolves all the other parameters for you and returns the full 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"]
```

***

## Method 2: Construct the URL manually

If you already have all the required IDs, you can build the URL yourself without making an API call.

### 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>