RevorRevor

查询 Connect 账号

GET/api/v2/connect/accounts

返回当前用户已连接的 Email、LinkedIn 和 WhatsApp 账号。创建触达任务前,先通过本接口取得可用的 account_id。

Query 参数

字段必填说明
channel否email、linkedin 或 whatsapp。
can_send否true、false、1 或 0。

请求示例

cURL
curl "https://revor.ai/api/v2/connect/accounts?channel=linkedin&can_send=true" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

响应示例

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "items": [
    {
      "account_id": "connect_account_xxx",
      "channel": "linkedin",
      "name": "LinkedIn Account",
      "account_identifier": "https://www.linkedin.com/in/example/",
      "status": "ok",
      "lifecycle_status": "active",
      "can_send": true,
      "can_receive": true
    }
  ]
}

status 表示当前连接或凭证是否健康,lifecycle_status 表示账号在 Revor 中的生命周期。调用方不应自行组合这两个内部状态来判断能否发送;发起外联时始终以 can_send=true 为准。

常见情况下,status=credentials 表示账号需要更新凭证或重新连接,status=error 表示账号暂不可用。即使账号仍处于 lifecycle_status=active,只要 can_send=false,也不应提交发送任务。

常见错误

HTTPCode说明
400invalid_channel渠道值不支持。
400invalid_can_sendcan_send 值不支持。
403permission_deniedKey 没有 Connect 账号读取权限。