update

Author: WooilJeong

PyKakao/api.py

@@ -21,7 +21,8 @@ def __init__(self, service_key=None, redirect_uri="https://localhost:5000", scop
         self.service_key = service_key
         self.redirect_uri = redirect_uri
         self.scope = scope
-        self.url = "https://kapi.kakao.com/v2/api/talk/memo/default/send"
+        self.url_message_me = "https://kapi.kakao.com/v2/api/talk/memo/default/send"
+        self.url_message_friend = "https://kapi.kakao.com/v1/api/talk/friends/message/default/send"
 
     def get_url_for_generating_code(self):
         """
@@ -110,164 +111,69 @@ def set_access_token(self, access_token):
         access_token : str
             액세스 토큰
         """
-        self.headers = {"Authorization": f"Bearer {access_token}"}
+        self.headers = {
+            "Authorization": f"Bearer {access_token}",
+            "Content-Type": "application/x-www-form-urlencoded",
+            }
         print("액세스 토큰 설정 완료")
 
-    def send_text(self, text, link, **kwargs):
-        """
-        텍스트 메시지 전송
-
-        Parameters
-        ----------
-        text : str
-            전송할 메시지 (최대 200자)
-        """
-        params = {
-            "object_type": "text",
-            "text": text,
-            "link": link,
-        }
-        params.update(kwargs)
-        data = {"template_object": json.dumps(params)}
-        try:
-            r = requests.post(self.url, headers=self.headers, data=data)
-            r.raise_for_status()
-        except Exception as e:
-            print(f"메시지 전송 실패")
-            print(e)
-            return
-        if r.json()['result_code'] == 0:
-            print("메시지 전송 성공")
-        else:
-            print(f"메시지 전송 실패")
-            print(r.json())
-
-    def send_feed(self, content, **kwargs):
-        """
-        피드 메시지 전송
+    def send_message_to_me(self, message_type, **kwargs):
+        """나에게 보내기 API
 
         Parameters
         ----------
-        content : dict
-            피드 내용
+        message_type : str
+            메시지 유형 ('text', 'feed', 'list', 'location', 'commerce' 등)
+        kwargs : dict
+            메시지 유형에 따른 추가 파라미터
         """
-        params = {
-            "object_type": "feed",
-            "content": content,
-        }
+        params = {"object_type": message_type}
         params.update(kwargs)
         data = {"template_object": json.dumps(params)}
         try:
-            r = requests.post(self.url, headers=self.headers, data=data)
+            r = requests.post(self.url_message_me, headers=self.headers, data=data)
             r.raise_for_status()
         except Exception as e:
-            print(f"메시지 전송 실패")
+            print("메시지 전송 실패")
             print(e)
             return
         if r.json()['result_code'] == 0:
             print("메시지 전송 성공")
         else:
-            print(f"메시지 전송 실패")
+            print("메시지 전송 실패")
             print(r.json())
 
-    def send_list(self, header_title, header_link, contents, **kwargs):
-        """
-        리스트 메시지 전송
+    def send_message_to_friend(self, message_type, receiver_uuids, **kwargs):
+        """친구에게 보내기 API
 
         Parameters
         ----------
-        header_title : str
-            리스트 제목
-        header_link : dict
-            리스트 링크
-        contents : list
-            리스트 내용
-        """
-        params = {
-            "object_type": "list",
-            "header_title": header_title,
-            "header_link": header_link,
-            "contents": contents,
-        }
+        message_type : str
+            메시지 유형 ('text', 'feed', 'list', 'location', 'commerce' 등)
+        receiver_uuids : list
+            받는 사람의 고유 ID 목록
+        kwargs : dict
+            메시지 유형에 따른 추가 파라미터
+        """
+        params = {"object_type": message_type}
         params.update(kwargs)
-        data = {"template_object": json.dumps(params)}
-        try:
-            r = requests.post(self.url, headers=self.headers, data=data)
-            r.raise_for_status()
-        except Exception as e:
-            print(f"메시지 전송 실패")
-            print(e)
-            return
-        if r.json()['result_code'] == 0:
-            print("메시지 전송 성공")
-        else:
-            print(f"메시지 전송 실패")
-            print(r.json())
-
-    def send_location(self, address, address_title, content, **kwargs):
-        """
-        위치 메시지 전송
-
-        Parameters
-        ----------
-        address : str
-            주소
-        address_title : str
-            주소 제목
-        content : dict
-            위치 정보
-        """
-        params = {
-            "object_type": "location",
-            "address": address,
-            "address_title": address_title,
-            "content": content,
-        }
-        params.update(kwargs)
-        data = {"template_object": json.dumps(params)}
-        try:
-            r = requests.post(self.url, headers=self.headers, data=data)
-            r.raise_for_status()
-        except Exception as e:
-            print(f"메시지 전송 실패")
-            print(e)
-            return
-        if r.json()['result_code'] == 0:
-            print("메시지 전송 성공")
-        else:
-            print(f"메시지 전송 실패")
-            print(r.json())
-
-    def send_commerce(self, content, commerce, **kwargs):
-        """
-        커머스 메시지 전송
-
-        Parameters
-        ----------
-        content : dict
-            커머스 정보
-        commerce : dict
-            상품 정보
-        """
-        params = {
-            "object_type": "commerce",
-            "content": content,
-            "commerce": commerce,
-        }
-        params.update(kwargs)
-        data = {"template_object": json.dumps(params)}
+        data = {
+            "receiver_uuids": json.dumps(receiver_uuids),
+            "template_object": json.dumps(params),
+            }
         try:
-            r = requests.post(self.url, headers=self.headers, data=data)
+            r = requests.post(self.url_message_friend, headers=self.headers, data=data)
             r.raise_for_status()
+            response = r.json()
+            # 성공한 UUID 목록 확인
+            if "successful_receiver_uuids" in response:
+                print("메시지 전송 성공:", response["successful_receiver_uuids"])
+            # 실패 정보 확인
+            if "failure_info" in response:
+                print("일부 메시지 전송 실패:", response["failure_info"])
         except Exception as e:
-            print(f"메시지 전송 실패")
+            print("메시지 전송 실패")
             print(e)
-            return
-        if r.json()['result_code'] == 0:
-            print("메시지 전송 성공")
-        else:
-            print(f"메시지 전송 실패")
-            print(r.json())
 
 
 class KoGPT:

PyKakao/config/info.py

@@ -1,5 +1,5 @@
 __project__ = "PyKakao"
-__version__ = "0.0.6"
+__version__ = "0.0.7"
 __author__ = "정우일(Wooil Jeong)"
 __contact__ = "wooil@kakao.com"
 __github__ = "https://github.com/WooilJeong/PyKakao"

README.md

@@ -233,7 +233,7 @@ nsfw_response = api.check_nsfw(encoded_images_for_nsfw_check)
 
 ### 메시지 API
 
-메시지 API는 사용자가 카카오톡 친구에게 카카오톡 메시지를 보내는 기능을 제공합니다. PyKakao의 최신 버전에서는 '나에게 보내기' 기능만 이용할 수 있습니다.
+메시지 API는 사용자가 카카오톡 친구에게 카카오톡 메시지를 보내는 기능을 제공합니다. PyKakao의 최신 버전에서는 '나에게 보내기'와 '친구에게 보내기' 기능을 이용할 수 있습니다.
 
 메시지 API의 경우 아래 '카카오 로그인 관련 설정하기'와 같이 설정 후 정상적으로 이용할 수 있습니다.
 
@@ -269,15 +269,40 @@ access_token = MSG.get_access_token_by_redirected_url(url)
 # 액세스 토큰 설정
 MSG.set_access_token(access_token)
 
-# 텍스트 메시지 전송
-text = "텍스트 영역입니다. 최대 200자 표시 가능합니다."
+# 1. 나에게 보내기 API - 텍스트 메시지 보내기 예시
+message_type = "text" # 메시지 유형 - 텍스트
+text = "텍스트 영역입니다. 최대 200자 표시 가능합니다." # 전송할 텍스트 메시지 내용
 link = {
-            "web_url": "https://developers.kakao.com",
-            "mobile_web_url": "https://developers.kakao.com"
-        }
-button_title = "바로 확인"
+  "web_url": "https://developers.kakao.com",
+  "mobile_web_url": "https://developers.kakao.com",
+}
+button_title = "바로 확인" # 버튼 타이틀
+
+MSG.send_message_to_me(
+    message_type=message_type, 
+    text=text,
+    link=link,
+    button_title=button_title,
+)
+
+# 2. 친구에게 보내기 API - 텍스트 메시지 보내기 예시 (친구의 UUID 필요)
+message_type = "text" # 메시지 유형 - 텍스트
+receiver_uuids = [] # 메시지 수신자 UUID 목록
+text = "텍스트 영역입니다. 최대 200자 표시 가능합니다." # 전송할 텍스트 메시지 내용
+link = {
+  "web_url": "https://developers.kakao.com",
+  "mobile_web_url": "https://developers.kakao.com",
+}
+button_title = "바로 확인" # 버튼 타이틀
+
+MSG.send_message_to_friend(
+    message_type=message_type, 
+    receiver_uuids=receiver_uuids,
+    text=text,
+    link=link,
+    button_title=button_title,
+)
 
-MSG.send_text(text=text, link={}, button_title=button_title)
 ```
 
 <br>

test/test-code.ipynb

@@ -209,7 +209,7 @@
    "outputs": [],
    "source": [
     "# 카카오 인증코드 발급 URL 접속 후 리다이렉트된 URL\n",
-    "url = \"https://localhost:5000/?code=q4uqoy53MvJ_ZFZOfoOynbd55rLYecKKfEo9rtTiwk_wXp1Dm3LWlf_bdLd_eVB4eunSmgopcJ8AAAGFGsKe4A\"\n",
+    "url = \"\"\n",
     "# 위 URL로 액세스 토큰 추출\n",
     "access_token = API.get_access_token_by_redirected_url(url)"
    ]