Menu tài liệu

API hỗ trợ

Liên hệ hỗ trợ Litport từ một script hoặc một AI agent: bắt đầu cuộc trò chuyện, thêm tin nhắn và đọc phản hồi bằng cách polling.

Widget chat trên litport.net/support yêu cầu người dùng giải CAPTCHA, nên script hoặc agent hãy dùng API này hoặc email.

URL gốc:

https://litport.net/api/v1/support

Các lệnh gọi#

Lệnh gọi Chức năng Xác thực
POST /conversations Bắt đầu cuộc trò chuyện với tin nhắn đầu tiên. Không, hoặc API key của tài khoản
POST /conversations/{conversationId}/messages Thêm tin nhắn vào cuộc trò chuyện. Access token hoặc API key của tài khoản
GET /conversations/{conversationId} Đọc tin nhắn và trạng thái của cuộc trò chuyện. Access token hoặc API key của tài khoản

Gửi JSON với Content-Type: application/json. Phản hồi là JSON.

Hai cách gọi#

Không có tài khoản (khách). Gửi email và message mà không có header Authorization. Phản hồi mang một accessToken bắt đầu bằng lsc_. Hãy gửi nó dưới dạng Authorization: Bearer lsc_… ở hai lệnh gọi còn lại. Token chỉ hiện một lần, trong phản hồi đó, nên hãy giữ lại. Nó chỉ mở được cuộc trò chuyện mà nó được cấp cho. Cuộc trò chuyện khách có thể trả lời các câu hỏi chung: vị trí, giá, thiết lập.

Có API key của tài khoản. Gửi Authorization: Bearer lit_… (tạo key trong Cài đặt; xem API Litport). Các lệnh gọi khi đó đi vào cuộc trò chuyện của tài khoản bạn, nên hỗ trợ có thể nói về đơn hàng và proxy của bạn. Một tài khoản có một cuộc trò chuyện: POST /conversations lần thứ hai thêm tin nhắn vào chính cuộc trò chuyện đó, và email bị bỏ qua.

Access token và API key dùng cùng header Authorization: Bearer …. Không đặt cái nào vào URL.

Bắt đầu cuộc trò chuyện#

curl -sS 'https://litport.net/api/v1/support/conversations' \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","message":"Which countries do you cover with mobile proxies?","name":"Research agent"}'
Trường Bắt buộc Ý nghĩa
message có Nội dung cần gửi, tối đa 4,000 ký tự.
email khi không có API key Nơi chúng tôi có thể liên hệ bạn. Bị bỏ qua khi bạn gửi API key.
name không Tên hiển thị của cuộc trò chuyện, tối đa 100 ký tự.

Phản hồi, 201:

{
  "conversationId": "4f0c2a7e9b1d4c5a8e3f6a1b2c3d4e5f",
  "accessToken": "lsc_example_token_returned_once",
  "identity": "guest",
  "howToUpgrade": "This is a guest conversation, so we can only answer general questions here. For help with your orders or proxies, call this API with your account API key (Authorization: Bearer <key>), or email [email protected] from your account address.",
  "message": {
    "seq": 1,
    "at": "2026-10-16T17:05:00.000Z",
    "author": "you",
    "text": "Which countries do you cover with mobile proxies?",
    "files": []
  }
}

identity là guest hoặc account. Với khách, howToUpgrade cho biết cách nhận trợ giúp về đơn hàng và proxy. Với API key, accessToken và howToUpgrade là null và identity là account; hãy tiếp tục gửi API key.

Thêm tin nhắn#

export LITPORT_SUPPORT_TOKEN='lsc_the_token_from_the_first_response'
curl -sS "https://litport.net/api/v1/support/conversations/$CONVERSATION_ID/messages" \
  -H "Authorization: Bearer $LITPORT_SUPPORT_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"message":"Thanks. Do you have mobile proxies in Texas?"}'

Phản hồi, 201:

{
  "message": {
    "seq": 2,
    "at": "2026-10-16T17:06:12.000Z",
    "author": "you",
    "text": "Thanks. Do you have mobile proxies in Texas?",
    "files": []
  }
}

Đọc cuộc trò chuyện#

curl -sS "https://litport.net/api/v1/support/conversations/$CONVERSATION_ID?after=2" \
  -H "Authorization: Bearer $LITPORT_SUPPORT_TOKEN"

after là seq cao nhất mà bạn đã có. Bỏ qua để đọc từ đầu.

