cURL
curl --request GET 'https://api.brightalk.ai/bulk-tasks/123e4567-e89b-42d3-a456-426614174000' \
--header "Authorization: Bearer $BRIGHTALK_API_KEY" \
--header "Brightalk-Version: 2026-07-16"const response = await fetch("https://api.brightalk.ai/bulk-tasks/123e4567-e89b-42d3-a456-426614174000", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.BRIGHTALK_API_KEY}`,
"Brightalk-Version": "2026-07-16"
},
});
console.log(response.status, await response.json());import os
import requests
response = requests.request(
"GET",
"https://api.brightalk.ai/bulk-tasks/123e4567-e89b-42d3-a456-426614174000",
headers={
"Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
"Brightalk-Version": "2026-07-16"
},
)
print(response.status_code, response.json()){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "calls",
"recipient_format": "contact_ids",
"status": "uploading",
"total_recipients": 4503599627370495,
"uploaded_recipients": 4503599627370495,
"submitted_recipients": 4503599627370495,
"settled_recipients": 4503599627370495,
"failed_recipients": 4503599627370495,
"unknown_recipients": 4503599627370495,
"total_parts": 4503599627370495,
"submitted_parts": 4503599627370495,
"failed_parts": 4503599627370495,
"error_code": "<string>",
"upload_chunk_size": 500,
"created_at": "<string>"
}批次撥號
查詢大型任務進度
透過 SQL 彙總上傳、提交與執行進度。completed 表示所有收件人已有確定結果,包含失敗,不代表簡訊全部送達。簡訊送達狀態不明仍屬未結案。failed 表示至少一個準備分段失敗;其餘已提交或等待中的分段仍可能繼續執行。
GET
/
bulk-tasks
/
{task_id}
cURL
curl --request GET 'https://api.brightalk.ai/bulk-tasks/123e4567-e89b-42d3-a456-426614174000' \
--header "Authorization: Bearer $BRIGHTALK_API_KEY" \
--header "Brightalk-Version: 2026-07-16"const response = await fetch("https://api.brightalk.ai/bulk-tasks/123e4567-e89b-42d3-a456-426614174000", {
method: "GET",
headers: {
"Authorization": `Bearer ${process.env.BRIGHTALK_API_KEY}`,
"Brightalk-Version": "2026-07-16"
},
});
console.log(response.status, await response.json());import os
import requests
response = requests.request(
"GET",
"https://api.brightalk.ai/bulk-tasks/123e4567-e89b-42d3-a456-426614174000",
headers={
"Authorization": f"Bearer {os.environ['BRIGHTALK_API_KEY']}",
"Brightalk-Version": "2026-07-16"
},
)
print(response.status_code, response.json()){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "calls",
"recipient_format": "contact_ids",
"status": "uploading",
"total_recipients": 4503599627370495,
"uploaded_recipients": 4503599627370495,
"submitted_recipients": 4503599627370495,
"settled_recipients": 4503599627370495,
"failed_recipients": 4503599627370495,
"unknown_recipients": 4503599627370495,
"total_parts": 4503599627370495,
"submitted_parts": 4503599627370495,
"failed_parts": 4503599627370495,
"error_code": "<string>",
"upload_chunk_size": 500,
"created_at": "<string>"
}標頭
回應
已傳回任務狀態。已提交不代表已送達或執行完成。