수신거부 등록

번호를 수신거부 명단에 등록합니다. 대상은 이 계정의 발신(전화·문자)이고, 착신은 대상이 아닙니다 — 그 번호에서 걸려오는 전화는 그대로 받습니다.

등록 즉시 발신이 막힙니다. 이 계정에서 그 번호로 통화를 걸거나 문자를 보내면 발신 직전에 422 recipient_blocked 로 거절되고, 배치 발신(캠페인)도 같은 관문을 지나므로 해당 대상은 자동으로 건너뜁니다. 이미 진행 중인 통화는 끊지 않습니다 — 막는 것은 새 발신입니다.

멱등입니다. 이미 차단 중인 (번호, 채널) 조합을 다시 등록하면 에러 없이 기존 항목을 200 으로 돌려줍니다. 새로 등록된 경우에만 201 입니다. 같은 사람이 수신거부를 두 번 요청하는 것은 정상 상황이기 때문입니다.

전화와 문자를 모두 차단하려면 channel 을 바꿔 두 번 호출합니다.

번호를 수신거부 명단에 등록합니다. 대상은 이 계정의 **발신**(전화·문자)이고, 착신은 대상이 아닙니다 — 그 번호에서 걸려오는 전화는 그대로 받습니다. 등록 즉시 **발신이 막힙니다.** 이 계정에서 그 번호로 통화를 걸거나 문자를 보내면 발신 직전에 `422 recipient_blocked` 로 거절되고, 배치 발신(캠페인)도 같은 관문을 지나므로 해당 대상은 자동으로 건너뜁니다. 이미 진행 중인 통화는 끊지 않습니다 — 막는 것은 새 발신입니다. **멱등입니다.** 이미 차단 중인 (번호, 채널) 조합을 다시 등록하면 에러 없이 기존 항목을 `200` 으로 돌려줍니다. 새로 등록된 경우에만 `201` 입니다. 같은 사람이 수신거부를 두 번 요청하는 것은 정상 상황이기 때문입니다. 전화와 문자를 모두 차단하려면 `channel` 을 바꿔 두 번 호출합니다.

Authentication

AuthorizationBearer

API Key를 Bearer 토큰으로 전달

Path parameters

accountIdstringRequired

계정 ID

Request

This endpoint expects an object.

numberstringRequired

수신거부할 번호. 하이픈·+82 형태 모두 허용되며 국내 표기로 정규화되어 저장됩니다.

channelenumRequired

차단할 채널. call=전화, message=문자(SMS/LMS/MMS 공통).

Allowed values:

sourceenumOptionalDefaults to api

접수 경로. 미지정 시 api. agent 는 AI 상담 중 고객이 구두로 요청해 등록한 경우로, 콘솔 수기 등록과 구분해 두면 나중에 “언제 어떻게 거부 의사를 밝혔나”에 답할 수 있습니다.

Allowed values:

sourceRefstringOptional

증빙 링크(통화 id 또는 메시지 id). 어떤 통화·문자에서 거부 의사가 나왔는지 되짚는 용도입니다.

notestringOptional<=500 characters

자유 메모

Response

이미 차단 중 — 기존 항목을 그대로 반환(멱등)

idstringOptional

수신거부 항목 id

numberstringOptional

수신거부한 상대 번호. 하이픈·+82 형태로 보내도 국내 표기로 정규화되어 저장·응답됩니다.

channelenumOptional

차단 채널. call=전화, message=문자(SMS/LMS/MMS 공통). 같은 번호라도 채널마다 별개 항목입니다.

activebooleanOptional

지금 차단 중인지 여부. 해제된 항목도 이력으로 남아 조회되므로 이 값으로 구분합니다.

sourcestringOptional

접수 경로. 공개 API 로 등록하면 api·console·import 중 하나입니다. ARS(수신거부 9번)·문자 회신 등 내부 접수 경로로 등록된 항목은 ars·sms·agent 로 나타납니다.

sourceRefstring or nullOptional

증빙 링크. 어느 통화에서 수신거부를 눌렀는지 / 어느 문자에 회신했는지. 가리키는 대상은 source 가 결정합니다.

notestring or nullOptional

자유 메모

createdBystring or nullOptional

등록 주체(콘솔 사용자 등). 자동 접수는 null 입니다.

createdAtdatetimeOptional

수신거부 접수 시각

updatedAtdatetimeOptional

unblockedAtdatetime or nullOptional

해제 시각. null 이면 차단 중입니다. 해제해도 항목은 삭제되지 않고 이력으로 남습니다.

unblockedSourcestring or nullOptional

해제 경로

unblockedBystring or nullOptional

해제 주체. 자동 해제는 null 입니다.

unblockedNotestring or nullOptional

해제 사유 메모

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

전화와 문자를 모두 차단하려면 channel 을 바꿔 두 번 호출합니다.

$	curl -X POST https://api.claw-ops.com/v1/accounts/AC1a2b3c4d/blocked-recipients \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"number": "010-1234-5678",
>	"channel": "call"
>	}'

1	{
2	"id": "clx9blk00001",
3	"number": "01012345678",
4	"channel": "call",
5	"active": true,
6	"source": "api",
7	"sourceRef": "CA1a2b3c4d5e",
8	"note": "상담 중 재연락 거부 의사 밝힘",
9	"createdBy": null,
10	"createdAt": "2024-01-15T09:30:00Z",
11	"updatedAt": "2024-01-15T09:30:00Z",
12	"unblockedAt": "2024-01-15T09:30:00Z",
13	"unblockedSource": "api",
14	"unblockedBy": "string",
15	"unblockedNote": "string"
16	}