Messenger 플랫폼

Messenger 플랫폼을 사용한 Instagram 메시지

On July 23, 2024 we launched the new Instagram API with Instagram Login. An Instagram professional account – Business or Creator account – will no longer need to be linked to a Facebook Page in order to have conversations with customers, followers, or Instagram users interested in their business or Instagram account, manage comments, or publish media. Learn more about this new version in our blog post.

See our Instagram API with Instagram Login to learn more.

Messenger 플랫폼에서는 Instagram 프로페셔널 계정을 위한 메시지 솔루션을 대규모로 빌드할 수 있습니다.

Instagram 메시지는 다음 계정에 제공됩니다.

  • 비즈니스의 Instagram 프로페셔널 계정
  • 크리에이터의 Instagram 프로페셔널 계정

대화 API 를 사용하여 관리하는 계정에 대한 자격 요건을 확인할 수 있습니다. 메시지를 아직 사용할 수 없는 경우 36103 오류 코드가 반환됩니다.

일반적인 사례

  • 고객이 Instagram 프로페셔널 받은 메시지함으로 전송한 메시지 가져오기
  • 고객 메시지를 수신하고 텍스트, 미디어, 스토리 등으로 답장하기
  • Instagram에 공개 게시물을 게시한 사용자에게 비공개 답장 보내기
  • Instagram 게시물에 대한 댓글을 게시한 사용자에게 비공개 답장 보내기

사용 방법

Messenger 플랫폼을 사용하면 비즈니스나 창작에 관심이 있는 사용자와 대화를 나눌 수 있습니다. Instagram 프로페셔널 계정에 연결된 Facebook 페이지는 Messenger 플랫폼을 사용하여 이러한 대화를 돕습니다. 사용자가 Instagram에 메시지를 보내면 메시지는 Instagram 받은 메시지함으로 전달되고 Webhooks 알림이 서버로 전송됩니다. 메시지 앱은 24시간 이내에 이 메시지에 답장해야 합니다. 인간 상담원이 응답하는 데 더 많은 시간이 필요할 경우 응답에 태그를 추가하여 표준 24시간 메시지 전송 기간 외에 메시지를 보내도록 할 수 있습니다.

Instagram 메시지는 사용자가 대화를 시작하기 위한 여러 가지 대화 진입점과 메시지 앱에서 답장을 보내는 데 사용할 수 있는 메시지 유형을 제공합니다.

Instagram 받은 메시지함

Instagram 프로페셔널 계정에는 알림을 관리하고 메시지를 정리할 수 있는 메시지 받은 메시지함이 있습니다. 기본적으로 알림은 꺼짐으로 설정되어 있습니다. 받은 메시지함 설정에서 알림을 끌 수 있습니다. 받은 메시지함은 기본, 일반 및 요청 카테고리로 정리됩니다. 기본적으로 팔로워가 보낸 모든 새로운 대화는 기본 폴더에 표시됩니다. Instagram 메시지를 구현하기 전에 존재했던 대화는 원래 넣었던 폴더에 저장됩니다.

계정의 팔로워가 아닌 사용자에게서 받은 메시지는 요청 폴더에 저장됩니다. 이러한 요청을 수락하거나 거부할 수 있으며, 요청 메시지는 수락되기 전까지 읽음 상태로 표시되지 않습니다. 요청이 수락되면 기본 또는 일반 폴더로 대화를 이동할 수 있습니다. 타사 앱을 사용하여 답하는 모든 메시지 요청은 일반 폴더로 이동됩니다.

받은 메시지함 제한 사항

  • 타사 앱을 사용하여 메시지에 답장하는 경우, 설정 구성과 관계없이 대화는 일반 폴더로 이동됩니다.
  • 받은 메시지함 폴더는 지원되지 않으며, Messenger 플랫폼에서 전달한 메시지에는 Instagram from Meta 앱 받은 메시지함 폴더에 표시된 폴더 정보가 포함되지 않습니다.
  • API를 통해 전달된 메시지 또는 Webhooks 알림은 Instagram 앱 받은 메시지함에서 읽음으로 간주되지 않습니다. 답장을 전송한 이후에만 메시지가 읽음으로 간주됩니다.

Instagram용 비즈니스 로그인

2022년 11월 9일부터 Instagram용 비즈니스 로그인이 도입됩니다. 이 로그인 플로를 사용하는 사용자는 로그인 플로 내에서 Instagram 계정을 Instagram 프로페셔널 계정으로 변환하고, 비즈니스의 Facebook 페이지를 생성하고, 해당 페이지와 Instagram 프로페셔널 계정을 연결할 수 있습니다.

