[공지] 카카오톡 채널 관련 변경사항 안내 / [Change Notice] Kakao Talk Channel

Notice / 공지
1

안녕하세요. 카카오입니다.

카카오톡 채널 관계 확인하기 API의 요청 URL과 더불어 카카오톡 채널과 관련한 파라미터명에 변경 사항이 있어 알려 드립니다.


대상

  • 카카오톡 채널 관계 확인하기 API
  • 카카오톡 채널 관계 알림(callback)

적용 일자

  • 2021년 5월 24일

변경 사항

  • 카카오톡 채널 관계 확인하기 API
변경 전 변경 후
url /v1/api/talk/plusfriends /v1/api/talk/channels
요청 파라미터 plus_friend_public_id channel_public_id
응답 필드 plus_friends
- plus_friend_public_id
- plus_friend_uuid 		channels
- channel_public_id
- channel_uuid
  • 카카오톡 채널 관계 알림(callback)
    • 카카오톡 채널 정보를 나타내는 기존 파라미터( plus_friend_public_id , plus_friend_uuid ) 와 더불어 channel_public_id 와 channel_uuid 를 추가적으로 제공
curl -X POST "https://example.com"  \
  -H "Authorization: KakaoAK {APP_ADMIN_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
        "event":"added",
        "id":"1111",
        "id_type":"app_user_id",
        "channel_public_id":"_FLX", // 추가
        "channel_uuid":"@ad",   // 추가
        "plus_friend_public_id":"_FLX", // deprecated
        "plus_friend_uuid":"@ad", // deprecated
        "updated_at":"2020-01-01T00:00:00Z"
    }'

필요한 사항

기존 API(plusfriends)는 추후 제공되지 않을 수 있으므로, 신규 API(channels)를 사용할 것을 권장합니다.

  • REST API:
    • 카카오톡 채널 관계 확인하기 API의 요청 URL를 /v1/api/talk/channels로 변경
  • JavaScript SDK:
    • Kakao.API.request 함수를 사용한 카카오톡 채널 관계 확인하기 API의 url 속성 값을 /v1/api/talk/channels로 변경

참고 문서


위 변경 사항에 대해 궁금하신 점은 데브톡으로 문의해 주시기 바랍니다.

언제나 더 좋은 서비스를 제공하기 위해 최선을 다 하겠습니다.

감사합니다.

======


Hello. This is Kakao.

We inform you of the change in the URL the Checking Kakao Talk Channel relationship API and some names of the parameters related to Kakao Talk Channel.


Target

  • Checking Kakao Talk Channel relationship API
  • Kakao Talk Channel callback

Effective date

  • May 24, 2021

Changes

  • Checking Kakao Talk Channel relationship API
Before change After change
URL /v1/api/talk/plusfriends /v1/api/talk/channels
Request parameters plus_friend_public_id channel_public_id
Response fields plus_friends
- plus_friend_public_id
- plus_friend_uuid 		channels
- channel_public_id
- channel_uuid

  • Kakao Talk Channel callback

    • Provides channel_public_id and channel_uuid along with plus_friend_public_id and plus_friend_uuid that indicate Kakao Talk Channel information.
curl -X POST "https://example.com"  \
  -H "Authorization: KakaoAK {APP_ADMIN_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
        "event":"added",
        "id":"1111",
        "id_type":"app_user_id",
        "channel_public_id":"_FLX", // New parameter
        "channel_uuid":"@ad",   // New parameter
        "plus_friend_public_id":"_FLX", // Old parameter(deprecated)
        "plus_friend_uuid":"@ad", // Old parameter(deprecated)
        "updated_at":"2020-01-01T00:00:00Z"
    }'

What to do

We highly recommend using the new API (channels) since the legacy API (plusfriends) may be deprecated after a certain period of time.

  • REST API:
    • Change the URL of the Checking Kakao Talk Channel relationship API to /v1/api/talk/channels.
  • JavaScript SDK:
    • Change the attribute of the URL to /v1/api/talk/channels in the Kakao.API.request function used to call the Checking Kakao Talk Channel relationship API.

Reference


If you have any further question about the changes above, contact us at DevTalk.

We always do our best to provide a better service.

Thank you.