创建单条触达

POST/api/v2/outreach/dispatches

使用已连接账号创建一条 Email、LinkedIn 或 WhatsApp 触达任务。接口返回 HTTP 202 和任务 ID；使用统一任务接口查询最终结果。

Headers

Header	必填	说明
`Authorization`	是	`Bearer sk-revor-...`。
`Content-Type`	是	`application/json`。
`Idempotency-Key`	否	可靠重试标识；同一次业务操作重试时复用原值，避免重复发送。

Request Body

字段	必填	说明
`account_id`	是	从 Connect 账号接口取得。
`channel`	是	`email`、`linkedin` 或 `whatsapp`，必须与账号渠道一致。
`action`	是	固定为 `outreach`。
`recipient`	是	接收方信息。
`content`	是	发送内容。
`metadata`	否	调用方自定义上下文。
`min_channel_task_interval_seconds`	否	同一用户、同一渠道的最小任务间隔；默认值为 60，允许范围为 60-86400 秒。

不同渠道互不占用任务间隔。批量提交时建议在 180 至 360 秒范围内为每个任务生成不同间隔，避免固定节奏连续发送。

各渠道字段

渠道	recipient	content
Email	`address`，可选 `name`	必须有 `subject`，并提供 `text` 或 `html`。
LinkedIn	`profile_url`	提供 `text` 或有效附件。已连接时发送消息，未连接时发送带留言的邀请。
WhatsApp	`phone`	提供 `text` 或有效附件。

附件包含 filename、contentBase64，可选 contentType。

Email 示例

cURL
curl -X POST "https://revor.ai/api/v2/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, ..." }
  }'

响应示例

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "item": {
    "id": "job_uuid",
    "status": "scheduled",
    "action": "outreach.dispatch",
    "channel": "email",
    "scheduled_at": "2026-08-26T10:00:00.000Z"
  }
}

使用 GET /api/v2/jobs/job_uuid 查询结果。创建成功仅表示任务已接受，不表示消息已经发送。

常见错误

HTTP	Code	说明
`400`	`account_id_required` / `invalid_channel` / `invalid_action`	基础参数无效。
`400`	`recipient_address_required` / `recipient_profile_url_required` / `recipient_phone_required`	缺少对应渠道的接收方。
`400`	`content_subject_required` / `content_text_or_html_required` / `content_text_or_attachment_required`	缺少对应渠道的内容。
`400`	`attachment_invalid` / `attachments_invalid`	附件格式无效。
`400`	`min_channel_task_interval_seconds_invalid`	渠道任务间隔不在允许范围内。
`403`	`permission_denied`	Key 没有单条触达创建权限。
`413`	`request_payload_too_large`	请求体超过 12 MB。
`503`	`task_unavailable`	任务暂时无法创建。