사용 매뉴얼
kakaotalk-send-batch 명령어 활용
카카오 알림톡의 활용은 다음과 같은 순서로 진행하면 좋습니다.
- 템플릿 조회
- 배치 명령어 dry-run 테스트
- 검증 서버 발송 테스트
kakaotalk-templates
템플릿 검수가 완료 됐음을 가정하고 템플릿 조회 명령어를 실행하면 승인이 완료된 템플릿 정보를 확인할 수 있습니다. 필요한 템플릿 내용(content)을 확인한 뒤, 템플릿코드(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 dry-run=t template_code="ABCDE0000_00001" profile="kakaotalk"
| union [json "{}" | eval arg2="테스트 한글2", to="010-0000-0000"]
| union [json "{}" | eval arg1 = "테스트 한글", arg2="테스트 한글 영문 abcd", to="010-0000-0000"]
| kakaotalk-send-batch dry-run=t template_code="ABCDE0000_00001" profile="kakaotalk"
앞의 json, eval 커맨드는 배치 커맨드로 이어지는 조회 파이프라인을 설명하기 위한 예시입니다. 해당 부분은 table 커맨드와 같은 드라이브쿼리를 조합하여 활용할 수 있습니다.
arg1 과 arg2 는 템플릿의 치환문자와 대응되어 실제 메시지로 변환되는 부분입니다. to 는 발송 대상의 휴대전화번호를 입력 하기 위한 필드이며 발송을 위한 필수 필드입니다. 대시와 대시가 없는 형태 모두 입력 가능합니다. 최종 변환된 전화번호는 _to 필드를 통해 확인할 수 있습니다.
위와 같이 dry-run=t 를 활용하면 실제 커맨드가 동작됐을 때의 예상 결과를 확인할 수 있습니다. 발송 실패 시, _result 와 _error 필드를 통해 실패 사유를 알 수 있습니다.
dry-run=f 로 설정하거나 옵션을 입력하지 않으면 실제 발송이 진행되니 활용에 참고 바랍니다.
접속프로파일의 앤드포인트를 제공 받은 검증용 서버를 등록하여 테스트를 진행한 뒤 운영 서버로 전환하는 것을 권장드립니다.
Tip
카카오 알림톡은 휴대전화번호를 기준으로 카카오톡에 가입된 사용자에게 메시지를 보내는 기능입니다.
카카오톡에 가입되지 않은 사용자에겐 메시지 발송이 제한됩니다.
카카오톡에 가입되지 않은 사용자에겐 메시지 발송이 제한됩니다.
