연동관리

시스템 연동 발송 서비스를 이용하기 위해서는 통합 Key를 발급받으셔야 합니다.

통합 Key는 비즈고에서 제공하는 모든 메시지 상품과 다양한 서비스를 하나로 통합해 이용할 수 있는 인증 수단입니다.

통합 Key 발급 한도

통합 Key는 팀스페이스별로 최대 5개까지 발급 가능하며, 5개 초과 발급이 필요하신 경우 고객센터로 문의해 주세요.

통합 Key 발급받기

통합 Key를 발급받기 위해 콘솔 > 팀스페이스 접속 후 발급받고자 하시는 팀스페이스로 진입합니다. 좌측 메뉴 중 연동관리 를 클릭한 후 페이지 내 KEY 발급 버튼을 클릭해 주세요.

통합 Key 발급1

최초 가입 시 자동 발급

최초 신규 가입 시 비즈니스 인증 완료 후 통합 Key 1개가 자동 발급되며, 선택한 요금제에 따라 상품이 추가된 상태로 확인할 수 있습니다.

통합 Key 발급2

통합 Key 발급 후 허용 가능 IP(ACL)를 설정하고 이용을 원하는 상품을 연결하여 통합 Key를 활성화할 수 있습니다.

Key 관리명을 설정하면 여러 개의 Key를 관리하는 경우 효율적으로 관리할 수 있습니다.

상품 API/AGENT 정보 확인하기

통합 Key 발급 후 이용을 원하는 상품 연결을 완료하면 API 또는 AGENT의 규격 및 상세 정보를 확인할 수 있습니다.

커뮤니케이션 상품의 경우 규격과 개발 문서 및 설치 파일, 이용 서비스, 리포트 수신 방법, 월/일 전송 가능 건수 등의 상세 정보를 확인하실 수 있으며, 리포트 수신 방식을 변경하실 수 있습니다.

리포트 수신이란?

커뮤니케이션 상품으로 발송한 메시지의 발송 최종 결괏값에 대한 리포트를 고객사의 시스템에서 수신할 것인지, 어떠한 방식으로 수신할 것인지를 설정하는 옵션입니다.

통합 Key 발급3

방식	설명
사용 안 함	최종 발송 결괏값을 고객사의 시스템으로 수신받지 않습니다.
POLLING	고객사의 시스템에서 요청할 때마다 결괏값을 제공하는 리포트 방식입니다.
WEBHOOK	최종 발송 결괏값이 생성될 때마다 고객사의 WEBHOOK URL로 리포트를 제공하는 방식입니다.

리포트 수신 방법 변경 시 반영 시간

리포트 수신 방법은 수정 가능하며, 변경 시 수정된 정보가 반영되기까지 최대 15분 내외로 소요됩니다.

Base URI

환경	Base URI
운영	`https://mars.ibapi.kr/api/comm`
Sandbox	`https://sandbox.ibapi.kr/api/comm`

인증 헤더

모든 API 요청에 아래 헤더를 포함합니다.

Authorization: ApiKey {발급받은 API 키}
Content-Type: application/json

요청 예시

curl -X POST https://mars.ibapi.kr/api/comm/v1/send \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

알림센터

비즈고 서비스에 문제가 발생하면 즉시 알림을 받아볼 수 있습니다. 알림은 연동관리에서 발급한 통합 Key 단위로 구독하며, 수신 채널과 알림 항목을 자유롭게 설정할 수 있습니다.

콘솔 > 팀스페이스 > 연동관리 > 알림센터 에서 설정할 수 있습니다.

알림센터

알림 항목

알림 항목은 중복 선택이 가능합니다.

알림항목

항목	설명
서비스 공지	작업·장애 발생 시 공지 알림
계정 알림	여신 부족, Rate Limit 초과 등 계정 관련 알림
새 소식	신규 기능 업데이트 안내

수신 채널

알림은 아래 채널 중 원하는 곳으로 수신할 수 있으며, 복수 채널 동시 등록도 가능합니다.

알림채널

채널	설명
Slack	Webhook URL을 통한 슬랙 채널 수신
Microsoft Teams	Incoming Webhook을 통한 팀즈 채널 수신
Google Chat	Webhook URL을 통한 구글 챗 스페이스 수신
Discord	Webhook URL을 통한 디스코드 채널 수신
Webhook	직접 구성한 URL로 HTTP POST 요청 수신

알림 등록 기준

알림은 연동관리에서 발급한 통합 Key 단위로 등록됩니다. Key별로 수신 채널과 알림 항목을 독립적으로 설정할 수 있습니다.

다음 단계

발송 흐름 이해 → 발송 요청 구조 이해
채널 선택 → 채널 선택 가이드