先确认网站和服务
使用有设置管理权限的账号进入「瓜奇 → 登录」，先选中需要接入服务的前端网站。短信在「短信设置」中配置，第三方账号授权在「社交登陆」中配置。
开始前，准备好对应服务的账号、接口凭据，以及实际要使用的签名、模板或授权应用。保存瓜奇设置不会自动完成服务商侧的申请和审核。
配置短信渠道
国内短信可选普通阿里云、阿里云短信认证、腾讯云；国际短信可选阿里云国际短信或腾讯云。两处分别填写，发送时会根据号码选择对应通道。
| 渠道 | 需要填写的主要参数 |
|---|---|
| 普通阿里云 | Access key id、Access key secret、签名名称，以及各业务和语言对应的模板。 |
| 阿里云短信认证 | Access key id、Access key secret、签名名称；控制台要求时填写 SchemeName。验证码有效时间默认 5 分钟，会作为模板参数 min 提交，应与模板一致。 |
| 腾讯云 | SmsSdkAppId、SecretId、SecretKey、短信签名和 Region。地域字段默认 ap-guangzhou，应按实际应用填写。 |
| 阿里云国际短信 | 在国际短信区域填写对应的 Access key id、Access key secret、签名及业务模板配置。 |
普通阿里云国内短信的资质、签名和模板需先在服务商侧准备，具体流程可查看阿里云资质与申请说明。
阿里云短信认证使用短信认证服务自己的签名和模板，只适用于登录、注册、找回密码等验证码场景。需要订单、发货或到期通知时，应选支持普通通知短信的通道；当前国内配置只有一个渠道选择，不会因填写了通知模板就自动切换到另一个服务。
腾讯云发送号码使用 E.164 格式，也就是包含加号和国家码，例如 +86138…。多变量模板必须核对变量顺序。国内和国际都选择腾讯云时，当前发送服务会合并同名网关配置，国际区域的非空参数会覆盖国内同名参数；不要据此配置两套互不兼容的账号凭据。
按业务和语言填写短信模板
每个短信区域都有以下模板字段。当前可选渠道应填写对应服务识别的模板值，不能把后台说明中的示例短信直接当作已审核模板。
- 登录、注册、找回密码：共用验证码模板字段 auth。
- 订单购买成功：使用 order_paid。
- 订单发货：使用 order_shipped。
- 即将到期：使用 expiry_warning。
- 已经到期：使用 expired。
模板按语言填写，发送时读取当前前端语言对应的值。切换界面语言不会替你创建服务商模板，也不会自动补齐空缺的语言配置。
业务通知还需要相应事件确实触发、收件号码有效，并且发送通道支持该类通知。填好模板本身不会立即发送短信。
配置社交登录
- 在「社交登陆」中打开「是否开启社交登录」。
- 在平台列表中添加实际使用的平台，再填写该应用的「客户端 ID」和「客户端密钥」。平台列表只是配置入口，应用是否可用还取决于对应平台的接入条件。
- 在平台后台登记授权回调地址。普通格式为「前端域名/authorize?type=平台标识」，QQ 使用 type=qq，微信使用 type=wechat。
- 核对协议、域名、端口、路径和平台标识，确保回调返回正在配置的前端。
- 设置首次社交注册时的手机、邮箱绑定要求，再保存。
微信登录需要区分场景：微信内网页授权使用「第三方 → 微信设置」中的公众号 App ID 和 App Secret；微信外的扫码登录使用社交登录中微信应用的客户端凭据。只有公众号参数、没有可用扫码应用时，微信外可能显示引导用户到微信打开的提示。
理解强制绑定要求
只开启「是否强制绑定手机」时，新社交账号需要验证手机号；只开启「是否强制绑定邮箱」时，需要验证邮箱。两项都开启时，当前实现允许用户选择手机或邮箱完成一种验证，并不是两种都必须绑定。
补充绑定流程还会要求设置站内密码，因此对应短信或邮件服务必须可用。登录框如果开启了注册邀请码，新用户还会进入邀请码步骤；要求必填时，必须提供有效邀请码。
保存后验证
- 用国内测试号码完成一次验证码发送和验证；启用国际短信时，再用实际支持的国际号码单独测试。
- 切换网站实际启用的语言，确认每种语言都能读取正确模板。
- 从目标前端发起社交授权，检查能否返回网站并完成登录。
- 分别测试已有账号、新账号和需要补充绑定的账号。微信还应分别在微信内和普通浏览器中检查。
短信失败时，按通道、凭据、签名、当前语言模板、变量、额度和发送限制逐项排查。授权返回失败时，核对登记回调与实际地址；不要用后台域名或支付回调代替登录回调。
如果另一个前端无法使用同一账号，检查是否启用了按前端隔离账号。配置保存成功但前台没有更新时，检查目标前端和同步状态，再按需使用「刷新前端」。