메시지 전송

Messenger에서 사용자에게 메시지를 보내려면 해당 사용자가 대화를 시작해야 합니다. Messenger 플랫폼에는 전송할 수 있는 메시지 유형이 여러 가지 있습니다. 각 메시지 유형의 경우 콘텐츠 유형 및 전송 가능한 조건에 대한 정책과 가이드라인이 서로 다릅니다.

메시지 구성 요소

앱에서 메시지를 보내기 위한 모든 Send API 요청에는 다음 항목이 포함되어야 합니다.

• 메시지를 보내는 Facebook 페이지 또는 Instagram 프로페셔널 계정과 연결된 Facebook 페이지의 페이지 ID
• 메시지를 받는 사용자의 ID
• 메시지를 보내는 페이지에서 요청한 페이지 액세스 토큰
• 메시지를 받는 사용자의 권한
• 메시지 유형
• 메시지 내용

메시지 구성 요소에 대한 자세한 내용은 Send API 참고 자료 를 참조하세요.

표준 메시지 전송 기간

표준 메시지 전송 기간은 사용자에게 메시지를 보낼 수 있도록 허용된 24시간을 의미합니다. 사용자가 페이지나 Instagram 프로페셔널 계정에 메시지를 보내거나 웹 플러그인을 통해 대화를 시작하면 앱에 메시지 전송 기간이 최대 24시간 부여됩니다.

24시간 이내에 전송된 메시지는 홍보성 콘텐츠를 포함할 수 있습니다.

표준 메시지 전송 기간을 시작하는 사용자 행동

다음의 사용자 행동은 24시간 표준 메시지 전송 기간을 시작합니다.

• 사용자가 페이지 또는 Instagram 프로페셔널 계정에 메시지 전송
• 사용자가 대화 내에서 시작하기와 같은 행동 유도 버튼 클릭
• 사용자가 Messenger 연결 광고를 클릭한 후 페이지나 Instagram 프로페셔널 계정에 메시지 전송
• 사용자가 플러그인(예: Messenger로 보내기 또는 확인란 플러그인)을 통해 페이지에 메시지 전송
• 사용자가 자신과 페이지 간의 기존 대화로 연결되는 m.me 링크 클릭
• 사용자가 자신과 Instagram 프로페셔널 계정의 기존 대화로 연결되는 ig.me 링크 클릭
• 사용자가 메시지(예: 마케팅 메시지)에 공감
• 사용자가 페이지 또는 Instagram 프로페셔널 계정의 게시물에 댓글 작성
• 사용자가 페이지에 방문객 게시물 게시

사용자는 신속한 응답을 기대하기 마련이므로 이 24시간 전송 기간 내에 최대한 신속하게 응답하는 것이 좋습니다. 사용자에게는 언제든 대화를 차단하거나 일시 차단할 수 있는 옵션이 있습니다.

받는 사람 ID

메시지를 받는 사람의 ID는 recipient 개체 매개변수에 설정되고 다음의 ID 유형 중 하나일 수 있습니다.

• 페이지 범위 ID(PSID) – 사용자가 페이지에 처음으로 메시지를 보낼 때 해당 사용자에게 할당된 ID입니다. 이 고유한 ID는 페이지와 사용자 간의 상호작용을 나타냅니다.

• 사용자 참조 – 플러그인이나 포스트백 버튼을 사용하여 페이지에 메시지를 보낸 사용자에게 할당된 ID입니다.

• 게시물 또는 댓글 ID – 페이지에 게시물을 게시했거나 게시물에 댓글을 남긴 사용자에게 할당된 ID입니다. 사용자에게 비공개 답장을 보내는 데 사용합니다.

Facebook 로그인 통합의 사용자 ID는 앱 범위이며, Messenger 플랫폼에서는 작동하지 않습니다.

메시지 유형

전송하는 메시지 유형은 messaging_type 매개변수에 설정됩니다. 이 매개변수는 메시지가 메시지 전송 정책을 준수하고, 받는 사람의 기본 설정을 따르도록 하는 더욱 명시적인 방법입니다.

다음의 메시지 유형이 지원됩니다.

