메시지 전송

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

메시지 구성 요소

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

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

메시지 구성 요소에 대한 자세한 내용은 보내기 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/v25.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/v25.0/me/messages?access_token={PAGE_ACCESS_TOKEN}"
  

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

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

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

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

여러 미디어 첨부 파일 보내기

여러 이미지를 포함하여 메시지를 전송하려면 API 요청에 JSON 메시지 첨부 파일 배열로 콘텐츠를 추가합니다. 허용되는 유일한 미디어 유형은 이미지이며 한 번에 30장으로 제한됩니다.

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

요청 샘플

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

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

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

메시지에 답장 보내기

채팅 내에서 과거의 특정 메시지에 답장을 보내려면 다음과 /PAGE-ID/messages로 POST 요청을 보내세요.

• 사용자의 페이지 범위 ID(PSID)로 설정된 recipient 개체 리터럴 키 id
• RESPONSE로 설정된 message_type
• 메시지 매개변수 개체의 메시지 상세 정보
• 답장을 보내려는 특정 메시지의 메시지 ID로 설정된 reply_to 개체 리터럴 키 mid

메시지는 페이지 또는 사용자가 전송한 메시지가 해당될 수 있습니다.

요청 샘플

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient": {
    "id": "<PSID>",
  }
  "messaging_type": "RESPONSE"
  "message": {
    "text": "Hello, world!"      
  },
  "reply_to": {
    "mid": "{MESSAGE_ID}"
  }
}' "https://graph.facebook.com/v23.0/{PAGE-ID}/messages?access_token={PAGE_ACCESS_TOKEN}" 

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

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

모범 사례

문자 메시지

• 간결하게 작성하세요. 화면 크기와 스크롤 동작을 고려하세요. 메시지가 간결해야 사용자가 쉽게 읽을 수 있습니다. 긴 메시지 하나를 보내는 대신 메시지를 몇 개로 나누어 보내세요.
• 텍스트로 이미지, 표, 차트를 대체하지 마세요. 구조화된 메시지 또는 웹 보기가 요구 사항에 더 적합할 수 있습니다.
• 지나치게 긴 메시지를 삼가세요. 여러 가지 사항을 전달해야 할 경우 긴 메시지 하나를 보내는 대신 메시지를 몇 개로 나누어 보내세요.

첨부 파일

• 품질에 주의를 기울이세요. 해상도가 높은 다채로운 이미지를 사용하여 메시지가 돋보이게 하세요.
• 가로세로비를 고려하세요. 메시지 버블에 표시될 때 이미지가 어떻게 잘릴지 확인하세요.
• 이미지에 너무 많은 문구를 넣지 마세요. 대신 문자 메시지를 사용하거나, 이미지와 텍스트를 일반 템플릿과 결합하세요.

추가적 메시지 유형

마케팅 메시지

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

뉴스 메시지(개발 중)

뉴스 메시지는 Facebook 뉴스 페이지 인덱스(NPI)에 등록된 뉴스 퍼블리셔만 사용할 수 있습니다. 뉴스 메시지를 통해 뉴스 퍼블리셔는 비홍보성 뉴스 메시지를 수신하는 데 동의한 사람들에게 해당 메시지를 보낼 수 있습니다.

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

일회성 알림

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

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

비공개 답장

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

홍보 메시지

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

홍보 메시지는 Instagram 메시지 API에서 사용할 수 없습니다.

유틸리티 메시지

유틸리티 메시지를 사용하면 주문, 계정 업데이트, 예약이 포함된 사전 승인된 템플릿 메시지를 전송할 수 있습니다. 이 메시지는 계정 번호, 주문 ID, 배송 조회 번호, 예약 날짜, 시간으로 매우 세밀하게 맞춤화할 수 있으며, 사용자가 주문을 취소하고, 예약을 변경하는 등의 비즈니스와 상호 작용을 쉽게 할 수 있는 행동 유도를 포함할 수 있습니다.

다음 단계

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

더 알아보기

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

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