NN Agent
概览

如何通过API连接消息应用账户

通过API将账户连接到NN Agent的过程是通过授权会话进行的：您打开会话，消息应用将代码发送到号码，您将代码返回到会话中。如果启用了双因素保护，则会增加一步——云密码。

在开始之前，请获取bearer令牌，参见 授权。

1
打开授权会话
curl -X POST https://api.nexifyneo.com/v2/accounts/auth-sessions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d 'YOUR_JSON_BODY'

响应中将返回UUID格式的会话标识符。所有后续步骤都使用此标识符，而不是账户标识符：账户尚不存在。

使用QR码登录的替代方法是使用消息中的代码—— POST /v2/accounts/auth-sessions/qr。

2
等待消息应用发送代码

轮询会话状态，直到它进入等待代码状态：

curl https://api.nexifyneo.com/v2/accounts/auth-sessions/AUTH_ID \
  -H "Authorization: Bearer YOUR_API_TOKEN"

如果代码未发送，请请求重新发送： POST /v2/accounts/auth-sessions/{auth_id}/resend-code。

3
传递确认代码
curl -X POST https://api.nexifyneo.com/v2/accounts/auth-sessions/AUTH_ID/code \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d 'YOUR_JSON_BODY'

之后再次检查会话状态：它要么成功结束，要么请求云密码。

4
如果启用了双因素保护，请传递云密码
curl -X POST https://api.nexifyneo.com/v2/accounts/auth-sessions/AUTH_ID/password \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d 'YOUR_JSON_BODY'

此步骤仅适用于启用了双因素保护的账户。没有它，会话在代码之后立即结束。

5
确保账户已出现
curl https://api.nexifyneo.com/v2/accounts \
  -H "Authorization: Bearer YOUR_API_TOKEN"

新账户在列表中以其UUID出现。此UUID随后用于 对话 和与活动的绑定。

如果出现问题#

  • 未完成的会话可以中断： DELETE /v2/accounts/auth-sessions/{auth_id}.
  • 响应 401 表示令牌问题，而不是账户问题 — 请参见 认证。
  • TLS证书验证失败与令牌或会话无关： api.nexifyneo.com 返回自签名证书，请参见 已知限制。

哪些账户需要连接#

对于外发，请连接单独的账户，而不是个人账户。封锁的决定由平台做出，失去一个账户时，通信和联系人将保留在 NN Agent 中——您可以从另一个账户继续。详细信息请参见常见问题。

继续#

Updated

由...提供支持 Docsbook
如何通过API连接消息应用账户 — NN Agent