• 응답 – 전송하는 메시지는 수신된 메시지에 대한 응답입니다. 이 메시지는 홍보성 및 비홍보성 콘텐츠를 포함할 수 있으며, 표준 메시지 전송 기간에 보내야 합니다.

• 업데이트 – 전송하는 메시지는 수신된 메시지에 대한 응답이 아니라 미리 전송되는 메시지입니다. 이 메시지는 홍보성 및 비홍보성 콘텐츠를 포함할 수 있으며, 표준 메시지 전송 기간에 보내야 합니다.

• 태그된 메시지 – 전송하는 메시지는 표준 메시지 전송 기간이 아닐 때 전송되는 메시지입니다. 이 메시지에는 태그에 허용되는 사용 사례와 일치하는 메시지 태그를 포함하고 비홍보성 콘텐츠가 있어야 합니다.

메시지 태그

메시지 태그를 사용하면 표준 메시지 전송 기간이 아닐 때 메시지를 전송할 수 있습니다. 이 메시지는 사용자에게 개인적으로 관련이 있는 업데이트입니다. 예를 들어 발송 및 배송, 예정된 예약이나 항공편에 대한 업데이트 또는 고객 계정에 관한 알림을 전송할 수 있습니다. 에스컬레이션 경로가 필요한 메시지 플로의 경우 인간 상담원 태그를 지정하면 비즈니스 담당자가 7일 안에 사용자 메시지에 수동으로 응답할 수 있습니다.

메시지 태그는 딜, 혜택, 쿠폰, 할인 등의 홍보성 콘텐츠를 전송하는 데 사용할 수 없습니다. 승인된 사용 사례가 아닌 경우에 메시지 태그를 사용하면 페이지나 Instagram 계정의 메시지 전송 기능이 제한될 수 있습니다. 자세한 내용은 Messenger 플랫폼 및 Instagram 메시지 API 정책 을 참조하세요.

24시간 표준 메시지 전송 기간 외에 홍보성 메시지를 전송하고자 하고 Messenger 플랫폼을 사용하는 비즈니스는 홍보 메시지 또는 일회성 알림을 사용해야 합니다.

콘텐츠 유형

전송하는 메시지에는 다음 유형의 콘텐츠가 포함될 수 있습니다.

기본 텍스트 보내기

페이지에 메시지를 보낸 사람에게 기본 문자 메시지를 전송하려면 /PAGE-ID/messages 엔드포인트로 POST 요청을 보냅니다. 이때 recipient 개체 리터럴 키 id는 해당 사용자의 페이지 범위 ID(PSID)로 설정하고 message_type 매개변수는 RESPONSE로 설정하고 message 매개변수 개체 text는 메시지 텍스트로 설정합니다.

요청 샘플

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"{PSID}"
  },
  "messaging_type": "RESPONSE",
  "message":{
    "text":"Hello, world!"
  }
}' "https://graph.facebook.com/v21.0/{PAGE-ID}/messages?access_token={PAGE-ACCESS-TOKEN}"
    

요청이 성공하면 앱에서 받는 사람의 ID와 메시지 ID가 포함된 다음의 JSON 응답을 수신합니다.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

미디어 첨부 파일 보내기

GIF, 이미지와 같은 미디어나 템플릿을 포함하여 메시지를 전송하려면 JSON 메시지 첨부 파일 개체의 API 요청에 콘텐츠를 추가합니다.

페이지에 메시지를 보낸 사람에게 이미지가 포함된 메시지를 전송하려면 /PAGE-ID/messages 엔드포인트로 POST 요청을 보냅니다. 이때 recipient 개체 리터럴 키 id는 해당 사용자의 페이지 범위 ID(PSID)로 설정하고 message_type 매개변수는 RESPONSE로 설정하고 message 매개변수 attachment 개체 type 키는 image로 설정하고 payload 개체 url 키는 이미지 URL로 설정합니다.

요청 샘플

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"1254459154682919"
  },
  "message":{
    "attachment":{
      "type":"image", 
      "payload":{
        "url":"http://www.messenger-rocks.com/image.jpg", 
        "is_reusable":true
      }
    }
  }
}' "https://graph.facebook.com/v21.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"
  

