사용 매뉴얼
kakaotalk-send-batch 명령어 활용
카카오 알림톡 설정을 위한 테스트는 다음과 같은 순서로 진행하면 좋습니다.
- 템플릿 조회
- 알림톡 전송 dry-run 테스트
- 검증 서버 발송 테스트
템플릿 검수를 마쳤음을 가정하고 설명합니다.
템플릿 조회
kakaotalk-templates 쿼리 명령어를 실행하면 템플릿 정보를 확인할 수 있습니다. 쿼리 명령어 실행 결과에서 내용(content)과 템플릿 코드(template_code)를 확인하세요.
알림톡 전송 dry-run 테스트
내용(content)에서 확인된 치환변수와 템플릿 코드(template_code)를 이용하여 배치 명령어 테스트를 진행하세요.
json "{}" | eval arg1 = "test", to="01000000000"
| union [ json "{}" | eval arg2="테스트 한글2", to="010-0000-0000" ]
| union [ json "{}" | eval arg1 = "테스트 한글", arg2="테스트 한글 영문 abcd", to="010-0000-0000" ]
| kakaotalk-send-batch profile="kakaotalk" template_code="ABCDE0000_00001" dry-run=t
앞의 json, eval 명령어들은 kakaotalk-send-batch 명령어 실행 시 필요한 파이프라인을 설명하기 위한 예시입니다. table 명령어와 같은 드라이브 쿼리를 조합하여 입력 필드를 kakaotalk-send-batch 명령어에 전달할 수 있습니다.
arg1,arg2는 템플릿에 사용된 치환변수와 일치해야 합니다.to는 알림톡 수신자의 휴대전화 필드로, 필수 필드입니다. 휴대전화 번호는 하이픈이 있는 형식(예:010-1234-5678), 없는 형식(예:01012345678) 모두 입력 가능합니다. 최종 변환된 전화번호는_to필드에서 확인할 수 있습니다.dry-run=t를 명시하면 실제 명령어가 동작했을 때의 예상 결과를 확인할 수 있습니다. 발송 실패 시,_result와_error필드를 통해 실패 사유를 알 수 있습니다.dry-run=f로 설정하거나, 미지정 시 알림톡이 사용자에게 전송되므로 참고하세요.
검증용 서버 발송 테스트
접속 프로파일의 앤드포인트를 제공 받은 검증용 서버를 등록하여 테스트를 진행한 뒤 운영 서버로 전환하세요.
Note
카카오 알림톡은 휴대전화번호를 기준으로 카카오톡에 가입된 사용자에게 메시지를 보내는 기능입니다. 카카오톡에 가입되지 않은 사용자에게는 메시지를 발송할 수 없습니다.
