FriendTalk Message
    • PDF

    FriendTalk Message

    • PDF

    기사 요약

    Classic/VPC 환경에서 이용 가능합니다.

    FriendTalk Message에서는 친구톡 메시지를 발송하는 방법과 친구톡 메시지 발송 이력을 조회하는 방법을 설명합니다.

    참고

    Biz Message > FriendTalk Message 메뉴에서 제공하는 기능을 사용하려면 Biz Message를 사용하도록 설정된 프로젝트가 있어야 합니다. 프로젝트를 생성하려면 프로젝트 생성을, 생성한 프로젝트의 설정을 수정하려면 프로젝트 수정을 참조해 주십시오.

    친구톡 메시지 발송

    친구톡 메시지는 OPEN API를 통해서만 발송할 수 있습니다. Simple & Easy Notification Service API 가이드의 친구톡 API를 참조해 주십시오.

    참고
    • 친구톡 메시지는 플러스 친구와 친구를 맺은 사용자를 대상으로 발송할 수 있는 메시지입니다. 친구 여부에 관계없이 메시지를 발송하려면 AlimTalk Message를 참조해 주십시오.
    • 친구톡 메시지는 야간(당일 20:00 ~ 다음 날 08:00까지)에는 발송이 제한됩니다.

    친구톡 메시지 발송 이력 조회

    친구톡 메시지 발송 이력을 조회하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
    2. Services > Application Services > Simple & Easy Notification Service 메뉴를 차례대로 클릭해 주십시오.
    3. Biz Message > FriendTalk Message 메뉴를 차례대로 클릭해 주십시오.
    4. 발송 이력을 조회할 프로젝트와 카카오톡 채널을 선택해 주십시오.
      • 선택한 프로젝트와 카카오톡 채널을 통해 발송된 친구톡 메시지 이력이 표시됩니다.
      • 필요한 경우, 기간을 설정하거나 필터를 통해 발송 이력을 필터링하여 조회할 수 있습니다.
      • 요청상태: 메시지 발송 서버로의 발송 요청에 대한 상태
        • 성공: 요청을 성공한 상태
        • 실패: 요청을 실패한 상태
      • 수신상태: 메시지 발송 서버에서의 발송 처리에 대한 상태
        • 성공: 발송을 성공한 상태
        • 처리중: 발송을 처리하고 있는 상태
        • 실패: 발송을 실패한 상태
      • SMS 대체발송 상태: SMS 대체 발송 요청 상태
      • 요청 ID: OPEN API를 통해 개별 결과를 조회할 수 있는 ID로, 수신자 1명당 1개씩 발급
      • [결과 전문 보기] 버튼을 클릭하여 발송 요청에 대한 결과 데이터를 JSON 형식으로 확인할 수 있습니다.
        • 발송 결과 데이터에 대한 자세한 설명은 친구톡 API를 참조해 주십시오.

    메시지 이력 Export

    친구톡 메시지 이력을 Object Storage에 내보낼 수 있습니다.

    참고
    • 한국 리전의 Object Storage로 내보내기만 가능하며, 요금이 별도로 부과됩니다.
    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
    2. Services > Application Services > Simple & Easy Notification Service 메뉴를 차례대로 클릭해 주십시오.
    3. Biz Message > FriendTalk Message 메뉴를 차례대로 클릭해 주십시오.
    4. 메시지 이력을 Export할 프로젝트를 선택한 후 [Export 요청] 버튼을 클릭해 주십시오.
      • Export 요청 팝업 창이 나타납니다.
    5. 내보내기 정보 입력한 후 [파일 생성 요청] 버튼을 클릭해 주십시오.
      • 전송 데이터 형식은 JSON과 CSV 중 선택할 수 있습니다.
      • 파일명을 입력해 주십시오.
      • 대상 Bucket을 선택해 주십시오.
        • 생성된 버킷이 없는 경우 [Bucket 생성하기] 버튼이 표시되며, 클릭하여 Bucket을 생성할 수 있습니다.(버킷 생성 참고)
      • Export 요청 결과는 [Export 목록] 에서 확인할 수 있습니다.

    FriendTalk 이용 한도 설정

    FriendTalk 이용 한도를 설정하는 방법은 다음과 같습니다.

    1. 네이버 클라우드 플랫폼 콘솔의 Region 메뉴와 Platform 메뉴에서 이용 중인 환경을 클릭해 주십시오.
    2. Services > Application Services > Simple & Easy Notification Service 메뉴를 차례대로 클릭해 주십시오.
    3. Biz Message > FriendTalk Message 메뉴를 차례대로 클릭해 주십시오.
    4. 이용 한도를 설정할 프로젝트를 선택한 후 [이용 한도 설정] 버튼을 클릭해 주십시오.
    5. 이용 한도를 설정한 후 [저장] 버튼을 클릭해 주십시오.
      • FriendTalk 이용 한도는 최대 월 30,000건으로 제한됩니다.
      • 월 발송 건보다 많은 FriendTalk 발송이 필요한 경우 고객 지원으로 문의해 주십시오.
    참고
    • 친구톡은 텍스트형, 이미지형, 와이드형을 포함한 세부 타입을 통합하여 차단됩니다.
    • 카카오톡 비즈메시지는 발송 건당 과금이 발생되는 서비스로 메세지 타입(알림톡, 친구톡 [텍스트형, 이미지형, 와이드형])별 요금이 상이합니다.

    링크 유효성 검증 단계

    2024년 4월 29일부로 메시지 내 링크 오류 현상 방지하기 위해 서비스 원천사인 카카오톡에서 '버튼-바로 연결 영역' 링크의 유효성 검증 단계가 적용됩니다.

    링크 유효성 검증이란 고객에게 발송되는 알림톡의 '버튼' 중 정상적인 링크 연결이 불가한 케이스를 사전에 점검하는 과정입니다. 수신자가 알림톡 수신 후 버튼을 클릭했을 때 정상적으로 링크가 열리지 않는 현상을 방지하기 위해 진행하는 작업이며 연동되는 페이지의 적합성을 판단하는 것이 아닙니다.

    주의

    링크 유효성 검증 적용일부터는 링크가 잘못 입력되었거나 치환되어 페이지를 열 수 없는 경우, 기존에 성공한 메시지이더라도 요청 중 실패 처리될 수 있습니다.

    링크 실패 유형

    링크의 유효성 점검 시 참고할 수 있는 유형별 예시는 다음과 같습니다.

    항목예시
    변수 치환이 되지 않은 경우https://#{변수}
    변수 치환이 정상적으로 이루어지지 않은 경우https://{변수}
    https://www.naver.com{변수}
    https://https://www.naver.com
    https://customscheme://customaction
    패스 시작 문자가 누락 또는 인코딩 되었음https://search.naver.comsearch?q=test
    https://search.naver.com%2Fsearch%3Fq%3Dtest
    도메인 부분이 누락 되었거나 유효하지 않음https://20231016-000001
    https://상품명
    https://?q=test
    https://.naver.com
    localhosthttp://localhost:8080
    스킴과 도메인(authority) 사이 구분 문자 오류https:////www.naver.com
    https:// www.naver.com
    존재하지 않는 TLDhttps://www.naver.c
    https://www.naver.comm

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.