문서가 업데이트되었습니다.
한국어로 번역이 아직 완료되지 않았습니다.

영어 업데이트됨: 2023. 8. 31.

메시지 전송

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 플랫폼을 사용하는 비즈니스는 홍보 메시지 또는 일회성 알림을 사용해야 합니다.

콘텐츠 유형

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

오디오
버튼
파일

메뉴
GIF
이미지

템플릿
텍스트
동영상

기본 텍스트 보내기

페이지에 메시지를 보낸 사람에게 기본 문자 메시지를 전송하려면 /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/LATEST-API-VERSION/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/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

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

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

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

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

모범 사례

문자 메시지

간결하게 작성하세요. 화면 크기와 스크롤 동작을 고려하세요. 메시지가 간결해야 사용자가 쉽게 읽을 수 있습니다. 긴 메시지 하나를 보내는 대신 메시지를 몇 개로 나누어 보내세요.

텍스트로 이미지, 표, 차트를 대체하지 마세요. 구조화된 메시지 또는 웹 보기가 요구 사항에 더 적합할 수 있습니다.

지나치게 긴 메시지를 삼가세요. 여러 가지 사항을 전달해야 할 경우 긴 메시지 하나를 보내는 대신 메시지를 몇 개로 나누어 보내세요.

첨부 파일

품질에 주의를 기울이세요. 해상도가 높은 다채로운 이미지를 사용하여 메시지가 돋보이게 하세요.

가로세로비를 고려하세요. 메시지 버블에 표시될 때 이미지가 어떻게 잘릴지 확인하세요.

이미지에 너무 많은 문구를 넣지 마세요. 대신 문자 메시지를 사용하거나, 이미지와 텍스트를 일반 템플릿과 결합하세요.

다음 단계

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

더 알아보기

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

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

개발자 지원

Meta Status 도구를 사용하여 Meta 비즈니스 제품의 상태와 중단을 확인하세요.
Meta 개발자 지원 도구를 사용하여 버그를 신고하고, 신고된 버그를 확인하고, 광고 또는 비즈니스 관리자 등을 통해 도움을 받으세요.
Messenger 플랫폼의 지원 리소스에서 Messenger 플랫폼 지원에 대한 자세한 리소스를 확인하세요.

메시지 전송

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

메시지 구성 요소

표준 메시지 전송 기간

받는 사람 ID

메시지 유형

메시지 태그

콘텐츠 유형

기본 텍스트 보내기

요청 샘플

미디어 첨부 파일 보내기

요청 샘플

모범 사례

문자 메시지

첨부 파일

추가적 메시지 유형

새로운 메시지(개발 중)

일회성 알림

비공개 답장

마케팅 메시지

홍보 메시지

다음 단계

더 알아보기

개발자 지원