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
Snippet placement, by embed type:
- Popup / Slider / Float: the script goes before `</body>` in HTML, or in `_app.tsx` / `layout.tsx` for React/Next.js.
- Widget: the div marks where the widget renders.
- Fullpage: a dedicated page or iframe container.
- Card: a preview link for landing pages or emails.
For form / lead-capture perspectives, automation_create can forward each completed conversation to a 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.