Skip to content

Tutorial: Your first embedded integration widget#2

Open
ekline[bot] wants to merge 2 commits into
mainfrom
ekline/98b8877d-31f2-4b19-8454-b35de38f436d
Open

Tutorial: Your first embedded integration widget#2
ekline[bot] wants to merge 2 commits into
mainfrom
ekline/98b8877d-31f2-4b19-8454-b35de38f436d

Conversation

@ekline

@ekline ekline Bot commented Mar 3, 2026

Copy link
Copy Markdown
Contributor

Lets research and build this quckstart

Your first embedded integration widget
Tutorial
Walk throu

Changes

Status File
🆕 Created customer-facing-integrations/embedded-integrations/getting-started-with-fastns-embedded-experience/your-first-embedded-integration-widget.md
✏️ Modified SUMMARY.md

📝 Created with EkLine · View session

@usmanaslam712

Copy link
Copy Markdown
Collaborator

There are several steps that dont match the platform fully, going through this step by step:

Step 1 - "With a connector" label doesn't exist, use correct terms

The tutorial says: Select With a connector.
The actual dialog shows two options: "Publish Connector" and "Without Connector". The label "With a connector" does not appear anywhere on the platform.
image

Step 7 - Embed code is incorrect and uses incorrect domains and missing event listeners which are are follows

  • Wrong domain — app.fastn.ai/connect vs live.fastn.ai/widget
  • Wrong embed method — static iframe src vs JavaScript dynamic creation
  • Missing parameters — no customAuth, origin, path, authToken, theme
  • Missing event listeners — the actual widget needs postMessage communication for height updates, auth tokens, and action events. Without these, the widget won't resize properly and actions won't complete.
  • Missing env parameter — the tutorial uses env=LIVE in the URL but the actual code doesn't pass env that way

Step 4 - Incorrect level to show connector status for widget

Tutorial says status changes to "Deployed". The Widgets page shows "Active" (green dot) for all deployed widgets.
image

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant