创建触达任务

POST/api/v1/outreach/dispatches

创建一条 email、LinkedIn 或 WhatsApp 触达任务。成功响应返回 HTTP 202 Accepted 和任务 ID。

Headers

Request Body

触达间隔

min_channel_task_interval_seconds 只作用于同一 Revor 账号下的同一渠道任务。Email、LinkedIn 与 WhatsApp 分属不同渠道，不会彼此占用该间隔。

批量创建触达任务时，集成方应为每个任务生成随机间隔。常见建议值为 180 到 360 秒，避免所有任务使用固定节奏。

recipient 字段

content 字段

附件对象：

Email 请求示例

cURL复制
curl -X POST "https://revor.ai/api/v1/outreach/dispatches" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "connect_account_xxx",
    "channel": "email",
    "action": "outreach",
    "recipient": {
      "address": "[email protected]",
      "name": "Alex"
    },
    "content": {
      "subject": "Quick introduction",
      "text": "Hi Alex, this is a quick API test from Revor AI."
    },
    "min_channel_task_interval_seconds": 60
  }'

LinkedIn 请求示例

cURL复制
curl -X POST "https://revor.ai/api/v1/outreach/dispatches" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "connect_account_xxx",
    "channel": "linkedin",
    "action": "outreach",
    "recipient": {
      "profile_url": "https://www.linkedin.com/in/test-user/"
    },
    "content": {
      "text": "Hi Alex, saw your recent work on outbound automation and wanted to connect."
    },
    "min_channel_task_interval_seconds": 60
  }'

WhatsApp 请求示例

cURL复制
curl -X POST "https://revor.ai/api/v1/outreach/dispatches" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "connect_account_xxx",
    "channel": "whatsapp",
    "action": "outreach",
    "recipient": {
      "phone": "+14155552671"
    },
    "content": {
      "text": "Hi Alex, this is a quick WhatsApp message from Revor AI."
    },
    "min_channel_task_interval_seconds": 60
  }'

响应示例

JSON复制
{
  "ok": true,
  "request_id": "req_xxx",
  "item": {
    "id": "job_uuid",
    "status": "queued",
    "action": "outreach.dispatch",
    "channel": "email",
    "scheduled_at": "2026-05-20T10:00:00.000Z"
  }
}

响应字段

查询结果

创建成功不表示消息已经发送。调用方应使用返回的 item.id 查询任务结果：

cURL复制
curl -X GET "https://revor.ai/api/v1/outreach/jobs/job_uuid" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

错误