Create Link
Create a shareable hosted chat URL for a Web integration.
Type
system.share_agent.createFolder
share-agentChannels
Any
Pipe
Value
Scope
Any
Create Link (canvas label Create Link) creates a hosted Web chat URL for a Web integration. Visitors open /c/:token without embedding the widget.
Use pipe.value.id (the token) with Get Link and Delete Link. Send link in chat or mail.
Require email verification forces Shared conversation on. Everyone who passes the email gate uses the same chat session.
Configure
| Setting | Description |
|---|---|
| Integration | Web chat integration (required) |
| Identifier | Optional label (email, phone, username, and similar) |
| Link Expiry (in days) | Days until the URL expires. 0 means no expiry |
| Shared conversation (Private Link) | When on (default), everyone on this URL shares one chat. When off, each visitor gets their own conversation (same browser can resume until expiry). Hidden when email verification is on |
| Require email verification | Visitors confirm email with a code before chat loads |
| Allowed emails | Shown when email verification is on — optional allowlist (text, comma-separated, or a list variable). Empty allows any verified email |
Handles
| Handle | Role |
|---|---|
| In (target) | Incoming connection |
| Out (source) | Continues after the link is created |
Pipe schema
The next block reads this on the data pipe (pipe.value):
| Key | Type | Description |
|---|---|---|
id | text | Link token (use with Get and Delete) |
link | text | Full hosted URL (/c/:token) |
integration | text | Web integration id |
expiresAt | datetime | Expiry time when set |
identifier | text | Identifier when set |
sharedConversation | boolean | Whether visitors share one session |
Use case
- After qualifying a lead, create a private shared-conversation URL and send it so the same thread continues.
- Create a public per-visitor link (shared conversation off) for an event landing page.