📌 카카오톡 나에게 메시지 보내기 API 연동 (Spring Boot)

📅 2025-05-13

---

📝 학습 목표

• 카카오 디벨로퍼스에서 애플리케이션을 설정하고
• OAuth2 인증을 통해 access token을 발급받은 후
• RestTemplate을 사용하여 자신에게 카카오톡 메시지를 보내는 API를 구현

---

1️⃣ 카카오 디벨로퍼스 설정

✅ 1. 애플리케이션 등록

1. https://developers.kakao.com 접속
2. 로그인 후 [내 애플리케이션] > 애플리케이션 추가
   • 앱 이름, 사업자 여부 등록

---

✅ 2. 플랫폼 등록

• [내 애플리케이션] → [플랫폼] 탭 → Web 선택
• 사이트 도메인 등록:

http://localhost:8090
http://192.168.16.11:8090

---

✅ 3. Redirect URI 등록

• [카카오 로그인] → Redirect URI 등록
• 예시:

http://localhost:8090/kakao/callback
http://192.168.16.11:8090/kakao/callback

---

✅ 4. 카카오 로그인 활성화

• [카카오 로그인] 탭 > 활성화
• 로그인 ON → 기본 동의 항목 설정 가능

---

✅ 5. 동의 항목 설정

• [카카오 로그인 > 동의항목] 탭 → 항목 추가

항목 이름	ID	설정
카카오톡 메시지 전송	talk_message	이용 중으로 설정

이 항목이 있어야 나에게 메시지 보내기 API 호출 가능

---

2️⃣ 인가 코드 요청 URL (스코프 포함)

@GetMapping("/getCodeMsg")
public String getCode_message(){
    return "redirect:https://kauth.kakao.com/oauth/authorize"
        + "?client_id=" + CLIENT_ID
        + "&redirect_uri=" + REDIRECT_URI
        + "&response_type=code"
        + "&scope=talk_message";  // ✅ 메시지 전송 권한 요청
}

• 인가 코드를 받은 후, 서버에서 access_token을 발급받아 저장해야 합니다.

---

3️⃣ 나에게 메시지 보내기 API (Spring Boot)

@GetMapping("/message/me/{message}")
public void message_me(@PathVariable("message") String message){
    String url = "https://kapi.kakao.com/v2/api/talk/memo/default/send";

    HttpHeaders header = new HttpHeaders();
    header.add("Authorization", "Bearer " + kakaoTokenResponse.getAccess_token());
    header.add("Content-Type", "application/x-www-form-urlencoded;charset=utf-8");

    JSONObject template_object = new JSONObject();
    template_object.put("object_type", "text");
    template_object.put("text", message);
    template_object.put("link", new JSONObject()); // 필수 필드
    template_object.put("button_title", "");       // 버튼 없이 가능

    MultiValueMap<String, String> params = new LinkedMultiValueMap<>();
    params.add("template_object", template_object.toString());

    HttpEntity<MultiValueMap<String, String>> entity = new HttpEntity<>(params, header);
    new RestTemplate().exchange(url, HttpMethod.POST, entity, String.class);
}

---

🔍 테스트 흐름 요약

1. 브라우저 접속 – 인가 코드 요청

   http://localhost:8090/kakao/getCodeMsg
   

2. 사용자 동의 후 Redirect URI로 인가 코드 전달

3. 인가 코드로 AccessToken 발급

4. 메시지 전송

   http://localhost:8090/kakao/message/me/안녕하세요
   

5. 카카오톡 앱의 “나와의 채팅방”에서 메시지 확인

---

🔥 실무 정리 포인트

항목	설명
talk_message	필수 스코프. 사용자 동의 필요
template_object	메시지 내용 구성. 반드시 JSON 형식
link, button_title	생략 불가지만 값은 비워도 됨
인증 흐름	인가 코드 → AccessToken → 메시지 전송
토큰 저장	보안을 위해 세션 또는 DB에 저장 권장

---

🔗 참고 자료

• 카카오 메시지 API 문서
• 카카오 로그인 설정 가이드

---