API Reference
수신거부 등록
번호를 수신거부 명단에 등록합니다. 대상은 이 계정의 발신(전화·문자)이고, 착신은 대상이 아닙니다 — 그 번호에서 걸려오는 전화는 그대로 받습니다.
등록 즉시 발신이 막힙니다. 이 계정에서 그 번호로 통화를 걸거나 문자를 보내면 발신 직전에
422 recipient_blocked 로 거절되고, 배치 발신(캠페인)도 같은 관문을 지나므로 해당 대상은 자동으로
건너뜁니다. 이미 진행 중인 통화는 끊지 않습니다 — 막는 것은 새 발신입니다.
멱등입니다. 이미 차단 중인 (번호, 채널) 조합을 다시 등록하면 에러 없이 기존 항목을 200 으로 돌려줍니다.
새로 등록된 경우에만 201 입니다. 같은 사람이 수신거부를 두 번 요청하는 것은 정상 상황이기 때문입니다.
전화와 문자를 모두 차단하려면 channel 을 바꿔 두 번 호출합니다.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/blocked-recipients" \ -H "Content-Type: application/json" \ -d '{ "number": "010-1234-5678", "channel": "call" }'{
"id": "clx9blk00001",
"number": "01012345678",
"channel": "call",
"active": true,
"source": "api",
"sourceRef": "CA1a2b3c4d5e",
"note": "상담 중 재연락 거부 의사 밝힘",
"createdBy": null,
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"unblockedAt": "2019-08-24T14:15:22Z",
"unblockedSource": "api",
"unblockedBy": "string",
"unblockedNote": "string"
}{
"id": "clx9blk00001",
"number": "01012345678",
"channel": "call",
"active": true,
"source": "api",
"sourceRef": "CA1a2b3c4d5e",
"note": "상담 중 재연락 거부 의사 밝힘",
"createdBy": null,
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z",
"unblockedAt": "2019-08-24T14:15:22Z",
"unblockedSource": "api",
"unblockedBy": "string",
"unblockedNote": "string"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}{
"error": "string",
"code": "recipient_blocked"
}