페이지 이동경로
  • 문서>
  • 메시지>
  • 카카오톡 메시지: iOS

메시지

카카오톡 메시지: iOS

이 문서는 Kakao SDK for iOS(이하 iOS SDK)를 사용한 카카오톡 메시지 API 구현 방법을 안내합니다.

시작하기 전에

필요한 모듈 설정하기

카카오톡 메시지 API는 카카오톡 모듈인 TalkApi가 제공합니다. 따라서 카카오톡 메시지 API를 사용하려면 카카오 로그인 모듈 KakaoSDKUser, 사용자 인증 모듈 KakaoSDKAuth, 카카오톡 모듈 KakaoSDKTalk을 모두 설치해야 합니다. 모듈 설치 방법은 설치하기를 참고합니다.

모듈 설치 후 카카오 로그인과 카카오톡 메시지 API를 다음과 같이 import합니다.

Swift
RxSwift
import KakaoSDKAuth
import KakaoSDKUser
import KakaoSDKTalk

// 기본 템플릿 사용 시 필요
import KakaoSDKTemplate
import KakaoSDKAuth
import RxKakaoSDKAuth

import KakaoSDKUser
import RxKakaoSDKUser

import KakaoSDKTalk
import RxKakaoSDKTalk

// 기본 템플릿 사용 시 필요
import KakaoSDKTemplate

구현 방법 선택하기

Step 1. 메시지 API 선택하기

메시지 API는 카카오톡 공유와 카카오톡 메시지 두 가지입니다. 이해하기를 참고해 어떤 API로 메시지 보내기를 구현할 것인지 결정합니다. 카카오톡 메시지를 사용하려는 경우, Step 2 이후의 내용을 확인합니다.

Step 2. 메시지 종류 및 구성 방법 선택하기

종류를 참고하여 어떤 메시지 템플릿을 사용할지 결정합니다.

보낼 메시지는 기본 템플릿을 바탕으로 객체 형태로 구성하거나, 서비스에 맞게 직접 구성한 사용자 정의 템플릿을 사용하여 구성할 수 있습니다. 자세한 정보는 메시지 구성 방법에서 확인할 수 있습니다.

Step 3. 메시지 전송 대상 선택하기

카카오톡 메시지의 경우, 수신 대상에 따라 나에게 보내기, 친구에게 보내기로 API가 구분되어 있다는 점에 유의합니다.

전송 대상 설명
에게 보내기 현재 로그인한 사용자의 카카오톡 나와의 채팅에 메시지를 보냅니다. 이 기능으로는 다른 사용자에게 메시지를 보낼 수 없고, 로그인한 사용자 본인에게만 메시지를 보낼 수 있습니다.
친구에게 보내기 현재 로그인한 사용자의 카카오톡 친구에게 메시지를 보냅니다. 피커 또는 친구 목록 가져오기를 통해 수신 대상 정보를 받는 과정을 추가 구현해야 합니다. 한 번에 최대 5명의 친구에게 메시지를 보낼 수 있습니다. 일간 및 월간 제공량이 정해져 있으므로 운영 정책을 참고합니다.
주의: 사용 권한

친구에게 보내기를 사용하려는 경우, 카카오톡 메시지 사용 권한 신청을 참고하여 테스트 및 사용 권한 신청을 진행합니다. 이용 정책을 함께 참고합니다.


참고: 선택 조건별 필요한 메서드
전송 대상 메시지 종류 메시지 구성 방법 메서드
나에게 보내기 피드, 리스트, 위치, 커머스, 텍스트 기본 템플릿 sendDefaultMemo()
피드, 리스트, 커머스 사용자 정의 템플릿 sendCustomMemo()
스크랩 기본 템플릿 sendScrapMemo()
사용자 정의 템플릿 sendScrapMemo()
친구에게 보내기 피드, 리스트, 위치, 커머스, 텍스트 기본 템플릿 friends()
sendDefaultMessage()
피드, 리스트, 커머스 사용자 정의 템플릿 friends()
sendCustomMessage()
스크랩 기본 템플릿 friends()
sendScrapMessage()
사용자 정의 템플릿 friends()
sendScrapMessage()