요청이 성공하면 앱에서 받는 사람의 ID와 메시지 ID가 포함된 다음의 JSON 응답을 수신합니다.

{
  "recipient_id": "PAGE-SCOPED-ID",
  "message_id": "AG5Hz2U..."
} 

URL에서 오디오, 동영상 또는 파일을 전송할 때 동일한 형식을 사용합니다.

또한 서버에서 미디어를 전송하거나 Meta 서버에 업로드했던 콘텐츠에서 미디어를 전송할 수도 있습니다. 첨부 파일 업로드 API 를 사용하여 파일을 업로드하는 방법에 대해 자세히 알아보세요.

모범 사례

문자 메시지

첨부 파일

추가적 메시지 유형

새로운 메시지(개발 중)

뉴스 메시지는 Facebook 뉴스 페이지 인덱스(NPI) 에 등록된 뉴스 퍼블리셔만 사용할 수 있습니다. 뉴스 메시지를 사용하면 뉴스 퍼블리셔가 이러한 메시지를 수신하기 위해 구독한 사용자에게 비홍보성 뉴스 메시지를 보낼 수 있습니다.

뉴스 메시지는 Instagram 메시지 API에 제공되지 않습니다.

일회성 알림

일회성 알림을 사용하면 표준 메시지 전송 기간이 끝난 후 후속 메시지 하나를 전송할 권한을 사용자에게 요청할 수 있습니다. 사용자가 일회성 알림을 수신하기 위한 이 요청을 수락하면 예약 알림이나 재입고 알림과 같이 시간에 민감하고 개인적으로 관련이 있는 메시지 하나를 보낼 수 있습니다.

일회성 알림은 Instagram 메시지 API에 제공되지 않습니다.

비공개 답장

비공개 답장을 사용하면 사용자가 게시물이나 광고 중 하나에 댓글을 남기거나, 페이지 또는 Instagram 프로페셔널 계정에 방문객 게시물을 게시할 때 해당 사용자에게 메시지를 보낼 수 있습니다. 비공개 답장은 게시물이나 댓글에 대한 링크를 자동으로 포함하는 유일한 단일 메시지일 수 있으며, 사용자가 게시물이나 댓글을 게시한 날로부터 7일 이내에 보내야 합니다.

마케팅 메시지

마케팅 메시지를 사용하면 표준 메시지 전송 기간이 끝난 후 여러 건의 마케팅 메시지를 전송할 권한을 사용자에게 요청할 수 있습니다. 사용자가 이런 알림을 받기 위한 이 요청을 수락하면 예정된 세일이나 제품 출시 및 업데이트에 대한 정보가 포함된 자동 정기 홍보성 메시지를 보낼 수 있습니다.

홍보 메시지

홍보 메시지를 사용하면 표준 메시지 전송 기간이 만료된 후 페이지 또는 Instagram 프로페셔널 계정에 메시지를 보낸 적이 있는 사용자에게 홍보성 또는 비홍보성 콘텐츠를 보낼 수 있습니다. 홍보 메시지는 대화 내에서 일반 메시지처럼 보이지만 메시지 위에 '홍보(Sponsored)'라고 표시되어 있습니다. 홍보 메시지 콘텐츠는 광고 정책 을 준수해야 합니다.

홍보 메시지는 Instagram 메시지 API에 제공되지 않습니다.

다음 단계

대화에서 메시지에 추가할 수 있는 구성 요소에 대해 알아보세요.

더 알아보기

Messenger 플랫폼을 사용하여 메시지를 보내는 방법에 대해 자세히 알아보세요.

• 첨부 파일 업로드 API 참고 자료 – 미디어 업로드 및 전송에 대해 자세히 알아보세요.
• Send API 참고 자료 – 전송 가능한 모든 태그, 콘텐츠 및 첨부 파일에 대해 자세히 알아보세요.
• 사용 제한 – Messenger 플랫폼을 사용해 메시지 전송 시 사용 제한에 대해 자세히 알아보세요.