보내기 API 참조
보내기 API는 사용자에게 메시지를 보내는 데 사용되는 기본 API로 텍스트, 첨부 파일, 템플릿, 보내는 사람 액션 등의 다양한 기능이 포함되어 있습니다.
생성
메시지를 생성하여 회원님의 고객 또는 회원님의 Facebook 페이지에 관심을 보이는 사람들에게 보냅니다.
시작하기 전에
필수 조건:
- 페이지에서
MESSAGE작업을 수행할 수 있는 사람이 요청한 페이지 액세스 토큰 pages_messaging권한- 메시지를 받는 사람이 최근 24시간 이내에 회원님의 페이지에 메시지를 보냈거나 표준 24시간 메시지 기간 외에 회원님의 페이지로부터 메시지를 수신하는 데 동의했어야 합니다
제한 사항
- 메시지 태그를 사용하여 홍보 콘텐츠를 보낼 수 없습니다
보내기 API는 메시지 수신자를 식별하기 위해 recipient.user_ref 또는 recipient.phone_number 를 사용하여 전송한 메시지에 대한 응답에 recipient_id 를 포함하지 않습니다.
샘플 요청
메시지를 사용자에게 보내려면 messaging_type 및 recipient 매개변수를 설정하고 메시지 콘텐츠를 포함하여 /PAGE-ID/messsages 엔드포인트에 POST 요청을 보냅니다.
다음 예는 페이지에서 보내는 메시지가 텍스트로만 구성된 경우 사용자의 메시지에 대한 응답입니다.
curl -i -X POST "https://graph.facebook.com/LATEST-API-VERSION/PAGE-ID/messages
?recipient={'id':'PSID'}
&messaging_type=RESPONSE
&message={'text':'hello,world'}
&access_token=PAGE-ACCESS-TOKEN성공하면 앱에서 다음 JSON 응답을 받게 됩니다.
{
"recipient_id": "PAGE-SCOPED-ID",
"message_id": "AG5Hz2U..."
} 매개변수
| 매개변수 | 설명 |
|---|---|
| 페이지에서 보내는 메시지의 유형. 이 매개변수를 사용할 경우
|
필수 | 전송되는 메시지의 유형
|
| 사용자가 수신하는 푸시 알림의 유형
|
필수 | 페이지에서 보내는 메시지를 수신하는 사람
|
| 사용자가 페이지에 보낸 메시지에 대해 페이지에서 취해진 조치를 나타내는 메시지 기간 내에 표시되는 조치 아이콘
|
| 표준 24시간 메시지 기간 외에 페이지에서 사용자에게 메시지를 보낼 수 있도록 해주는 태그
|
메시지 태그 사용 방법
다음 표에 각 메시지 태그에 대한 메시지 유형이 나열되어 있습니다.
| 메시지 태그 | 사용 방법 |
|---|---|
| 허용되는 사용 방법
허용되지 않는 사용 방법(전체 내용은 아님)
Instagram 메시지 API에 사용할 수 없습니다. |
| 허용되는 사용 방법
허용되지 않는 사용 방법(전체 내용은 아님)
Instagram 메시지 API에 사용할 수 없습니다. |
| 허용되는 사용 방법
허용되지 않는 사용 방법(전체 내용은 아님)
Instagram 메시지 API에 사용할 수 없습니다. |
| 허용되는 사용 방법
허용되지 않는 사용 방법(전체 내용은 아님)
Instagram 메시지 API의 경우 필수 사항입니다. |
| 허용되는 사용 방법
허용되지 않는 사용 방법(전체 내용은 아님)
Instagram 메시지 API에 사용할 수 없습니다. |
업데이트
이 엔드포인트에서 이 작업을 수행할 수 없습니다.
삭제
이 엔드포인트에서 이 작업을 수행할 수 없습니다.
기타 참고 자료
개발자 지원
- Meta Status 도구
를 사용하여 Meta 비즈니스 제품의 상태와 중단을 확인하세요.
- Meta 개발자 지원 도구를 사용하여 버그를 신고하고, 신고된 버그를 확인하고, 광고 또는 비즈니스 관리자 등을 통해 도움을 받으세요.
- Messenger 플랫폼의 지원 리소스에서 Messenger 플랫폼 지원에 대한 자세한 리소스를 확인하세요.