bizgo Developers

발송 결과 조회

비즈고는 발송 결과를 두 가지 방식으로 확인할 수 있습니다.

방식설명권장 상황
웹훅 (Push)결과 발생 즉시 서버로 전송실시간 처리가 필요한 경우
개별 조회 (Inquiry)msgKey로 특정 메시지 결과 직접 조회특정 건 확인 또는 웹훅 미수신 보완

웹훅을 기본으로 사용하고, 웹훅 미수신 시 개별 조회로 보완하는 것이 권장 패턴입니다.

개별 조회 흐름

  1. 발송 API 응답에서 msgKey 저장
  2. msgKey로 조회 API 호출
  3. reportCode로 최종 수신 여부 확인

조회 가능 기간: 최대 30일 이전까지

msgKey 저장 중요성

msgKey가 없으면 이후 결과 조회, 문의, 재시도가 불가능합니다.
발송 응답에서 반드시 DB에 저장해두세요.

const response = await sendMessage(payload);
const msgKey = response.data.data.destinations[0].msgKey;

await db.messages.insert({ msgKey, ref: payload.ref, status: 'sent' });

결과 코드 해석

조회 응답의 reportCode로 최종 수신 여부를 판단합니다.
코드 상세 내용은 아래에서 확인하세요.

응답 코드 해석

authCode, data.code, reportCode의 의미와 권장 처리 방법을 정리합니다.

코드 해석하기 →

다음 단계