# Create Conversation URL Action

This action will generate a share URL for the current conversation. The share will be valid for the specified amount of time and may allow take over of the conversation.

<figure><img src="https://2532694803-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvGYwUmVjfELEiJzfmWLC%2Fuploads%2FVQHymj1qW66qPMFEgxiu%2Fimage.png?alt=media&#x26;token=c98b20af-cf9a-42cf-9cf2-443c4f3722cc" alt=""><figcaption></figcaption></figure>

### Settings

The action uses the following settings:

| Setting                      | Description                                                                                      | [Parsed](https://docs.xenioo.com/actions-and-operations/dynamic-parsing) |
| ---------------------------- | ------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
| Validity                     | The number of hours the URL will be valid                                                        | :white\_check\_mark:                                                     |
| Generate New Share Id        | If enabled, each time the action is executed a new unique id will be created for the shared url. | :no\_entry:                                                              |
| Take Over Conversation       | If enabled, conversation will be taken over as soon as the link is accessed                      | :no\_entry:                                                              |
| Auto Hand-Over on expiration | If enabled, the conversation will be automatically handed over to Xenioo when the URL expires    | :no\_entry:                                                              |

### Remarks

The generated conversation URL allows anyone to view and (if required) take over the conversation. Using this action creates the same result as the conversation section [contacts command](https://docs.xenioo.com/conversations/take-over#share).

Every time the action is invoked during flow execution, a new, unique share id will be generated by default. Uncheck the *Generate New Share Id* option to keep reusing the same id for all the conversation duration.

{% hint style="danger" %}
The generated URL has no access policy attached and can be accessed by anyone that receives the link. Please ensure tht the link is correctly shared only to people that should rightfully access that information.
{% endhint %}

{% hint style="info" %}
Using shared conversations view requires the [Pro Team Package](https://docs.xenioo.com/basic-concepts/chatbot-details/chatbot-teams) license package. Additionally, your bot must also be published on the Web Channel to fully work with shared views, even on other channels.
{% endhint %}

### Trigger

This action has no triggers.

### Variables

This action produces the following variables after being triggered:

| Variable                 | Description          |
| ------------------------ | -------------------- |
| conversation\_share\_url | The conversation url |

### Availability

Channel specific availability follows the table below:

| Channel          | Availability     |
| ---------------- | ---------------- |
| Facebook         | Fully Available. |
| WhatsApp         | Fully Available. |
| Telegram         | Fully Available. |
| Web              | Fully Available. |
| Alexa            | Fully Available. |
| Google Assistant | Fully Available. |
| Slack            | Fully Available. |
| API              | Fully Available. |

This action can be used only inside interactions. This action requires a [Pro Team](https://docs.xenioo.com/basic-concepts/chatbot-details/chatbot-teams#pro-team-settings) package attached to your starter account.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xenioo.com/actions-and-operations/flow/create-conversation-url-action.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.