ClawOps Docs

음성사서함 감지 (AMD)

발신 통화에서 사람/음성사서함을 감지하고 AnsweredBy 로 결과를 받습니다.

개요

AMD(Answering Machine Detection)는 발신 통화에서 상대방의 응답이 사람인지 음성사서함/자동응답기인지 감지합니다. 결과는 AnsweredBy(human / machine / unknown)로 전달됩니다.

활성화

AMD는 가입 시 기본 활성화되어 있으며, 콘솔의 부가서비스(/addons) 에서 켜고 끌 수 있습니다. 한 번 끄면 결제 갱신 후에도 꺼진 상태가 유지됩니다.

AMD가 꺼진 상태에서 MachineDetection 을 보내면 통화 생성이 HTTP 422 (amd_addon_disabled) 로 거절됩니다. 먼저 부가서비스에서 활성화하세요.

사용

발신 통화 생성 시 MachineDetection 옵션을 지정합니다.

  • Enable — 감지 후 AnsweredBy 를 통보하고 통화는 계속됩니다.
  • Hangup — 음성사서함으로 판정되면 통화를 자동 종료합니다.

REST

curl -X POST https://api.claw-ops.com/v1/accounts/$ACCOUNT_ID/calls \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "To": "01012345678",
    "From": "07011112222",
    "MachineDetection": "Enable"
  }'

Python SDK

client.calls.create(
    to="01012345678",
    from_="07011112222",
    machine_detection="Enable",
)

결과 수신

AnsweredBy 는 통화 응답 본문과 status webhookcompleted 이벤트에 포함됩니다 (MachineDetection 을 켠 발신 통화에 한해).

AnsweredBy의미
human사람이 응답
machine음성사서함/자동응답기
unknown판정 불가

과금

건당 3원. 실제 감지가 수행된 발신 통화(amd_status 기록분)만 과금되며, 미응답/실패 통화는 감지가 시작되지 않아 과금되지 않습니다.