요구 사항

이 가이드에서는 Messenger 플랫폼 개요를 읽고 메시지와 알림을 주고받는 데 필요한 구성 요소를 구현했다고 가정합니다.

  • Instagram 그래프 API – 이 API를 사용하는 비즈니스와 크리에이터는 앱을 사용하여 Instagram에서 입지를 관리할 수 있습니다.
  • 다음 권한이 필요합니다.
    • instagram_basic
    • instagram_manage_messages
    • pages_manage_metadata
    • pages_showlist
    • business_management
  • 메시지 삭제에 대한 Webhooks 알림을 받으면 메시지 삭제

자동화된 경험

다음 중 하나를 사용하여 자동화된 메시지 경험에 대한 에스컬레이션 경로를 제공할 수 있습니다.

  • 단일 앱 – 맞춤 받은 메시지함을 만들어서 사용자가 보낸 메시지를 받거나 여기에 답장할 수 있습니다. 이 맞춤 받은 메시지함은 자동화된 경험을 제공하는 것과 동일한 메시지 앱에서 운영합니다.
  • 여러 앱 – 핸드오버 프로토콜 을 사용하면 대화를 하나의 앱이나 받은 메시지함에서 다른 앱이나 받은 메시지함으로 전달할 수 있습니다. 예를 들어 어떤 앱은 자동화된 경험을 사용하여 대화를 처리하고, 필요한 경우 이 대화를 다른 앱으로 전달하여 인간 상담원과의 대화를 계속합니다.

자동 채팅 환경에 대해 사용자에게 알리기

관련법에 의해 요구되는 경우 자동 채팅 환경에서 사용자에게 자동화된 서비스와 상호 작용하고 있음을 알려야 하는 상황은 다음과 같습니다.

  • 대화 또는 메시지 스레드를 시작할 때
  • 상당한 시간이 지난 후
  • 채팅이 인간과의 상호 작용에서 자동 환경으로 전환될 때

다음 집단에 제공되는 자동 채팅 환경에서는 이 요구 사항에 특별히 주의를 기울여야 합니다.

  • 캘리포니아 시장 또는 캘리포니아 사용자
  • 독일 시장 또는 독일 사용자

고지 내용은 다음을 포함하되 이에 국한되지 않습니다. "저는 [페이지 이름] 봇입니다", "회원님은 자동 채팅 환경과 상호 작용하고 있습니다", "회원님은 봇과 이야기하는 중입니다" 또는 "저는 자동 챗봇입니다."

법적으로 요구되지 않는 경우에도, 사용자가 자동 채팅과 상호 작용할 때 사용자에게 알리는 것이 좋습니다. 이렇게 하면 메시지 환경과의 상호 작용에 대한 사용자의 기대를 관리할 수 있습니다.

자세한 내용은 개발자 정책을 참조하세요.

인간 상담원 전용

맞춤 받은 메시지함으로 인간 상담원 전용 메시지 경험에 대한 에스컬레이션 경로를 제공할 수 있습니다. 메시지 앱은 다음과 같은 기능을 제공해야 합니다.

  • 사용자가 보낸 메시지를 수신하고 맞춤 받은 메시지함에서 올바르게 구현하는 기능
  • 맞춤 받은 메시지함을 통해 메시지에 답장하고 사용자가 이를 성공적으로 수신하도록 하는 기능

제한 사항

  • Instagram 프로페셔널 계정은 대화 1건당 1명의 고객과만 대화를 나눌 수 있습니다. 그룹 메시지 전송은 지원되지 않습니다.
  • 30일 동안 활동이 없는 요청 폴더 내의 대화는 API 호출에서 반환되지 않습니다.
  • 고객이 공유를 포함하여 메시지를 전송할 때 공유된 미디어 또는 게시물의 URL만 Webhooks 알림에 포함됩니다.
  • 크리에이터의 Instagram 프로페셔널 계정은 Instagram 대화 API를 사용하여 API 요청을 전송해야 계정에서 Webhooks를 수신할 수 있습니다.

테스트 제한 사항

  • Standard Access 권한이 있는 앱은 앱에서 역할이 부여된 사용자와만 상호작용할 수 있습니다.
  • 어떤 기능은 앱에 Advanced Access 권한이 부여되어야 정상적으로 작동할 수 있습니다.
  • 앱을 테스트하는 사용자는 앱에서 역할을 부여받고 모든 필수적인 권한에 대한 액세스 권한을 부여하며, Instagram 프로페셔널 계정에서 역할을 부여받아야 합니다.

다음 단계

기타 참고 자료