设置 CoreCall
连接 Twilio 或 Telnyx 账户，了解 CoreCall 为您配置了什么，拨打第一通电话，并在遇到限制前了解它们。
设置 CoreCall
CoreCall 需要至少一个提供商的凭据。单独使用 Twilio 或 Telnyx 均可；同时连接两者则可以在每次通话时选择使用哪个号码。
连接 Twilio
您需要您的 Account SID 以及您的 Auth Token 或一个已有的 API Key SID 和 Secret。这些都可以在 Twilio Console 中找到。
当您连接时，CoreCall 会在您的 Twilio 账户内执行三项操作：
- 验证 Account SID。
- 为该应用创建一个专用的 API Key，这样您的 Auth Token 就不会成为长期存储在您设备上的凭据。
- 部署一个微型的 Twilio Serverless Function，该函数返回 TwiML 指令，指示 Twilio 拨打您的目的地。
这个函数是实现出站呼叫的关键。它存在于您的账户中，由您付费，您可以随时在 Twilio Console 中检查或删除它。
然后，语音访问令牌会在设备上生成并本地签名。拨打电话不涉及向我们或我们的服务器发送任何请求。
连接 Telnyx
您需要一个 Telnyx API key。CoreCall 会以幂等方式创建：
- 一个出站语音配置文件
- 一个凭据连接
- 一个电话凭据
然后为 WebRTC 客户端的每次通话生成一个短期有效的 JWT。重新连接不会创建重复项。
在 macOS 上，Telnyx 是唯一的语音通话路径。原因请参阅安装。
稍后添加或移除提供商
您不会被锁定在初始设置时所做的选择。
添加第二个提供商。 “设置”会为您尚未配置的提供商显示“添加 Twilio 账户”或“添加 Telnyx 账户”的选项。连接它会运行与上述相同的配置步骤，之后拨号器和短信编辑器将允许您为每次通话或每条消息选择通过哪个提供商。
移除一个提供商。 如果另一个提供商仍然连接，应用将继续工作——您只是会丢失属于被移除提供商的号码和历史记录。
移除最后一个提供商会使您登出并返回到初始设置流程。这是有意为之，而非故障：CoreCall 没有自己的账户，也没有备用服务，因此在没有提供商凭据的情况下它什么也做不了。您的通话和消息历史记录存在于您的提供商账户中，而不是这里，所以登出不会销毁它——重新连接同一账户即可恢复。
选择主叫号码
连接后，CoreCall 会列出您账户上可用的号码。选择一个作为主叫号码（caller ID）。在 Mac 上，Twilio 号码在语音选择器中是隐藏的，因为它们不能用于在该设备上拨打电话。
拨打电话
以 E.164 格式输入目的地号码——国家代码，无空格，无破折号：+14155550123，而不是 (415) 555-0123。
在 iOS 和 macOS 上，通话通过 CallKit 处理，因此它会出现在系统通话界面中，并像普通通话一样工作，包括音频路由和“最近通话”列表。在 Android 上，一个“通话中”通知会使通话在后台保持活动状态。
CoreCall 不接收来电。它不会注册推送通知，当有人回拨您的号码时也不会响铃。来电处理方式保留在您的提供商配置中，与您安装此应用前完全一样。
发送短信
短信通过您的提供商的消息 API 从相同的号码发送。消息历史记录按号码显示。
需要注意一个不对称之处：Telnyx 消息历史记录是尽力而为的。 Telnyx 没有廉价的 API 端点来列出所有消息，因此 CoreCall 会显示 Twilio 号码的完整历史记录，并附加上它自己发送的 Telnyx 消息。从其他地方发送的较早的 Telnyx 消息将不会出现。
可选：AI 通话模式
如果您在设置中配置了 AI 服务器 URL 和访问密钥，拨号器将在 off 之外增加两种额外模式：
- 字幕 — 通话的实时翻译字幕，在通话过程中显示。
- 口译 — 一个服务器端口译员被桥接到通话双方，这样每一方都能听到用自己语言翻译的对方讲话。
这些功能需要：
- 一个 Twilio 主叫号码。这些模式基于 Twilio 媒体流构建，当选择 Telnyx 号码时会被隐藏。
- 口译模式需要一个 E.164 格式的目的地号码。使用非数字标识符将导致明确的错误，而不是静默回退。
- Mac 以外的平台，因为这些功能在 Mac 上不可用。
您需要向服务器提供您自己的 OpenAI 密钥（以及可选的用于词级字幕的 Deepgram 密钥）；服务器会持有这些密钥，因此密钥永远不会嵌入到应用中。
这些模式是完全可选的。CoreCall 的核心功能——通过您自己的提供商账户拨打电话和发送消息——在完全不配置 AI 服务器的情况下也能工作，这也是大多数人应该开始使用的配置。
演示模式
演示模式会播放一个预设脚本的通话，无需网络访问，也没有真实音频。它的存在是为了让您在不连接账户的情况下也能看到界面。演示模式中的任何操作都不会接触到提供商，也不会产生费用。
在遇到之前值得了解的限制
- 不接收入站呼叫。
- Twilio 语音和所有 AI 模式在 macOS 上不可用。 Telnyx 语音和 Twilio 短信在该平台上均可使用。
- AI 模式仅限 Twilio，在所有平台上都是如此。
- Telnyx 短信历史记录不完整是设计使然。
- 账单由您承担。 每次通话和每条消息都由您的提供商按您的费率计费。CoreCall 不会增加任何费用，也看不到任何账单信息。
问题排查
“Twilio 语音通话在 Mac 上不可用。” 这是设计如此。请选择一个 Telnyx 主叫号码，或使用 Android 版本。
连接 Twilio 后通话立即失败。 可能是 serverless function 尚未完成部署。请等待几秒钟后重试；如果问题仍然存在，请检查您的 Twilio Console 中的 Functions 部分，确认它已存在。
AI 模式选择器缺失。 原因可能为：未配置 AI 服务器、所选的主叫号码是 Telnyx 号码，或者您正在使用 Mac。
号码看起来没问题但无法拨出。 请检查号码是否为 E.164 格式。必须包含前导 + 和国家代码。