Interaction or conversation

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

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.

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.

To share a page with someone who does not have a Nebuly account, use an anonymous Share link instead. See Sharing pages in Nebuly.

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.

Get Interaction Deep Link

Get the deep link URL for an interaction.

Get Conversation Deep Link

Get the deep link URL for a conversation.

Example

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

Interactions API

List interactions and retrieve their IDs.

Interaction Aggregates API

Retrieve interactions aggregated by conversation.

Interaction Details API

Retrieve details for a specific interaction.

​Preferred approach: /go URLs

​Alternative: External Deep Link API

Get Interaction Deep Link

Get Conversation Deep Link

​Fallback: Construct the URL manually

​URL structure

​Required parameters

Interactions API

Interaction Aggregates API

Interaction Details API

Preferred approach: `/go` URLs

Alternative: External Deep Link API

Fallback: Construct the URL manually

URL structure

Required parameters