📌 Spring Boot로 카카오톡 친구에게 메시지 보내기

📅 2025-05-13

---

✅ 이 문서로 할 수 있는 것

이 문서 하나로 다음 작업을 직접 구현할 수 있습니다:

• 카카오 개발자센터에서 앱 설정
• 인가 코드 요청 및 access token 발급
• 친구 목록 조회
• 템플릿 기반 메시지를 친구에게 전송
• Spring Boot 프로젝트에 바로 적용

---

1️⃣ 카카오 개발자센터 설정

1. 테스트 앱 생성 (비즈 앱 자동 등록됨)

1. https://developers.kakao.com 접속 → 로그인
2. [내 애플리케이션] > 테스트 앱 생성
3. 생성된 앱은 자동으로 비즈 앱 처리됨 → 친구 메시지 전송 가능

---

2. 플랫폼 설정

[내 애플리케이션 > 플랫폼] > Web 플랫폼 추가

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

---

3. Redirect URI 등록

[카카오 로그인 > Redirect URI 등록]

http://192.168.16.11:8090/kakao/callback

---

4. 동의 항목 설정

[카카오 로그인 > 동의 항목] → 항목 추가 후 ‘이용 중’ 설정

항목 이름	ID	설명
카카오톡 메시지 전송	talk_message	친구에게 메시지 전송
친구 목록	friends	uuid, 닉네임, 프로필 등 조회

---

2️⃣ 전체 구현 흐름 요약

브라우저에서 인가코드 요청 → 콜백에서 access_token 발급
 → 친구 목록 요청 → allowed_msg=true 필터링
 → 메시지 템플릿 구성 → 친구에게 메시지 전송

---

3️⃣ 전체 코드 (RestController 기반)

@RestController
@Slf4j
@RequestMapping("/kakao")
public class KakaoFriendMessageController {

    private final String CLIENT_ID = "카카오 REST API 키";
    private final String REDIRECT_URI = "http://192.168.16.11:8090/kakao/callback";

    private KakaoTokenResponse kakaoTokenResponse;
    private KakaoFriendsResponse kakaoFriendsResponse;

    // STEP 1: 인가 코드 요청 URL
    @GetMapping("/getCodeFriends")
    public String getCodeFriends() {
        return "redirect:https://kauth.kakao.com/oauth/authorize"
            + "?client_id=" + CLIENT_ID
            + "&redirect_uri=" + REDIRECT_URI
            + "&response_type=code"
            + "&scope=friends,talk_message"; // 친구 + 메시지 권한 요청
    }

    // STEP 2: access_token 발급
    @GetMapping("/callback")
    public String callback(@RequestParam("code") String code) {
        String url = "https://kauth.kakao.com/oauth/token";

        HttpHeaders headers = new HttpHeaders();
        headers.setContentType(MediaType.APPLICATION_FORM_URLENCODED);

        MultiValueMap<String, String> params = new LinkedMultiValueMap<>();
        params.add("grant_type", "authorization_code");
        params.add("client_id", CLIENT_ID);
        params.add("redirect_uri", REDIRECT_URI);
        params.add("code", code);

        HttpEntity<MultiValueMap<String, String>> entity = new HttpEntity<>(params, headers);
        RestTemplate rt = new RestTemplate();
        ResponseEntity<KakaoTokenResponse> response = rt.exchange(url, HttpMethod.POST, entity, KakaoTokenResponse.class);

        System.out.println("✅ AccessToken 응답: " + response);
        this.kakaoTokenResponse = response.getBody();

        return "AccessToken 발급 완료!";
    }

    // STEP 3: 친구 목록 요청
    @GetMapping("/friends")
    public String getFriends() {
        String url = "https://kapi.kakao.com/v1/api/talk/friends";

        HttpHeaders headers = new HttpHeaders();
        headers.add("Authorization", "Bearer " + kakaoTokenResponse.getAccess_token());

        HttpEntity<?> entity = new HttpEntity<>(headers);
        RestTemplate rt = new RestTemplate();
        ResponseEntity<KakaoFriendsResponse> response = rt.exchange(url, HttpMethod.GET, entity, KakaoFriendsResponse.class);

        System.out.println("👥 친구 목록 응답: " + response);
        this.kakaoFriendsResponse = response.getBody();

        return "친구 목록 조회 완료!";
    }

    // STEP 4: 친구에게 메시지 전송
    @GetMapping("/message/friends/{message}")
    public String sendMessage(@PathVariable("message") String message) {
        String url = "https://kapi.kakao.com/v1/api/talk/friends/message/send";

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

        // allowed_msg = true인 친구만 추출
        JSONArray uuids = new JSONArray();
        for (Element friend : kakaoFriendsResponse.getElements()) {
            if (friend.isAllowed_msg()) {
                uuids.add(friend.getUuid());
            }
        }

        // 템플릿 메시지 구성
        JSONObject template = new JSONObject();
        template.put("object_type", "text");
        template.put("text", message);
        template.put("link", new JSONObject()); // 필수 구조
        template.put("button_title", ""); // 버튼 없음

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

        HttpEntity<MultiValueMap<String, String>> entity = new HttpEntity<>(params, headers);
        RestTemplate rt = new RestTemplate();
        ResponseEntity<String> response = rt.exchange(url, HttpMethod.POST, entity, String.class);

        System.out.println("📨 메시지 전송 응답: " + response);
        return "친구에게 메시지 전송 완료!";
    }

    // Kakao AccessToken DTO
    @Data
    private static class KakaoTokenResponse {
        private String access_token;
        private String token_type;
        private String refresh_token;
        private int expires_in;
        private String scope;
        private int refresh_token_expires_in;
    }

    // Kakao 친구 목록 DTO
    @Data
    private static class Element {
        private String profile_nickname;
        private String profile_thumbnail_image;
        private boolean allowed_msg;
        private Object id;
        private String uuid;
        private boolean favorite;
    }

    @Data
    private static class KakaoFriendsResponse {
        private ArrayList<Element> elements;
        private int total_count;
        private Object after_url;
        private int favorite_count;
    }
}

---

⚠️ 실무 & 테스트 유의사항

항목	설명
✅ 템플릿 메시지 전용	친구에게는 자유 텍스트 전송 불가 → 반드시 template_object 사용
✅ allowed_msg 필터링	친구 목록 중 메시지 수신 동의한 사람만 가능
✅ 팀원 간 테스트 전용	앱 팀원으로 등록된 사람끼리만 메시지 주고받을 수 있음
⚠️ 로그와 응답 출력	실습 중이라면 반드시 System.out.println(...)으로 응답 확인해야 함

---

🔗 참고 문서

• 카카오 메시지 REST API
• 템플릿 메시지 구조
• OAuth 인증 흐름

---