커스텀 URL 스킴(Custom URL Scheme) 설정하기

카카오톡 메시지는 지정된 웹 페이지 또는 앱을 실행하는 링크를 포함합니다. 메시지 속 버튼들은 URI 스킴(URI Schemes)과 파라미터로 구성된 커스텀 URL 스킴을 통해 앱을 실행합니다.

사용자가 카카오톡 메시지의 버튼을 통해 앱을 실행할 수 있도록 하려면 설정하기를 참고하여 앱 실행 허용 목록과 URL Scheme 설정을 해야 합니다. 자세한 설정 안내는 커스텀 URL 스킴 설정하기를 참고합니다.

메시지 만들기

카카오톡 공유와 카카오톡 메시지 API 사용을 위해 메시지 만드는 방법은 동일합니다. 메시지 만들기를 참고합니다.

기본 템플릿으로 메시지 보내기

기본 정보

사전 설정 카카오 로그인 사용자 동의 권한 레퍼런스
플랫폼 등록
카카오 로그인 활성화
동의 항목
필요 필요:
카카오톡 메시지 전송(talk_message)
필요:
사용 권한
(친구에게 보내기)
공통
MessageSendResult
MessageFailureInfo
iOS SDK
sendDefaultMemo()
sendDefaultMessage()
ReactiveX iOS SDK
sendDefaultMemo()
sendDefaultMessage()

기본 템플릿을 사용해 현재 로그인한 사용자의 카카오톡으로 메시지를 보냅니다. 메시지 전송 대상에 따라 호출해야 할 메서드가 다릅니다.

SdkJSONDecoder.custom.decode()를 호출해 메시지 만들기에서 생성한 JSON 객체로 Templatable 객체를 생성합니다. 생성 성공 시 메시지 전송에 사용합니다.

친구에게 메시지를 보내려면 메시지 전송 요청 시 누구에게 메시지를 보낼 것인지 지정해야 합니다. 피커 또는 친구 목록 가져오기를 통해 메시지를 보낼 친구의 uuid 정보를 확인할 수 있습니다. 친구 목록을 만들어 사용자에게 보여주고, 사용자가 선택한 친구들의 uuid 목록은 receiverUuids 파라미터에 리스트(List)로 담아 전달합니다. 한 번에 최대 5명의 친구에게 메시지를 보낼 수 있습니다.

메시지 전송 결과는 MessageSendResult 객체로 받으며, 메시지 전송에 성공한 친구의 uuid를 담은 문자열(String) 리스트와 실패 결과를 담은 MessageFailureInfo 객체 리스트로 구성돼 있습니다.

전송 실패 시, MessageFailureInfo에 포함된 대상 친구의 목록인 receiverUuids와 오류 원인을 알려주는 code, msg응답 코드에서 원인을 확인합니다.

나에게 보내기

Parameter
Name Type Description Required
templatable Templatable 전송할 메시지 템플릿 객체
원하는 템플릿에 맞는 클래스로 객체를 생성해야 함
메시지 만들기 참고
O
Swift
RxSwift
// templatable은 메시지 만들기 항목 참고
if let templatable = try? SdkJSONDecoder.custom.decode(FeedTemplate.self, from: feedTemplateJsonStringData) {
    TalkApi.shared.sendDefaultMemo(templatable: templatable) {(error) in
        if let error = error {
            print(error)
        }
        else {
            print("success.")
        }
    }
}
// Class member property
let disposeBag = DisposeBag()

// templatable은 메시지 만들기 항목 참고
if let templatable = try? SdkJSONDecoder.custom.decode(FeedTemplate.self, from: feedTemplateJsonStringData) {
    TalkApi.shared.rx.sendDefaultMemo(templatable:templatable)
        .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
        .subscribe (onCompleted:{
            print("success.")            
        }, onError: {error in
            print(error)
        })
        .disposed(by: disposeBag)
}

친구에게 보내기

