Migrate from ElevenLabs

1. Inventory the source. Export conversational agents, prompts, first messages, voices, LLM settings, tools, knowledge, numbers, secrets, traffic, and test cases. Record the source version and content owners.
2. Choose import mode. Use authorized api_key discovery or a permitted paste payload. Keep the source credential in the protected API flow and out of prompts, JSON files, output, and logs.
3. Create the job at POST /v1/agent-imports with source: elevenlabs.

{
  "source": "elevenlabs",
  "auth_mode": "paste",
  "payload": "${EXPORTED_AGENT_JSON}"
}

curl --fail-with-body -X POST https://api.thunderphone.com/v1/agent-imports \
  -H "Authorization: Bearer $THUNDERPHONE_API_KEY" -H "Content-Type: application/json" \
  -H "X-ThunderPhone-Client: skills/migrate-from-elevenlabs@1.0" --data-binary @elevenlabs-import.json

import json, os, requests
with open("elevenlabs-import.json", encoding="utf-8") as f: payload = json.load(f)
r = requests.post("https://api.thunderphone.com/v1/agent-imports", json=payload,
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}",
             "X-ThunderPhone-Client": "skills/migrate-from-elevenlabs@1.0"}, timeout=60)
r.raise_for_status(); print(r.json())

import { readFile } from "node:fs/promises";
const r = await fetch("https://api.thunderphone.com/v1/agent-imports", { method: "POST",
  headers: { Authorization: `Bearer ${process.env.THUNDERPHONE_API_KEY}`,
    "Content-Type": "application/json",
    "X-ThunderPhone-Client": "skills/migrate-from-elevenlabs@1.0" },
  body: await readFile("elevenlabs-import.json", "utf8") });
if (!r.ok) throw new Error(await r.text()); console.log(await r.json());

4. Poll and review items. Fetch GET /v1/agent-imports/{public_id} until ready; use PATCH /v1/agent-imports/{public_id}/items/{item_id} to select and correct each candidate.
5. Review mapping. Prompt, first message, language, LLM choice, voice, webhook tools, supported system tools, knowledge, silence, and maximum duration can map. Numbers, secret values, client-side tools, MCP servers, and unsupported vendor capabilities need manual work. See references/elevenlabs-mapping.md.
6. Commit only reviewed items with POST /v1/agent-imports/{public_id}/commit; poll to terminal and record each created ID. Discard an uncommitted job with DELETE /v1/agent-imports/{public_id}.
7. Run side-by-side tests. Use identical scenarios for source and ThunderPhone. Compare tool and knowledge evidence, transfer/end behavior, language, pronunciation, interruption, audio, and latency. Create a separate approved plan for numbers, traffic, and source retirement.
8. Read current comparison data from https://thunderphone.com/data/voice-ai-price-index.json; do not publish invented or stale rates.

Errors

Source and safety rules

• Use import agents and the agent-import API.
• Never expose source secrets or assume a source voice exists in ThunderPhone.
• Keep source agents and traffic intact until matched tests and rollback are complete.
• Separate transcript similarity from audio, latency, connection, and tool evidence.