콜 플로우 부분 수정
준 필드만 바꿉니다. name·graph 중 최소 하나는 있어야 하고, 둘 다 없으면 400입니다.
graph를 줄 때는 콘솔 빌더가 잡아 둔 캔버스 좌표를 보존합니다 — 공개 계약에 좌표가
없어 API로는 보낼 수 없는데, 그대로 덮으면 콘솔에서 잡아 둔 배치가 매 요청마다 날아가기
때문입니다. (좌표까지 초기화하려면 PUT을 쓰세요.)
graph는 부분 그래프가 아니라 완결된 그래프 하나여야 합니다 — 블럭 하나만 보내는
병합은 지원하지 않습니다.
Authentication
API Key를 Bearer 토큰으로 전달
Path parameters
계정 ID
콜 플로우 ID
Request
name·graph 중 최소 하나
플로우 이름
콜 플로우 그래프 — 요청용. 블럭(nodes)과 시작점(start)으로 통화 흐름 전체를 기술합니다.
⚠️ 요청과 응답의 형태가 다릅니다. 기본값이 있는 필드(menu.maxDigits·menu.timeoutSec,
record.maxLengthSec·playBeep·finishKey, dial.timeoutSec, voice.language,
optout.number·channel)는 요청에서 생략할 수 있고, 응답에는 항상 채워져 돌아옵니다.
캔버스 좌표(ui)는 공개 계약 밖입니다 — 보내도 저장되지 않고, 응답에도 실리지 않습니다.
콘솔 빌더가 잡아 둔 좌표는 PUT이면 버려지고 PATCH면 보존됩니다.
그래프 전체는 256KB를 넘을 수 없습니다.
Response
수정 성공
콜 플로우 ID. createCall의 CallFlowId, 번호 라우팅의 callFlowId에 그대로 사용합니다.
콜 플로우 이름
이 플로우로 인입되는 번호 목록(routingType=callflow). 아웃바운드 전용이면 빈 배열입니다.
발신 시 createCall의 Variables로 넣어야 하는 변수 이름들. 그래프가 {{이름}}으로 참조하지만 통화 중에는 만들어지지 않는 값입니다(누른 키·HTTP 응답·녹음 결과처럼 통화가 만들어내는 변수는 제외). 채우지 않으면 그 자리는 빈 문자열로 나갑니다.
블럭 구성. 저장된 그래프가 현재 스키마로 읽히지 않으면(콘솔이 아닌 경로로 손댄 아주 오래된 플로우) null입니다 — 이름·연결된 번호는 그대로 유효하며, 이 경우 PUT으로 그래프 전체를 다시 올려 고칠 수 있습니다.