docs(agents): bring your own number, import via SIP trunk

[Him188]

Summary

Customer-facing guide for BYO SIP number import: new agents/telephony/byo-sip page (how it works, the SIP origination endpoint, import via console and API with the full field table, inbound authentication choices, Twilio Elastic SIP Trunking and Asterisk walkthroughs, outbound/transfer capability matrix, in-place sip-config editing, zero-telephony-fee billing, release semantics), navigation entry, and cross-references from the phone numbers and transfers pages.

All API examples mirror requests exercised against the implementation (local real-stack E2E plus the platform-api test suite).

Draft until the feature ships: merge together with the platform-api / fish-agent / platform-web BYO SIP PRs (linked in comments). The API reference pages pick up the new endpoint automatically once update:openapi pulls the deployed spec.

🤖 Generated with Claude Code

---

^{Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
hanabiaiinc	🟢 Ready	View Preview	Aug 18, 2026, 5:28 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: abbc9722-e7cf-4843-8329-f536ca77027d

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[Him188]

BYO SIP PR set:

• platform-api: https://github.com/fishaudio/platform-api/pull/1431
• fish-agent: https://github.com/fishaudio/fish-agent/pull/54
• platform-web: https://github.com/fishaudio/platform-web/pull/2431
• docs (draft until launch): docs(agents): bring your own number, import via SIP trunk #147

Deploy order: fish-agent -> platform-api -> platform-web; docs merge at launch.