Parameter
Name Type Description Required
receiverUuids [String] 피커 또는 친구 목록 가져오기를 통해 얻은 사용자 uuid 값 목록, 최대 5개 O
templatable Templatable 전송할 메시지 템플릿 객체
원하는 템플릿에 맞는 클래스로 객체를 생성해야 함
메시지 만들기 참고
O
Swift
RxSwift
// templatable은 메시지 만들기 항목 참고
if let templatable = try? SdkJSONDecoder.custom.decode(FeedTemplate.self, from: feedTemplateJsonStringData) {
    // 카카오톡 친구 목록 가져오기
    TalkApi.shared.friends {(friends, error) in
        if let error = error {
            print(error)
        } else {
            print("friends() success.")
            guard let friends = friends else {
                print(error)
                return
            }
            
            //친구선택창 구현.
            ...
        
            //UI로 선택된 친구의 uuids
            let friendUuids = selectedIds as! [String]
                    
            // 카카오톡 메시지 전송
            TalkApi.shared.sendDefaultMessage(templatable: templatable, receiverUuids: friendUuids) { (messageSendResult, error) in
                if let error = error {
                    print(error)
                } else {
                    print("sendDefaultMessage() success.")
                    
                    //do something
                    _ = messageSendResult
                }
            }
        }
    }
}
// Class member property
let disposeBag = DisposeBag()

// templatable은 메시지 만들기 항목 참고
if let templatable = try? SdkJSONDecoder.custom.decode(FeedTemplate.self, from: feedTemplateJsonStringData) {
    // 카카오톡 친구 목록 가져오기
    TalkApi.shared.rx.friends()
        .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
        .subscribe(onSuccess: { (friends) in
            print("friends() success.")
            
            //친구선택창 구현.
            ...
        
            //UI로 선택된 친구의 uuids
            let friendUuids = selectedIds as! [String]

            // 카카오톡 메시지 전송
            TalkApi.shared.rx.sendDefaultMessage(templatable:templatable, receiverUuids:friendUuids)
                .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
                .subscribe(onSuccess:{ (messageSendResult) in
                    print("sendDefaultMessage() success.")
                    //do something
                    _ = messageSendResult

                }, onFailure: {error in
                    print(error)
                })
                .disposed(by: disposeBag)
            
        }, onFailure: {error in
            print(error)
        })
        .disposed(by: disposeBag)
}

사용자 정의 템플릿으로 메시지 보내기

기본 정보

사전 설정 카카오 로그인 사용자 동의 권한 레퍼런스
플랫폼 등록
카카오 로그인 활성화
동의 항목
메시지 템플릿
필요 필요:
카카오톡 메시지 전송(talk_message)
필요:
사용 권한
(친구에게 보내기)
공통
MessageSendResult
MessageFailureInfo
iOS SDK
sendCustomMemo()
sendCustomMessage()
ReactiveX iOS SDK
sendCustomMemo()
sendCustomMessage()

[도구] > [메시지 템플릿]에서 직접 구성한 사용자 정의 템플릿을 사용하여 현재 로그인한 사용자의 카카오톡으로 메시지를 보냅니다. 메시지 전송 대상에 따라 호출해야 할 메서드가 다릅니다.

사용자 정의 템플릿 ID를 templateId 파라미터로 전달해야 합니다. 메시지에 변동되는 정보를 포함하려면 해당 사용자 정의 템플릿에 사용자 인자를 추가한 후, templateArgs 파라미터를 통해 키와 값을 전달합니다. 사용자 정의 템플릿에 사용자 인자가 포함되었음에도 해당 파라미터를 사용하지 않을 경우, 사용자 인자로 지정된 부분이 ${KEY} 형식으로 메시지에 그대로 노출됩니다.

친구에게 메시지를 보내려면 메시지 전송 요청 시 누구에게 메시지를 보낼 것인지 지정해야 합니다. 피커 또는 친구 목록 가져오기를 통해 메시지를 보낼 친구의 uuid 정보를 확인할 수 있습니다. 친구 목록을 만들어 사용자에게 보여주고, 사용자가 선택한 친구들의 uuid 목록은 receiverUuids 파라미터에 리스트(List)로 담아 전달합니다. 한 번에 최대 5명의 친구에게 메시지를 보낼 수 있습니다.

