外撥任務用一個 Agent 撥打一份聯絡人名單,在撥打時段和併發上限內進行(max_concurrency,最多同時 100 通,且不超過工作區的同時通話上限),沒接通的會重試。
curl https://evasay.com/api/v1/voice/campaigns \
-X POST \
-H "Authorization: Bearer sk-your-key" \
-H "Content-Type: application/json" \
-d '{
"name": "Appointment reminders",
"agent_id": "AGENT_ID",
"phone_number_id": "PHONE_NUMBER_ID",
"timezone": "America/New_York",
"window_start": "09:00",
"window_end": "18:00",
"max_concurrency": 2,
"max_attempts": 2,
"retry_delay_min": 60,
"consent_confirmed": true,
"contacts": [
{ "phone": "+14155550100", "name": "Alex", "appointment": "Tuesday 3 pm" }
]
}'
聯絡人也可以是 CSV 文字,第一欄是電話號碼。必須帶 consent_confirmed: true:表示你確認名單上每個人都同意接聽來電(包括 AI 語音來電),EvaSay 會把這份確認和任務一起保存(consent_confirmed_at)。任務建立時是草稿;用 POST /api/v1/voice/campaigns/{id}/start 開始,pause 和 cancel 用法相同。開始任務前 Agent 必須已發布。