Echo/Docs

Adopt an existing Weles profile

Start Echo with a real account you already keep in Weles. Web, CLI, and Desktop validate and call one Echo Web operation.

Choose the surface#

  • Web: open /setup/existing-profile from the main navigation or the empty Products screen.
  • CLI: set ECHO_WEB_BASE_URL and set ECHO_INTERNAL_BEARER to that Echo Web deployment's CRON_SECRET, then run echo-cli seed-profile --account <uuid> --name <product> with optional --description, --niche, and comma-separated --platforms.
  • CLI first use or replay: run echo-cli onboarding --reset with the same seed flags. The journey is not completed until Echo Web returns the persisted product.
  • Desktop: open Start with existing data from the Work section, including from its first screen before a workspace has been selected.

Accepted input#

The setup screens safely discover existing Weles account UUIDs, platforms, display names, and usernames; no credential fields are returned. The source must be an existing account on TikTok, Instagram, LinkedIn, Reddit, Twitter, or Discord. Product input is a non-empty real name, a string or null description, a string or null niche, and a platform array drawn from Echo's supported product platforms.

Echo derives the product UUID from the Weles account UUID and records created_by as existing-profile:<account UUID>. The stored Weles profile remains the source; adoption does not copy credentials or ask for an export archive.

Duplicates, conflicts, and retained state#

The complete request and source are validated before one product insert. An exact repeat returns applied=true with the account and product marked unchanged. If the same source UUID is already tied to different product data, Echo returns a conflict and writes nothing. Unrelated products are preserved.

A successful result reports imported and unchanged entries plus the source account and product identity. A refusal reports conflicting and rejected fields. The product remains in Echo's products table and is available to the ordinary Products screens and bounded product readers.

What the action does not do#

Profile adoption does not run sync_profile, publish content, contact anyone, start outreach, create an advertisement, or call a paid provider. An empty first setup remains usable: omit the seed flags or leave the setup screen without adopting.