메시지 전송 결과는 MessageSendResult 객체로 받으며, 메시지 전송에 성공한 친구의 uuid를 담은 문자열(String) 리스트와 실패 결과를 담은 MessageFailureInfo 객체 리스트로 구성돼 있습니다.

전송 실패 시, MessageFailureInfo에 포함된 대상 친구의 목록인 receiverUuids와 오류 원인을 알려주는 code, msg응답 코드에서 원인을 확인합니다.

나에게 보내기

Parameter
Name Type Description Required
templateId Int64 메시지 템플릿 도구에서 구성한 사용자 정의 템플릿의 ID O
templateArgs [String:String]? templateId로 지정한 템플릿에 사용자 인자(User argument)가 포함되어 있는 경우 대입할 값, key:value 형식으로 전달 X
Swift
RxSwift
let templateId = 12345

TalkApi.shared.sendCustomMemo(templateId: templateId, templateArgs: ["msg":"메세지 파라미터"]) {(error) in
    if let error = error {
        print(error)
    }
    else {
        print("success.")
    }
}
// Class member property
let disposeBag = DisposeBag()

let templateId = 12345

TalkApi.shared.rx.sendCustomMemo(templateId: templateId, templateArgs: ["msg":"메세지 파라미터"])
    .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
    .subscribe (onCompleted:{
        print("success.")        
    }, onError: {error in
        print(error)
    })
    .disposed(by: disposeBag)

친구에게 보내기

Parameter
Name Type Description Required
receiverUuids [String] 피커 또는 친구 목록 가져오기를 통해 얻은 사용자 uuid 값 목록, 최대 5개 O
templateId Int64 메시지 템플릿 도구에서 구성한 사용자 정의 템플릿의 ID O
templateArgs [String:String]? templateId로 지정한 템플릿에 사용자 인자(User argument)가 포함되어 있는 경우 대입할 값, key:value 형식으로 전달 X
Swift
RxSwift
let templateId = 12345

// 카카오톡 친구 목록 가져오기
TalkApi.shared.friends {(friends, error) in
    if let error = error {
        print(error)
    } else {
        print("friends() success.")
        guard let friends = friends else {
            print(error)
            return
        }
        
        //친구선택창 구현.
        ...
        
        //UI로 선택된 친구의 uuids
        let friendUuids = selectedIds as! [String]

        // 카카오톡 메시지 전송
        TalkApi.shared.sendCustomMessage(templateId:templateId, templateArgs:["title":"제목입니다.", "description":"설명입니다."], receiverUuids:friendUuids) { (messageSendResult, error) in
            if let error = error {
                print(error)
            } else {
                print("sendCustomMessage() success.")

                //do something
                _ = messageSendResult
            }
        }   
    }
}
// Class member property
let disposeBag = DisposeBag()

let templateId = 12345

// 카카오톡 친구 목록 가져오기
TalkApi.shared.rx.friends()
    .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
    .subscribe(onSuccess: { (friends) in
        print("friends() success.")
        
        //친구선택창 구현.
        ...
        
        //UI로 선택된 친구의 uuids
        let friendUuids = selectedIds as! [String]

        // 카카오톡 메시지 전송
        TalkApi.shared.rx.sendCustomMessage(templateId:templateId, templateArgs:["title":"제목입니다.", "description":"설명입니다."], receiverUuids:friendUuids)
            .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
            .subscribe(onSuccess:{ (messageSendResult) in
                print("sendCustomMessage() success.")
                
                //do something
                _ = messageSendResult

            }, onFailure: {error in
                print(error)
            })
            .disposed(by: disposeBag)                
            
    }, onFailure: {error in
        print(error)
    })
    .disposed(by: disposeBag)

기본 템플릿으로 스크랩 메시지 보내기

기본 정보

사전 설정 카카오 로그인 사용자 동의 권한 레퍼런스
플랫폼 등록
카카오 로그인 활성화
동의 항목
필요 필요:
카카오톡 메시지 전송(talk_message)
필요:
사용 권한
(친구에게 보내기)
공통
MessageSendResult
MessageFailureInfo
iOS SDK
sendScrapMemo()
sendScrapMessage()
ReactiveX iOS SDK
sendScrapMemo()
sendScrapMessage()

