Skip to main content
1

발급 정보 확보

관리자에서 다음 3가지 값을 확인합니다. 자세한 화면 가이드는 API 키 발급 페이지를 참고하세요.
  • apikey — API 인증 키
  • service — 서비스 번호
  • groupId — 그룹코드
apikey는 외부에 노출되면 안 됩니다. 반드시 서버 사이드에서만 사용하세요.
2

템플릿 등록

알림톡은 카카오 승인을 받은 템플릿만 발송 가능합니다. 영업 담당자에게 템플릿 등록을 요청하고 template 코드(BizCode)를 받습니다.
3

테스트 발송

받은 값들로 알림톡 한 건을 발송합니다.
import axios from 'axios';

const contents = `안녕하세요 #{이름}님, 테스트 메시지입니다.`;

await axios.post('https://api.alltalk.co.kr/alimTalk', {
  service: 1234567890,
  template: '10000',
  groupId: 'YOUR_GROUP_ID',
  message: contents,
  numbers: [
    { key: 1, hp: '010-1234-5678', name: '홍길동' },
  ],
}, {
  headers: { apikey: 'YOUR_API_KEY' },
});
4

발송 결과 확인

응답의 value[].uid로 개별 수신자 결과를 확인합니다. status: "OK" 는 성공, KKO_* 또는 ERR_* 는 실패입니다. 전체 코드 의미는 에러 코드 참조.

​
다음 단계

SMS 발송

단문 · 장문 문자 발송

알림톡 API 상세

모든 파라미터와 응답 필드