Tra cứu API

Gửi tin nhắn

dm_send — Send exactly this text as a DM, into an existing conversation (thread_id from inbox_list_threads) or to a person by @handle, optionally with one image / GIF / video from media_create_upload (X Chat, a

Bản Markdown

dm_send · Ghi lên X (tạo việc)

Mô tả kỹ thuật bằng tiếng Anh — đúng chữ AI agent đọc qua MCP.

Send exactly this text as a DM, into an existing conversation (thread_id from inbox_list_threads) or to a person by @handle, optionally with one image / GIF / video from media_create_upload (X Chat, agent 1.13.0+). Waits when X Chat is locked and its passcode is not saved. Counts against DM (new / reply).


REST	`POST /api/public/v1/accounts/{account}/actions/dm`
Công cụ MCP	`dm_send`
Quyền cần có	`inbox.reply` — Chủ, Quản lý, Vận hành
Nhóm quyền	`inbox:send`
Nhóm	Thao tác trên X
Hiện sẵn trong hồ sơ	Điều khiển nick

Đầu vào

Trường	Kiểu	Bắt buộc	Mô tả
`account`	string (1–100 chars)	Có	The X account to use: its X-Buddy account_id (from account_list) or its @handle. Ambiguous names return candidates instead of guessing.
`thread_id`	string (uuid)	Không	X-Buddy conversation id (inbox_list_threads).
`person`	string (1–60 chars)	Không	Start or continue a conversation with this person.
`text`	string (1–10000 chars)	Có	Message text, sent as is.
`media_ids`	array of string (0–500 chars) (0–1 items)	Không	At most one attachment: a media_id returned by media_create_upload.

Kết quả

Tạo một việc cho VPS của nick. REST chờ tối đa wait giây (mặc định 15, tối đa 20): xong thì trả 200 với kết quả, chưa xong thì trả 202 kèm Location: /api/public/v1/jobs/{job_id}. Kết quả cuối có thể là succeeded, failed, cancelled hoặc unknown.

Cần khoá idempotency (Idempotency-Key, 8–128 ký tự). Gửi lại cùng khoá không bao giờ làm lại việc.

Thao tác này xoá dữ liệu hoặc không hoàn tác được. Hỏi lại người dùng trước khi gọi.

Việc kết thúc unknown có thể đã xảy ra trên X: không gửi lại bằng khoá idempotency mới.

Ví dụ

Gọi qua REST

curl -X POST "https://reach-link-craft.lovable.app/api/public/v1/accounts/%40your_x_account/actions/dm" \
  -H "Authorization: Bearer $XBUDDY_API_KEY" \
  -H "Idempotency-Key: 6f1c2a90-example-key" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello from X-Buddy"}'

Gọi qua MCP

{
  "method": "tools/call",
  "params": {
    "name": "dm_send",
    "arguments": {
      "account": "@your_x_account",
      "text": "Hello from X-Buddy",
      "idempotency_key": "6f1c2a90-example-key"
    }
  }
}

Lỗi có thể gặp

Mã	HTTP	Thử lại được
`unauthorized`	401	Không
`key_expired`	401	Không
`integration_revoked`	401	Không
`connection_not_linked`	403	Không
`integration_paused`	403	Không
`workspace_integrations_paused`	403	Không
`integration_authorization_lost`	403	Không
`workspace_suspended`	403	Không
`forbidden`	403	Không
`invalid_input`	422	Không
`rate_limited`	429	Có
`internal`	500	Có
`read_only`	403	Không
`idempotency_key_required`	428	Không
`idempotency_conflict`	409	Không
`idempotency_processing`	409	Có
`conflict`	409	Không
`precondition_failed`	422	Không
`ambiguous_account`	409	Không
`account_not_allowed`	403	Không
`not_found`	404	Không
`agent_too_old`	422	Không
`unsupported_by_account`	422	Không

Về danh sách thao tác

Gửi tin nhắn

#Đầu vào

#Kết quả

#Ví dụ

#Gọi qua REST

#Gọi qua MCP