지정한 웹 페이지를 스크랩한 정보로 스크랩 메시지를 구성하고, 현재 로그인한 사용자의 카카오톡으로 메시지를 보냅니다. 메시지 전송 대상에 따라 호출해야 할 메서드가 다릅니다.

스크랩할 웹 페이지 URL을 requestUrl 파라미터로 전달해야 합니다. 스크랩할 웹 페이지의 도메인은 [내 애플리케이션] > [플랫폼] > [Web]에 등록돼 있어야 합니다.

친구에게 메시지를 보내려면 메시지 전송 요청 시 누구에게 메시지를 보낼 것인지 지정해야 합니다. 피커 또는 친구 목록 가져오기를 통해 메시지를 보낼 친구의 uuid 정보를 확인할 수 있습니다. 친구 목록을 만들어 사용자에게 보여주고, 사용자가 선택한 친구들의 uuid 목록은 receiverUuids 파라미터에 리스트(List)로 담아 전달합니다. 한 번에 최대 5명의 친구에게 메시지를 보낼 수 있습니다.

메시지 전송 결과는 MessageSendResult 객체로 받으며, 메시지 전송에 성공한 친구의 uuid를 담은 문자열(String) 리스트와 실패 결과를 담은 MessageFailureInfo 객체 리스트로 구성돼 있습니다.

전송 실패 시, MessageFailureInfo에 포함된 대상 친구의 목록인 receiverUuids와 오류 원인을 알려주는 code, msg응답 코드에서 원인을 확인합니다.

나에게 보내기

Parameter
Name Type Description Required
requestUrl String 스크랩할 웹 페이지 URL, [내 애플리케이션] > [플랫폼] > [Web]에 등록된 도메인만 사용 가능 O
Swift
RxSwift
let requestUrl = "https://developers.kakao.com"

TalkApi.shared.sendScrapMemo(requestUrl: requestUrl) {(error) in
    if let error = error {
        print(error)
    }
    else {
        print("success.")
    }
}
// Class member property
let disposeBag = DisposeBag()

TalkApi.shared.rx.sendScrapMemo(requestUrl: requestUrl)
    .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
    .subscribe (onCompleted:{        
        print("success.")        
    }, onError: {error in
        print(error)
    })
    .disposed(by: disposeBag)

친구에게 보내기

Parameter
Name Type Description Required
receiverUuids [String] 피커 또는 친구 목록 가져오기를 통해 얻은 사용자 uuid 값 목록, 최대 5개 O
requestUrl String 스크랩할 웹 페이지 URL, [내 애플리케이션] > [플랫폼] > [Web]에 등록된 도메인만 사용 가능 O
Swift
RxSwift
let requestUrl = "https://developers.kakao.com"

// 카카오톡 친구 목록 가져오기
TalkApi.shared.friends {(friends, error) in
    if let error = error {
        print(error)
    } else {
        print("friends() success.")
        guard let friends = friends else {
            print(error)
            return
        }
        
        //친구선택창 구현.
        ...
        
        //UI로 선택된 친구의 uuids
        let friendUuids = selectedIds as! [String]

        // 카카오톡 메시지 전송
        TalkApi.shared.sendScrapMessage(requestUrl:requestUrl, receiverUuids:friendUuids) { (messageSendResult, error) in
            if let error = error {
                print(error)
            }
            else {
                print("sendScrapMessage() success.")
                //do something
                _ = messageSendResult
            }
        }
    }
}
// Class member property
let disposeBag = DisposeBag()

let requestUrl = "https://developers.kakao.com"

TalkApi.shared.rx.friends()
    .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
    .subscribe(onSuccess: { (friends) in
        print("friends() success.")

        //친구선택창 구현.
        ...
        
        //UI로 선택된 친구의 uuids
        let friendUuids = selectedIds as! [String]

        TalkApi.shared.rx.sendScrapMessage(requestUrl:requestUrl, receiverUuids:friendUuids)
            .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
            .subscribe(onSuccess:{ (messageSendResult) in
                print("sendScrapMessage() success.")
                
                //do something
                _ = messageSendResult
                
            }, onFailure: {error in
                print(error)
            })
            .disposed(by: disposeBag)
        
    }, onFailure: {error in
        print(error)
    })
    .disposed(by: disposeBag)

