1단계는 [내 애플리케이션] > [비즈니스] > [사업자 정보 등록]에서 비즈 앱 전환 후, [내 애플리케이션] > [앱 설정] > [앱 권한 신청]에서 설정합니다. 자세한 내용은 비즈 앱 전환, 카카오톡 채널 연결을 참고합니다.

2단계는 카카오비즈니스의 [서비스/도구] > [비즈도구] > [비즈플러그인]에서 설정합니다.

아직 등록한 플러그인이 없는 경우 아래와 같은 화면이 나타나며, [비즈플러그인 등록하기]를 클릭해 새로운 플러그인을 등록하는 과정을 시작할 수 있습니다.

이미 등록된 플러그인이 있는 경우, 등록된 플러그인 목록이 나타납니다. [플러그인 등록]을 클릭하여 새로운 플러그인을 등록할 수 있습니다.

[비즈플러그인 등록하기] 또는 [플러그인 등록]을 클릭하면 아래와 같은 비즈 앱 목록이 나타납니다. 플러그인을 등록할 비즈 앱을 선택하고 [다음]을 클릭합니다.

[플러그인 목적 선택] 화면에서 [카카오싱크]를 선택하고 [다음]을 클릭합니다.

마지막으로 플러그인 이름을 입력하고 [등록]을 클릭합니다.

이후 카카오비즈니스의 [서비스/도구] > [비즈도구] > [비즈플러그인]에서 등록한 싱크 플러그인의 ID와 상세 정보를 확인하고 수정할 수 있습니다.

싱크 플러그인의 로그인을 시작하는 단계는 챗봇의 인증 블록이 수행합니다. 앱 설정에서 안내된 싱크 플러그인 redirect_uri및 인증 블록 설정을 완료하였고, 챗봇 관리자센터 도움말을 참고해 인증 블록 설정을 완료했다면 로그인을 시작하는 단계에서는 별도 개발이 필요하지 않습니다.

싱크 플러그인을 통한 카카오 로그인의 동작은 다음과 같이 진행됩니다.

1. 사용자가 카카오톡 채널 채팅방에서 인증 블록을 통해 카카오싱크 플러그인을 통한 카카오 로그인을 요청합니다.
2. 사용자가 채팅방에 나타나는 카카오 동의 화면의 내용에 동의합니다.
3. 카카오 API에서 사용자 인증을 위한 code 값과 함께 Redirect Continue URL을 서비스의 카카오싱크 플러그인 전용 Redirect URI로 리다이렉트(Redirect)합니다.
4. 서비스에서 로그인 Redirect URI로 전달된 code와 continue 파라미터 값을 전달 받습니다.
5. 서비스에서 전달받은 code 값으로 액세스 토큰(Access Token)을 요청합니다.
6. 서비스에서 전달받은 액세스 토큰을 사용하여 사용자 정보를 요청합니다.
7. 서비스에서 전달받은 액세스 토큰을 사용하여 사용자의 서비스 약관 동의 내역을 확인합니다.
8. 서비스에서 해당 카카오계정 사용자 정보로 서비스 회원 가입 처리를 하거나, 정보 식별 결과 기존 회원이라면 카카오 로그인으로도 기존 정보로 서비스를 이용할 수 있도록 서비스 회원 연동 처리를 합니다.
9. 서비스에서 사용자 등록을 완료한 후, Redirect URI로 전달된 continue의 값인 Redirect Continue URL로 302 리다이렉트합니다.
10. 카카오에서 서비스의 응답을 전달 받아 싱크 플러그인을 통한 로그인을 완료 처리합니다.

사용자가 카카오톡 채널 챗봇에게 싱크 플러그인 인증 블록을 통해 로그인 및 가입을 요청하면, 카카오톡의 인증 정보를 토대로 인가 코드가 발급되며, 이어 채팅방 안에서 카카오싱크 동의화면이 화면 하단 하프뷰로 열립니다. 사용자는 이를 통해 서비슷 약관, 제3자 정보제공에 동의하고 로그인을 요청할 수 있습니다.

싱크 플러그인을 통한 로그인은 카카오톡 안에서 이뤄지기 때문에, 카카오톡에 로그인된 카카오계정 인증 정보를 사용합니다. 따라서 사용자가 카카오계정 정보를 추가로 입력하거나, 다른 웹 브라우저나 서비스 앱으로 이동하지 않아 채팅방으로부터 이탈하지 않습니다.

사용자가 서비스 약관과 정보 제공에 동의하면 카카오톡은 카카오 인증 서버에 인가 코드 발급을 요청합니다. 카카오톡은 응답으로 받은 인가 코드와 Redirect Continue URL 값을 서비스 서버의 싱크 플러그인 redirect_uri로 전달합니다. 이때 앞서 [내 애플리케이션] > [카카오 로그인] > [간편가입] 메뉴에서 등록해 둔 redirect_uri 값이 사용됩니다.

다음은 카카오톡이 서비스 서버에 continue 파라미터 값으로 전달하는 Redirect Continue URL의 상세 정보입니다. Redirect Continue URL에 필요한 쿼리 파라미터와 값이 모두 포함되어 있으므로, 서비스에서는 continue 값의 URL로 302 리다이렉트 처리를 하여 싱크 플러그인을 통한 로그인 요청을 완료할 수 있습니다.

