Returns the deployment artifacts for a perspective: the share_url and direct_url for outreach plus ready-to-paste embed snippets (fullpage, widget, popup, slider, float, card) and an SDK reference (script URL, events, URL/brand/theme params, JS API methods, callbacks).
Behavior:
- Read-only.
- Errors when the perspective is not found or you do not have access.
- URLs are stable per perspective. Conversations started from these embeds count toward the workspace's quota (preview conversations do not — see perspective_get_preview_link).
- Use the snippet returned for that specific perspective rather than hand-rolling URLs.
- share_url / direct_url accept these URL params: name, email, returnUrl, plus arbitrary tracking keys (source, campaign, etc.).
When to use this tool:
- Deploying a perspective to a real site, email, or app surface.
- Generating SDK integration code (Next.js layout, raw HTML, popup trigger button, etc.).
- Looking up event names or URL parameters the embed accepts.
When NOT to use this tool:
- Internal smoke testing — use perspective_get_preview_link (preview conversations don't count toward quota).
- Inspecting outline / setup — use perspective_get.
Typical flow:
1. perspective_create → design
2. perspective_get_preview_link → test
3. perspective_update → refine
4. perspective_get_embed_options → deploy
5. automation_create → (form / lead-capture contexts) wire conversation data to a CRM or backend
For coding assistants: after returning embed options, help the user wire the snippet into their app:
- Popup / Slider / Float: add the script before `</body>` in HTML, or in `_app.tsx` / `layout.tsx` for React/Next.js.
- Widget: place the div where the widget should appear.
- Fullpage: use in a dedicated page or iframe container.
- Card: use as a preview link in landing pages or emails.
For form / lead-capture contexts: after deployment, ask whether they want to set up an automation (automation_create) to forward each completed conversation to their CRM, database, or notification channel.
Examples:
- Optional URL params on the share link: `email` (pre-fills participant email), `returnUrl` (redirect after the conversation completes), and arbitrary `key=value` pairs for tracking (e.g. `source=email`, `campaign=q4-launch`, `user_id=...`). Embed snippets accept additional appearance params (brand colors, theme) — see the `sdk.parameters` section in the response.
- Each perspective has unique URLs — always use the URL returned for that specific perspective.