사용자 정의 템플릿으로 스크랩 메시지 보내기

기본 정보

사전 설정 카카오 로그인 사용자 동의 권한 레퍼런스
플랫폼 등록
카카오 로그인 활성화
동의 항목
메시지 템플릿
필요 필요:
카카오톡 메시지 전송(talk_message)
필요:
사용 권한
(친구에게 보내기)
공통
MessageSendResult
MessageFailureInfo
iOS SDK
sendScrapMemo()
sendScrapMessage()
ReactiveX iOS SDK
sendScrapMemo()
sendScrapMessage()

[도구] > [메시지 템플릿]에서 직접 구성한 사용자 정의 템플릿에 지정한 웹 페이지의 스크랩 정보를 대입해 스크랩 메시지를 구성하고, 현재 로그인한 사용자의 카카오톡으로 메시지를 보냅니다. 메시지 전송 대상에 따라 호출해야 할 메서드가 다릅니다.

스크랩할 웹 페이지 URL을 requestUrl 파라미터로 전달해야 합니다. 스크랩할 웹 페이지의 도메인은 [내 애플리케이션] > [플랫폼] > [Web]에 등록돼 있어야 합니다.

사용자 정의 템플릿 ID를 templateId 파라미터로 전달해야 합니다. 메시지에 변동되는 정보를 포함하려면 해당 사용자 정의 템플릿에 사용자 인자를 추가한 후, templateArgs 파라미터를 통해 키와 값을 전달합니다. 사용자 정의 템플릿에 사용자 인자가 포함되었음에도 해당 파라미터를 사용하지 않을 경우, 사용자 인자로 지정된 부분이 ${KEY} 형식으로 메시지에 그대로 노출됩니다.

친구에게 메시지를 보내려면 메시지 전송 요청 시 누구에게 메시지를 보낼 것인지 지정해야 합니다. 피커 또는 친구 목록 가져오기를 통해 메시지를 보낼 친구의 uuid 정보를 확인할 수 있습니다. 친구 목록을 만들어 사용자에게 보여주고, 사용자가 선택한 친구들의 uuid 목록은 receiverUuids 파라미터에 리스트(List)로 담아 전달합니다. 한 번에 최대 5명의 친구에게 메시지를 보낼 수 있습니다.

메시지 전송 결과는 MessageSendResult 객체로 받으며, 메시지 전송에 성공한 친구의 uuid를 담은 문자열(String) 리스트와 실패 결과를 담은 MessageFailureInfo 객체 리스트로 구성돼 있습니다.

전송 실패 시, MessageFailureInfo에 포함된 대상 친구의 목록인 receiverUuids와 오류 원인을 알려주는 code, msg응답 코드에서 원인을 확인합니다.

나에게 보내기

Parameter
Name Type Description Required
requestUrl String 스크랩할 웹 페이지 URL, [내 애플리케이션] > [플랫폼] > [Web]에 등록된 도메인만 사용 가능 O
templateId Int64 스크랩한 정보를 반영할 사용자 정의 템플릿의 ID
스크랩 메시지 참고
O
templateArgs [String:String]? templateId로 지정한 템플릿에 사용자 인자(User argument)가 포함되어 있는 경우 대입할 값, key:value 형식으로 전달
스크랩 결과를 덮어쓰기(overwrite) 할 수는 없음
X
Swift
RxSwift
let requestUrl = "https://developers.kakao.com"
let templateId = 12345

TalkApi.shared.sendScrapMemo(requestUrl: requestUrl, templateId: templateId, templateArgs:["title":"제목입니다.", "description":"설명입니다."]) {(error) in
    if let error = error {
        print(error)
    }
    else {
        print("success.")
    }
}
// Class member property
let disposeBag = DisposeBag()