기본 정보

요청

쿼리 파라미터

서비스 서버는 STEP 1.의 과정을 통해 카카오톡으로부터 인가 코드와 Redirect Continue URL을 전달 받았습니다. 전달받은 인가 코드로 토큰 받기를 요청해 로그인을 완료하고 토큰 값을 획득해야 합니다.

서비스 서버는 발급 받은 토큰을 사용해 사용자 정보 가져오기를 요청하여 로그인 및 가입에 필요한 사용자 정보들을 받습니다. 또한 서비스 약관 동의 내역 확인하기 요청을 통해 사용자가 동의한 서비스 약관 내역을 확인합니다. 이를 통해 회원 가입에 필요한 사용자 정보를 얻어 회원 가입 처리를 하거나, 대화를 이어가는 데 필요한 사용자 정보를 받습니다.

사용자 정보 및 서비스 약관 확인 시 사용자가 신규 회원이라 가입 처리가 필요하다면, 받은 사용자 정보를 토대로 가입 처리를 합니다. 사용자 정보를 회원 데이터베이스(DB)와 대조했을 때 기존 회원이면서 처음 카카오 로그인을 통해 로그인한 경우라면 서비스 회원 연동을 참고해 회원 정보 맵핑(Mapping)합니다.

만약 사용자 정보 가져오기 응답만으로 회원 가입 처리가 불가능하고 사용자로부터 추가 정보를 입력 받아야 한다면 다음 단계인 STEP 3. 사용자 정보 추가 입력 받기로 넘어갑니다.

추가 정보 입력 없이 로그인 및 가입 처리를 완료했다면, 카카오로부터 전달받은 Redirect Continue URL로 302 리다이렉트하여 로그인 완료 처리를 요청합니다. 리다이렉트 후 카카오 API 서버는 카카오톡 채널 챗봇 채팅방에 로그인 및 가입 처리가 완료되었음을 알려줘 싱크 플러그인을 통한 로그인 및 가입 과정을 완료합니다.

서비스 회원 가입 또는 회원 정보 맵핑 시 사용자 정보 가져오기 응답에 포함된 정보 외에 추가 입력이 필요한 항목이 있는 경우에는, 로그인 완료 처리 전 추가 작업이 필요합니다. 사용자 정보 추가 입력 시의 싱크 플러그인 로그인 절차는 다음과 같습니다.

1. ➊~➐까지의 흐름은 기본적인 카카오싱크 플러그인 로그인 과정과 동일합니다. 하지만 ➑ 회원 등록 단계에서 서비스에서 싱크 플러그인을 통해 카카오계정으로 가입하려는 사용자를 내부 시스템에 자동 등록하지 못하는 경우가 발생하는 경우에는 다음 순서와 같이 처리합니다.
2. 서비스에서 전달받은 Redirect Continue URL에 추가 맵핑을 위한 URL Query Parameter를 다음과 같이 추가하여 302 리다이렉트합니다.
   • user_match_url: 추가 맵핑을 위한 서비스의 웹 페이지 주소
   • complete: 가입 완료 여부, 가입이 완료되지 않았으므로 false로 전달
   • 참고: Redirect Continue URL 상세
3. 카카오에서 서비스의 응답을 전달 받아 자동 가입 실패 처리를 합니다.
4. 서비스로부터 전달받은 추가 맵핑 웹 페이지를 Redirect Continue URL 파라미터와 함께 호출합니다.
5. 사용자가 채팅방 내 웹뷰에서 회원 가입 및 정보 맵핑을 위한 추가 정보를 입력합니다.
6. 서비스에서 카카오계정 정보와 추가 정보로 회원 가입 또는 서비스 회원 연동 처리를 합니다.
7. 서비스에서 사용자 등록을 완료한 후, 앞서 4단계에서 전달받은 Redirect Continue URL로 302 리다이렉트합니다.
8. 카카오에서 서비스의 응답을 전달 받아 카카오싱크 플러그인을 통한 로그인을 완료합니다.

사용자로부터 추가 정보를 입력 받는 웹 페이지를 카카오톡 인앱브라우저에서 띄울 수 있도록, 앞서 카카오로부터 전달받은 Redirect Continue URL에 파라미터를 추가해 함께 302 리다이렉트합니다.

이때 추가해야 할 파라미터는 user_match_url, complete입니다. user_match_url은 사용자 정보를 추가 입력 받을 서비스의 웹 페이지의 주소로써, 카카오톡이 해당 웹 페이지를 채팅방에서 인앱브라우저로 띄웁니다.

사용자 정보 추가 입력을 받아 서비스 가입 또는 회원 정보 맵핑 처리를 끝내면, 서비스 서버는 다시 Redirect Continue URL에 complete 파라미터를 true로 추가하고 302 리다이렉트합니다. 리다이렉트 후 카카오 API 서버는 카카오톡 채널 챗봇 채팅방에 로그인 및 가입 처리가 완료되었음을 알려줘 싱크 플러그인을 통한 로그인 및 가입 과정을 완료합니다.