이 문서에는 Messenger 플랫폼 최신 버전의 변경 사항이 나와 있습니다. Messenger 플랫폼은 그래프 API 버전 관리를 따릅니다.
최신 버전: v21.0
response_feedback
Webhooks새로운 response_feedback
Webhooks 이벤트는 사용자가 '좋아요'/'싫어요'/'응답 품질 좋음'/'응답 품질 좋지 않음' 버튼 중 하나를 클릭하여 비즈니스가 보낸 메시지에 피드백을 제공하면 알림을 보냅니다. Webhooks에 대한 자세한 내용은 여기를 참조하세요.
이제 앱은 텍스트, 링크, 공감 및 스티커를 포함하는 메시지에 대해 Instagram 프로페셔널 계정별로 초당 300회(100회에서 증가됨)의 호출을 보낼 수 있습니다. 자세히 알아보세요.
graph.instagram.com
입니다.instagram_business_basic
instagram_business_content_publishing
instagram_business_manage_comments
instagram_business_manage_messages
Instagram 로그인을 통한 새로운 Instagram API가 적합한지 알아보려면 마이그레이션 가이드를 참조하세요.
버그 수정 사항 및 새로운 기능을 포함한 변경 사항은 Instagram 플랫폼 변경 사항을 모니터링하세요.
이제 메시지 Webhooks에서 ig_reel
첨부 파일 유형이 지원됩니다. IG 릴스 첨부 파일은 ig_reel
유형으로 분류되고 첨부 파일 페이로드에는 릴스 제목, URL, 동영상 ID가 포함됩니다.
이제 메시지 Webhooks에서 ig_reel
및 reel
첨부 파일 유형이 지원됩니다. IG 릴스 첨부 파일은 ig_reel
유형으로 분류되고 첨부 파일 페이로드에는 릴스 제목, URL, 동영상 ID가 포함됩니다. FB 릴스 첨부 파일은 reel
유형으로 분류되고 첨부 파일 페이로드에는 릴스 제목, URL, 동영상 ID가 포함됩니다.
이제 Messenger 전환 라우팅을 사용하는 비즈니스는 각 앱 수준에서 스레드 관리 권한을 구성할 수 있습니다. 기본 앱과 연결된 원래의 스레드 관리 권한 구성은 사용 중단되고 모든 값이 마이그레이션됩니다. 자세한 내용은 여기를 참조하세요.
모든 버전에 적용됩니다.
사용자가 홍보된 Instagram 게시물 또는 Instagram 광고 게시물에 댓글을 남기면, ad_id
와 ad_title
외에도 original_media_id
가 comments
필드의 value
개체의 media
개체에 반환됩니다. 자세한 내용은 Instagram 설정을 참조하세요.
message_edits
Webhooks 이벤트새로운 message_edits
Webhooks 이벤트는 사용자가 이전에 보낸 메시지를 수정하면 알림을 보냅니다. 이 Webhooks 이벤트에 대한 자세한 내용은 여기를 참조하세요.
이제 '릴스'는 Messenger 대화에 전송된 메시지 Webhooks에 지원되는 첨부 파일 유형이 됩니다. 릴스 첨부 파일은 reel
유형으로 분류되고 첨부 파일 페이로드에는 릴스 제목, URL, 동영상 ID가 포함됩니다.
명령어는 사용자가 Messenger 경험 내에서 특정 작업을 수행하기 위해 언제든 호출할 수 있는 탭 가능한 키워드입니다. 명령어는 명령어 자체와 힌트로 구성되는데, 사용자는 힌트를 통해 명령어의 기능을 알 수 있습니다. 예를 들어 사용자가 '12월 마지막 주에 멕시코로 향하는 항공편과 호텔을 예약하도록 도와줘'라고 입력하면 여행 비즈니스에서 구성한 항공편 및 호텔 명령어를 호출하게 됩니다. 자세한 내용은 여기를 참조하세요.
명령어 메뉴는 명령어를 설정할 때 자동으로 표시되는 새로운 메뉴입니다. Messenger 경험에 고정 메뉴를 설정한 경우 명령어 메뉴가 이를 대신합니다. 자세한 내용은 여기를 참조하세요.
이제 사용자가 Messenger의 비즈니스 프로필 페이지에서 메시지 경험을 공유할 수 있습니다. 이는 Messenger 경험을 입소문을 통해 발견하게 하는 데 도움이 됩니다. 자세한 내용은 여기를 참조하세요.
Messenger 경험에 명령어를 구성하고 나면 비즈니스 프로필에 명령어가 표시됩니다. 사용자는 상단에 있는 페이지 이름을 눌러서 비즈니스 프로필로 이동하고 Messenger 경험에서 제공하는 명령어에 대해 알아볼 수 있습니다.
환영 화면에는 메시지 경험에서 지원하는 명령어의 리스트가 나와 있어서 사용자가 Messenger 경험에서 수행할 수 있는 작업을 쉽게 이해할 수 있습니다. 자세한 내용은 여기를 참조하세요.
자신의 페이지에서 메시지를 주고받기 위한 앱을 개발하는 경우, 앱 검수를 거칠 필요가 없습니다. 단, 사용자 프로필 정보를 가져오려는 경우 사용자 프로필 API에 액세스하는 데 필요한 권한을 얻기 위해 앱 검수를 거쳐야 합니다.
이제 Instagram에 대화 라우팅이 제공됩니다. 대화 라우팅을 사용하면 Meta에서 비즈니스와 고객 또는 비즈니스와 잠재 고객 사이의 대화를 대화에 답하도록 지정한 앱으로 전달할 수 있습니다. 이 라우팅을 통해 비즈니스는 사용자와 풍성한 대화를 나누고 Meta 서버에 대한 API 호출을 최소화할 수 있습니다.
맞춤 레이블 API와 페르소나 API 액세스 권한이 유럽에서 운영하는 비즈니스와 전 세계 비즈니스와 연결되는 유럽 및 일본 사용자에 대해 복원되었습니다.
이제 비즈니스와 대행사가 JSON 코드 조각을 사용하지 않고도 손쉽게 Messenger 및 Instagram Direct 연결 광고를 파트너 앱에서 만든 환영 메시지와 연결할 수 있습니다. 이 환영 메시지는 Messenger 연결 광고와 Instagram Direct 연결 광고를 만들 때 광고 관리자에서 드롭다운으로 표시됩니다. 자세한 내용은 여기를 참조하세요.
이제 비공개 답장을 Facebook 릴스의 댓글에 사용할 수 있습니다.
그룹에 대한 비공개 답장이 업데이트되어, from
필드를 통해 댓글 작성자 정보를 지원하고 parent_id
를 통해 상위 컨텍스트를 지원하는 새로운 필드가 group_feed
Webhooks에 도입되었습니다. 이러한 새로운 필드를 처리하려면 Webhooks 서버를 업데이트해야 할 수 있습니다.
비즈니스는 잠재 고객 확보, 제품에 대한 마케팅 제안 또는 고객 지원 문의 등 고객과의 다양한 대화에 여러 타사 메시지 제공업체를 사용할 수 있습니다. 대화 라우팅을 사용하면 특정 시간에 고객 대화를 관리할 파트너를 정의하여 고객이 필요한 정보를 얻도록 할 수 있습니다. 페이지 설정에서 메시지 라우팅 규칙을 만들고 관리할 수 있습니다.
버튼 템플릿은 최대 3개의 버튼을 첨부하여 문자 메시지를 보냅니다. 이 템플릿은 메시지를 받는 사람이 선택할 수 있는 옵션(예: 질문에 대해 미리 설정된 답변, 취할 수 있는 조치)을 제공하는 데 유용합니다. 지원되는 버튼 유형은 postback
및 web_url
입니다.
비즈니스는 잠재 고객 확보, 제품에 대한 마케팅 제안 또는 고객 지원 문의 등 고객과의 다양한 대화에 여러 타사 메시지 제공업체를 사용할 수 있습니다. 대화 라우팅을 사용하면 특정 시간에 고객 대화를 관리할 파트너를 정의하여 고객이 필요한 정보를 얻도록 할 수 있습니다. 페이지 설정에서 메시지 라우팅 규칙을 만들고 관리할 수 있습니다.
버튼 템플릿은 최대 3개의 버튼을 첨부하여 문자 메시지를 보냅니다. 이 템플릿은 메시지를 받는 사람이 선택할 수 있는 옵션(예: 질문에 대해 미리 설정된 답변, 취할 수 있는 조치)을 제공하는 데 유용합니다. 지원되는 버튼 유형은 postback
및 web_url
입니다.
이제 Instagram 메시지가 비즈니스 또는 크리에이터를 위한 모든 Instagram 프로페셔널 계정에서 제공됩니다.
이제 자신의 비즈니스에 관심이 있는 고객이나 사용자가 해당 비즈니스에 전화를 걸도록 유도하는 통화 프롬프트를 추가할 수 있습니다.
이제 자신의 비즈니스에 관심이 있는 고객이나 사용자가 마케팅 메시지를 수신하는 데 옵트인하도록 요청할 수 있는 구독 연결 플로를 포함하여 광고를 만들 수 있습니다.
이제 Instagram Direct와 Messenger에서 멀티 앱 라우팅을 사용할 수 있습니다.
Messenger 플랫폼용 정기 알림
정기 알림 옵트인 요청에 대한 title
속성은 더 이상 필수가 아닙니다. title
을 설정하지 않으면 기본값은 '업데이트 및 프로모션'으로 지정됩니다. 이 변경 사항은 Facebook 페이지 또는 Instagram 프로페셔널 계정에서 전송한 옵트인 요청에 적용됩니다.
Messenger 플랫폼용 정기 알림
정기 알림 옵트인 요청의 notification_messages_frequency
속성은 사용 중단되며 더 이상 GET
요청이나 Webhooks 알림에서 반환되지 않습니다. 그러나 2023년 2월 2일 전에 주간 또는 월간 정기 알림에 대해 생성된 알림 메시지 토큰은 지원되고 Webhooks 알림에서 notification_message_frequency
가 반환됩니다.
이제 정기 알림 수신을 옵트인한 사람에게 후속 메시지를 3개까지 보낼 수 있습니다. 모든 3개의 후속 메시지는 첫 번째 후속 메시지를 보내고 나서 2분 이내에 전송해야 합니다.
이제 Instagram 메시지에 GET /PAGE-ID/notification_message_tokens
엔드포인트를 사용할 수 있습니다.
이제 알림 메시지 토큰 엔드포인트의 next_eligible_time
속성을 사용할 수 있습니다. 이 필드는 해당 알림 메시지 토큰을 사용하여 다음번 정기 알림을 보낼 수 있는 시간을 반환합니다.
Messenger API for Instagram
이제 Messenger API for Instagram을 사용하여 Instagram 프로페셔널 계정에서 전송된 메시지에 GIF를 포함하여 전송할 수 있습니다.
이제 첨부 파일 업로드 API가 Instagram 프로페셔널 계정에서 전송한 메시지에 대해 미디어 업로드를 지원합니다.
이제 Instagram 대화로 연결(CTD)되는 광고에 대한 리퍼럴 정보가 메시지 Webhooks 알림에서 반환됩니다.
2023년 3월 31일부터 더 이상 Messenger 분석 대시보드에서 CVS 파일을 다운로드할 수 없습니다. 이런 인사이트를 얻는 방법에 대해 알아보려면 메시지 인사이트 API를 참조하세요.
Instagram용 비즈니스 로그인을 사용하면 모달 팝업과 간소화된 단계를 통해 API 액세스에 대해 계정을 구성해야 하는 Instagram 사용자를 더욱 손쉽게 온보딩할 수 있습니다.
다음을 통해 Messenger의 잠재 고객 확보 광고에 대한 후속 조치를 더 쉽게 수행할 수 있도록 개선했습니다.
메시지 이벤트 API는 lead_submitted
이벤트를 지원합니다. 비즈니스는 이 이벤트를 사용하여 Messenger 연결 광고에서 잠재 고객 제출을 보고할 수 있습니다. 이 새로운 메시지 이벤트는 오픈 베타로 출시됩니다. 광고 관리자에서의 보고 기능도 곧 출시됩니다.
이제 Instagram 메시지에서 고정 메뉴를 사용할 수 있습니다.
이제 Instagram 메시지가 Instagram Live 스토리 및 광고 게시물의 댓글에 비공개 답장을 지원합니다. 이러한 새로운 필드를 처리하려면 Webhooks 서버를 업데이트해야 할 수 있습니다.
이제 GET /PAGE-ID/notification_message_tokens
엔드포인트를 사용하여 모든 유효한 알림 메시지 토큰의 리스트를 가져올 수 있습니다.
앱 ID는 더 이상 알림 메시지 토큰과 연결되지 않습니다. 이제 페이지에 연결된 모든 앱은 사용자가 정기 알림 수신을 옵트인할 때 옵트인 Webhooks 알림을 받게 됩니다.
다음 메시지 첨부 파일 페이로드 필드가 추가되었습니다.
image_aspect_ratio
– 옵트인 요청에 대해 이미지를 가로 또는 정사각 가로세로비로 설정elements
– 옵트인 요청에 대해 이미지 슬라이드 생성notification_message_tokens
– 현재 알림 메시지 토큰의 리스트 가져오기 notification_messages_cta_text
– 옵트인 요청에 대한 행동 유도 텍스트 맞춤 설정정기 알림에 대해 옵트인을 받는 방법이 다음과 같이 추가되었습니다.
title
필드가 정기 알림 Webhooks 알림에 추가되었습니다.
이제 Instagram 릴스의 댓글에 비공개 답장을 사용할 수 있습니다.
이제 Meta 서버에 업로드되었거나 자신의 서버에서 전송한 오디오와 동영상을 포함하여 Instagram 메시지를 전송할 수 있습니다.
사용자 프로필 API는 그래프 API v14.0 이상에서 고객의 Instagram 사용자 이름 필드 검색을 지원합니다.
정기 알림은 Messenger API의 중요한 업데이트이며, 이를 통해 비즈니스에서 재참여를 유도하는 자동 메시지를 사전에 전송할 수 있습니다. 정기 알림은 비즈니스가 고객 여정의 모든 단계에서 맞춤형 고객 중심 메시지를 전송하는 데 도움을 줍니다.
Messenger API for Instagram의 정기 알림Messenger API for Instagram의 정기 알림이 베타로 출시됩니다. 개발자께서는 7월 전에 베타 관심사 리스트에 등록할 수 있습니다.
Instagram 보내기 API 사용 제한 상향각 Instagram 프로페셔널 계정의 보내기 API 사용 제한을 초당 API 호출 100회로 상향했습니다.
ig.me 리퍼럴 매개변수비즈니스는 웹사이트, 이메일, 제품 패키징에 ig.me 링크를 추가하여 사용자가 Instagram에서 비즈니스와 대화를 쉽게 시작할 수 있도록 도울 수 있습니다. Facebook에서는 브랜드가 리퍼럴 매개변수를 ig.me 링크에 추가하여 맞춤형 메시지 경험을 만들 수 있는 기능을 추가하고 있습니다.
Instagram API의 새로운 온보딩 플로Instagram API의 새로운 온보딩 플로를 베타로 공개합니다. 개발자께서는 6월 29일 전까지 베타 관심사 리스트에 등록할 수 있습니다.
Instagram에서 Messenger API에 대한 고정 메뉴 지원을 시작했습니다. 이를 통해 사용자는 페이지의 주요 기능을 발견하고 상호작용할 수 있습니다.
2021년 9월 14일에 공지한 대로 이제 모든 Facebook 페이지를 새로운 핸드오버 프로토콜 동작을 지원하도록 마이그레이션합니다. 2022년 3월 18일까지 모든 페이지를 마이그레이션할 것으로 예상합니다. 자세한 내용은 핵심 변경 사항 섹션을 참조하세요. 앞서 공지한 주요 개선 사항에 대한 요약은 다음과 같습니다.
핸드오버 프로토콜을 개선 중입니다. 핸드오버 프로토콜은 개발자와 비즈니스가 빠르게 메시지 경험(즉, 앱)을 시작하여 앱 사이에 대화 제어 권한을 쉽게 전달하고 앱이 진행 중인 대화에 끼어들지 못하게 함으로써 우수한 사용자 경험을 제공하는 데 도움을 줍니다. 주요 개선 사항으로는 독점적 모드, 유휴 모드, 스레드 소유권을 더욱 세부적으로 제어하는 새로운 API, 앱에 기본 또는 보조 역할을 할당해야 하는 요구 사항 삭제 등이 있습니다.
API 및 자사 설정 도구를 통한 채팅 플러그인 진입점 맞춤 설정을 출시했습니다. 이를 통해 비즈니스는 기본 설정 세트에서 브랜딩에 가장 적합한 진입점 아이콘과 라벨을 선택할 수 있습니다. 자세한 내용은 개발자 문서를 참조하세요.
이제 Messenger API for Instagram이 팔로워가 500,000명 미만인 Instagram 크리에이터 계정 유형에 제공됩니다. 자세한 내용은 개발자 문서를 참조하세요.
핸드오버 프로토콜 개선 사항
맞춤 라벨 API - 맞춤 라벨 API에 대한 흥미로운 업데이트가 진행됩니다. 이를 통해 비즈니스는 라벨을 생성, 업데이트 및 삭제하고 Facebook 페이지 받은 메시지함과 비즈니스에서 고객과 소통하기 위해 사용하는 다른 도구 간의 라벨을 동기화할 수 있습니다.
v12.0
+ 맞춤 라벨 API name
필드가 page_label_name
으로 대체됩니다. 이 변경 사항은 2021년 12월 14일부터 기존의 모든 그래프 API 버전에 적용됩니다. 개발자는 여러 가지 CRUD(생성, 검색, 업데이트, 삭제) API 호출과 Webhooks에서 page_label_name
을 활용해야 합니다.유럽 및 일본의 Messenger API 업데이트 - 유럽의 비즈니스 및 전 세계의 비즈니스와 연결하는 유럽 및 일본 사용자에게는 제공하지 않던 Messenger API의 고객 피드백 템플릿을 복원하였습니다. 자세한 내용은 여기를 참조하세요.
Messenger API for Instagram 업데이트
공감 Webhooks - 새로운 유니코드 형식을 반환하고 여러 가지 이모티콘 공감을 지원하도록 이모티콘 공감을 업데이트했습니다. 개발자 문서를 참조하고 이모티콘 공감을 계속 지원하려면 2021년 12월 14일 전까지 새로운 버전으로 마이그레이션하세요.
사용자 프로필 API - Instagram 앱에서 전체 공개로 제공되는 추가 필드를 포함하도록 사용자 프로필 API를 업데이트했습니다. 자세한 내용은 개발자 문서를 참조하세요.
Facebook 채팅 플러그인 맞춤 설정 API - API를 통한 채팅 플러그인 맞춤 설정을 출시합니다. 이번 새 릴리스를 통해 개발자께서는 현재 Facebook 자사 도구를 통해서만 제공되는 위치, 색상, 인사말, 게스트 모드 설정 등의 기능을 수정할 수 있게 됩니다.
그래프 API v12.0
의 일부로서 이제 메시지 에코 Webhooks에 Facebook 페이지 받은 메시지함의 앱 ID가 포함됩니다. 따라서 비즈니스가 Facebook 페이지 받은 메시지함에서 Messenger 대화에 응답할 경우 페이지에 연결된 다른 앱이 메시지 에코 Webhooks를 수신할 수 있습니다. 이들 앱은 Facebook 페이지 받은 메시지함 앱 ID(263902037430900
)가 포함된 에코 Webhooks를 수신합니다.
v11.0 이상에 다음의 변경 사항이 적용됩니다.
항공사 템플릿 사용 중단- 그래프 API v11부터 항공사 템플릿이 지원되지 않습니다. 그래프 API의 이전 버전에 대한 사용 중단은 2021년 12월 6일에 이 변경 사항에 대한 발표가 있은 후 6개월 뒤에 적용됩니다. 항공사에서는 탑승권 및 체크인 템플릿을 이미지로 보내시기 바랍니다(항공사가 다른 채널에서 일반적으로 해당 알림을 보내는 방식과 동일).
Messenger API for Instagram - 브랜드가 Instagram에서 대규모로 메시지 환경을 제공하도록 작업하는 모든 개발자에게 Messenger API for Instagram을 제공하기 시작했습니다. 이제 개발자는 Instagram 메시지를 앱에 추가하고 Instagram 메시지를 위한 환경을 빌드할 수 있습니다. 이를 통해 개발자는 비즈니스가 다양한 앱을 통해 기존 워크플로를 활용하고 더욱 의미 있는 대화를 유도하여 고객 만족도와 매출을 높이는 데 도움을 줄 수 있습니다. 자세한 내용은 여기를 참조하세요. Messenger API for Instagram을 사용할 때는 개발자 정책, 특히 'Messenger 및 Instagram 메시지 API'에 나와 있는 정책과 기술 문서를 준수해야 합니다.
인간 상담원 메시지 태그를 모든 개발자에게 제공 - 이 태그를 사용하면 비즈니스가 표준 메시지 전송 기간인 24시간을 넘어 최대 7일까지 Messenger 및 Instagram에서 사용자 메시지에 답장을 보낼 수 있습니다. 이 태그는 주말 폐장 등의 사용 사례나 문제 해결에 24시간 이상이 필요한 문의에 특히 도움이 됩니다. 개발자는 앱이 이전에 인간 상담원 메시지 태그에 대한 승인을 받았더라도 앱 대시보드를 통해 인간 상담원 태그 권한을 신청해야 합니다. 앱 대시보드의 '권한 및 기능' 섹션에서 '인간 상담원' 권한을 신청합니다. 자세한 내용은 여기를 참조하세요.
고객 피드백 템플릿베타 공개 - Messenger에 일반적인 설문조사 형식(예: CSAT(고객 만족도), NPS(순 추천 지수), CES(고객 노력 지수))과 자유형 텍스트를 지원하는 네이티브 템플릿을 출시합니다. 이 네이티브 템플릿은 보내기 API를 기반으로 하므로 간편하게 통합할 수 있고, 웹 보기를 사용하여 맞춤 설문조사 솔루션을 빌드할 필요를 없애주며, 개발자들이 유사한 설문조사 형식을 사용하는 모든 채널에서 점수를 쉽게 집계할 수 있도록 지원합니다. 자세한 내용은 여기를 참조하세요.