TalkApi.shared.rx.sendScrapMemo(requestUrl: requestUrl, templateId: templateId, templateArgs:["title":"제목입니다.", "description":"설명입니다."])
    .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
    .subscribe (onCompleted:{        
        print("success.")        
    }, onError: {error in
        print(error)
    })
    .disposed(by: disposeBag)

친구에게 보내기

Parameter
Name Type Description Required
receiverUuids [String] 피커 또는 친구 목록 가져오기를 통해 얻은 사용자 uuid 값 목록, 최대 5개 O
requestUrl String 스크랩할 웹 페이지 URL, [내 애플리케이션] > [플랫폼] > [Web]에 등록된 도메인만 사용 가능 O
templateId Int64 스크랩한 정보를 반영할 사용자 정의 템플릿의 ID
스크랩 메시지 참고
O
templateArgs [String:String]? templateId로 지정한 템플릿에 사용자 인자(User argument)가 포함되어 있는 경우 대입할 값, key:value 형식으로 전달
스크랩 결과를 덮어쓰기(overwrite) 할 수는 없음
X
Swift
RxSwift
let requestUrl = "https://developers.kakao.com"
let templateId = 12345

// 카카오톡 친구 목록 가져오기
TalkApi.shared.friends {(friends, error) in
    if let error = error {
        print(error)
    } else {
        print("friends() success.")
        guard let friends = friends else {
            print(error)
            return
        }
        
        //친구선택창 구현.
        ...
        
        //UI로 선택된 친구의 uuids
        let friendUuids = selectedIds as! [String]

        // 카카오톡 메시지 전송
        TalkApi.shared.sendScrapMessage(requestUrl:requestUrl, templateId:templateId, receiverUuids:friendUuids) { (messageSendResult, error) in
            if let error = error {
                print(error)
            }
            else {
                print("sendScrapMessage() success.")
                //do something
                _ = messageSendResult
            }
        }
    }
}
// Class member property
let disposeBag = DisposeBag()

let requestUrl = "https://developers.kakao.com"
let templateId = 12345

TalkApi.shared.rx.friends()
    .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
    .subscribe(onSuccess: { (friends) in
        print("friends() success.")

        //친구선택창 구현.
        ...
        
        //UI로 선택된 친구의 uuids
        let friendUuids = selectedIds as! [String]

        TalkApi.shared.rx.sendScrapMessage(requestUrl:requestUrl, templateId:templateId, receiverUuids:friendUuids)
            .retry(when: Auth.shared.rx.incrementalAuthorizationRequired())
            .subscribe(onSuccess:{ (messageSendResult) in
                print("sendScrapMessage() success.")
                
                //do something
                _ = messageSendResult
                
            }, onFailure: {error in
                print(error)
            })
            .disposed(by: disposeBag)
        
    }, onFailure: {error in
        print(error)
    })
    .disposed(by: disposeBag)

이미지 업로드하기

기본 정보

사전 설정 레퍼런스
플랫폼 등록 공통
ImageUploadResult
iOS SDK
imageUpload()
imageScrap()
ReactiveX iOS SDK
imageUpload()
imageScrap()

메시지에 넣을 이미지는 URL 형태로 메시지 템플릿 구성 시에 첨부하거나, 메시지 템플릿 도구에서 미리 업로드할 수 있습니다.

URL 형태로 이미지를 추가할 경우, ShareApiimageUpload() API를 사용하기 때문에 카카오톡 공유 모듈을 import한 후, 호출해야 합니다. 자세한 정보는 이미지 업로드하기에서 확인할 수 있습니다.

카카오톡 공유 모듈 변경

iOS SDK 2.11.0 버전부터 카카오톡 공유 모듈, 클라이언트, 모델, 메서드명이 변경되었습니다. 자세한 안내는 공지사항을 참고합니다.

Legacy

메시지 보내기의 Legacy Kakao SDK for iOS(이하 Legacy iOS SDK) 개발 가이드는 아래 바로가기에서 확인할 수 있습니다. 추후 Legacy iOS SDK에 대한 지원이 중단될 수 있으므로, 가급적 빠른 시일 내에 최신 버전 iOS SDK로 변경할 것을 권장합니다.

더보기