배치 발신(캠페인) 생성

발신 번호 (계정에 등록된 번호)

수신자 목록. 건수 제한은 없고 요청 본문 크기(10MB)가 상한이다 — 초과하면 413. 3만건 규모까지 한 번에 넣을 수 있다.

콜 플로우로 발신. AgentId·Url과 배타.

매니지드 에이전트로 발신. CallFlowId·Url과 배타.

VoiceML을 반환할 URL. CallFlowId·AgentId와 배타.

생성 직후 상태. 기본값 running(만들면 바로 발신 대기). paused 로 만들면 명단을 확인한 뒤 actions 의 resume 으로 시작한다.

자동응답기(음성사서함) 감지. 기본값 None(사용 안 함). Enable 은 감지만 해서 결과의 answeredBy 에 human·machine·unknown 을 남기고 통화는 그대로 진행합니다. Hangup 은 자동응답기로 판정되면 통화를 끊습니다. AMD 애드온이 활성화된 계정만 쓸 수 있고(없으면 422), 감지한 통화마다 요금이 붙습니다. 애드온 활성 여부는 발신할 때마다 다시 확인합니다 — 배치를 만든 뒤 애드온을 해지하면 남은 통화는 감지 없이 걸립니다(배치가 실패하지는 않습니다).

발신 차수. 배열 인덱스가 곧 차수이고 Rounds[0] 이 1차 발신, 그 뒤가 재시도입니다. 생략하면 한 번 걸고 끝(발신 가능 시간대 전체)입니다. 최대 5개. 차수마다 시간대를 따로 줄 수 있는 것이 핵심입니다 — “1차는 낮(1018시)에 걸고, 안 받으면 2·3차는 받을 확률이 높은 저녁(1821시)에” 같은 진행을 한 배치로 표현합니다. 재시도도 최초 발신과 똑같이 동시통화 한도·분당 상한·발신 가능 시간대의 적용을 받습니다. 정책상의 시각이 그 차수의 시간대 밖이면 시간대가 열릴 때까지 기다렸다가 걸립니다 — 20시 50분에 실패한 통화의 “30분 뒤”는 21시 20분이지만 그 시각은 발신 금지라 실제로는 다음 열리는 시각에 걸립니다.

끝내 통화가 안 된 분께 보낼 문자. 생략하면 보내지 않습니다. 본문의 {{변수}} 는 그 수신자의 Variables 값으로 치환됩니다(콜 플로우 멘트와 같은 문법). 참조한 변수가 없는 수신자가 한 명이라도 있으면 400 으로 거절합니다 — 빈칸으로 나가는 문자는 되돌릴 수 없기 때문입니다. 문자는 통화가 실패한 직후 나갑니다(차수 시간대를 따로 기다리지 않습니다). 다만 법정 금지 시간(21~08시)에 걸리면 다음 날 아침으로 밀리고, 보낼 시점이 24시간 이상 지나면 보내지 않습니다(일시정지해 둔 배치를 며칠 뒤 재개했을 때 뒤늦은 문자가 나가는 것을 막습니다). ⚠️ 문자 발신번호 등록은 음성 발신 등록과 별개 절차입니다. 등록되지 않은 번호는 발송 요청이 성공해도 통신사에서 거절될 수 있어, 생성 응답의 warnings 로 알려 드립니다.

이 배치가 동시에 유지할 통화 수. 기본값: 1

분당 최대 발신 수. 기본값: 10

발신 시간대 판정 기준. 기본값: Asia/Seoul

이 시각 이후부터 발신 시작

이 시각이 지나면 남은 대상은 발신하지 않고 종료

같은 계정에 배치가 여럿일 때 우선순위(높을수록 먼저). 기본값: 0