{
  "conversationId": "4f0c2a7e9b1d4c5a8e3f6a1b2c3d4e5f",
  "identity": "guest",
  "howToUpgrade": "This is a guest conversation, so we can only answer general questions here. For help with your orders or proxies, call this API with your account API key (Authorization: Bearer <key>), or email [email protected] from your account address.",
  "lastSeq": 3,
  "waitingOn": "customer",
  "messages": [
    {
      "seq": 3,
      "at": "2026-10-16T17:09:40.000Z",
      "author": "mike",
      "text": "Thanks, I'm checking this now and will reply here.",
      "files": []
    }
  ],
  "more": false,
  "pollAfterSeconds": 30
}
Trường Ý nghĩa
lastSeq Số thứ tự tin nhắn mới nhất mà bạn thấy được.
waitingOn Cuộc trò chuyện đang chờ ai: us (Litport), customer (bạn) hoặc none.
messages Các tin nhắn có seq lớn hơn after, cũ nhất trước. Mỗi tin có seq, at (UTC theo ISO-8601), author, text và files.
more true khi còn tin nhắn tiếp theo. Gọi lại với after đặt bằng seq cuối cùng bạn nhận được.
pollAfterSeconds Thời gian chờ trước lần đọc tiếp theo.

author là you cho tin nhắn của bạn, mike cho phản hồi từ hỗ trợ và system cho các thông báo ngắn. Nội dung phản hồi mike có thể đánh dấu vài cụm từ ngắn in đậm bằng cặp dấu sao đôi của Markdown (**like this**); không có phần nào khác của văn bản là Markdown. files chỉ liệt kê name và kind. API không có tệp đính kèm và không có liên kết tải xuống.

Phản hồi không đến ngay lập tức và không được đẩy tới bạn. Hãy đọc lại cuộc trò chuyện mỗi 30 giây cho đến khi có tin nhắn mike. Một lần đọc được tính là đã đọc mọi tin nhắn mà nó trả về. Mọi phản hồi trong cuộc trò chuyện khách cũng được gửi email ngay tới địa chỉ bạn đã cung cấp, và trả lời email đó sẽ tiếp tục cuộc trò chuyện. Trong cuộc trò chuyện của tài khoản, phản hồi chưa được đọc sau hai phút sẽ được gửi email tới địa chỉ của tài khoản.

Giới hạn#

Giới hạn Giá trị
Cuộc trò chuyện mới khi không có API key 3 mỗi giờ và 10 mỗi ngày, trên mỗi địa chỉ IP; còn áp dụng giới hạn hằng ngày chung cho mọi bên gọi
Độ dài tin nhắn 4,000 ký tự
Tin nhắn mỗi cuộc trò chuyện 30 mỗi 24 giờ
Đọc (GET) 20 mỗi phút trên mỗi access token hoặc API key, 60 mỗi phút trên mỗi địa chỉ IP
Nội dung yêu cầu 32 KiB
Tệp đính kèm Không có qua API

Vượt giới hạn trả 429 RATE_LIMITED. Lần đọc vượt giới hạn còn gửi kèm Retry-After. Hãy chờ đúng khoảng đó trước lệnh gọi tiếp theo.

Lỗi#

Lỗi dùng cùng cấu trúc với phần còn lại của API:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Conversation not found.",
    "requestId": "req_example",
    "docsUrl": "https://litport.net/docs/api/support",
    "retryable": false
  }
}

retryable là true khi chính yêu cầu đó, gửi lại sau Retry-After, có thể thành công và an toàn để gửi. Bắt đầu cuộc trò chuyện và thêm tin nhắn không có khóa idempotency, nên 503 trên chúng có retryable: false: tin nhắn có thể đã được lưu. Hãy đọc cuộc trò chuyện trước khi gửi lại.

Trạng thái Mã Việc client cần làm
400 INVALID_REQUEST, MESSAGE_TOO_LONG Sửa yêu cầu. Một trường sai kiểu, thiếu trường bắt buộc hoặc trường không hợp lệ, hoặc tin nhắn dài hơn 4,000 ký tự. Không thử lại yêu cầu đó khi chưa đổi gì.
401 UNAUTHORIZED Gửi access token hoặc API key hợp lệ dưới dạng Authorization: Bearer ….
404 NOT_FOUND Cuộc trò chuyện không tồn tại, hoặc thông tin xác thực của bạn không mở được nó.
429 RATE_LIMITED Chờ, rồi thử lại. Tuân theo Retry-After khi có.

Header X-Request-ID mang cùng ID với requestId; hãy kèm nó khi báo sự cố.

Công cụ MCP#

Máy chủ MCP của Litport có ba công cụ hỗ trợ:

Công cụ Chức năng
contact_support Bắt đầu cuộc trò chuyện. Nhận message, và email khi không có API key.
get_support_replies Đọc cuộc trò chuyện. Nhận conversationId và after tùy chọn.
reply_to_support Thêm tin nhắn. Nhận message và conversationId tùy chọn.

Khi không có LITPORT_API_KEY, chúng chạy như một cuộc trò chuyện khách, và máy chủ giữ access token trong bộ nhớ suốt phiên. Với LITPORT_API_KEY, chúng dùng cuộc trò chuyện của tài khoản bạn.

Email#

Bạn cũng có thể viết tới [email protected]. Để được giúp về đơn hàng hoặc proxy, hãy viết từ địa chỉ trên tài khoản Litport của bạn.