제품 · 문자 API
같은 번호로
문자 발신과 수신
내용 길이와 첨부에 따라 SMS · LMS · MMS로 나뉘어 나갑니다. 발송 결과와 받은 문자는 웹훅 이벤트(SEND_RESULT · MESSAGE_RECEIVED)로 내 서버에 옵니다.
통화에 쓰는 번호 그대로 문자를 보내고, 받은 문자는 웹훅으로 받습니다.
주요 기능
- SMS · LMS · MMS 발송내용 길이와 첨부에 따라 SMS · LMS · MMS로 보냅니다.제공 중
- 문자 수신 웹훅번호로 받은 문자를 MESSAGE_RECEIVED 이벤트로 받습니다.제공 중
- 발송 결과 웹훅보낸 문자의 최종 결과를 SEND_RESULT 이벤트로 받습니다.제공 중
- 콘솔 문자 수신함받은 문자를 콘솔에서 바로 봅니다.업데이트 중
- 알림톡 · 브랜드메시지카카오 알림톡과 브랜드메시지(친구톡 포함) 발송.예정
문자를 보내려면 발신번호 사전등록 등 국내 규정을 따라야 합니다. KAT Cloud에서 발급한 번호로 보냅니다.
‘업데이트 중’은 개발을 마치고 검토 중이라 아직 운영에 배포되지 않은 기능입니다. 전체 상태는 전체 기능에 있습니다.
채팅방 열기 → 문자 보내기 → 수신 웹훅 등록
# 1) 고객 번호로 채팅방을 연다 (같은 번호면 기존 채팅방 ID 를 돌려준다)
curl -X POST "https://studio-gateway.zerocall.kr/chat-room" \
-H "x-api-key: $KAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "channelId": 100, "phoneNumber": "01098765432" }'
# 2) 문자 보내기 (길이 · 제목 · 이미지에 따라 SMS · LMS · MMS)
curl -X POST "https://studio-gateway.zerocall.kr/chat" \
-H "x-api-key: $KAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "chatRoomId": "yyyy…", "content": "예약 확인되었습니다." }'
# 3) 받은 문자를 웹훅으로 받기
curl -X POST "https://studio-gateway.zerocall.kr/webhook" \
-H "x-api-key: $KAT_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "eventType": "MESSAGE_RECEIVED", "url": "https://my.app/kat/webhook" }'API 키는 콘솔에서 발급하고 x-api-key 헤더에 넣습니다.
요금
- SMS
- 10 / 9.5 / 9원 (건)구간 ~5천 / ~3만 / 3만 건 초과
- LMS
- 32 / 30 / 27원 (건)구간 ~5천 / ~3만 / 3만 건 초과
- MMS
- 75 / 70 / 65원 (건)구간 ~5천 / ~3만 / 3만 건 초과
- 알림톡
- 준비 중
구간은 플랜 포함량을 넘긴 사용분에 누적으로 적용합니다. 알림톡 · 브랜드메시지는 아직 제공하지 않아 준비 중으로 표시합니다. 모든 금액은 부가세 별도입니다. 요금제 보기
