미디어 메시지 보내기
/messages 노드를 사용하여 오디오, 문서, 이미지, 스티커 또는 동영상이 포함된 메시지를 고객에게 전송합니다.
기본적으로 미디어가 포함된 메시지를 보낼 때는 업로드된 미디어의 ID나 미디어 링크를 요청 본문에 제공해야 합니다. 또한 전송하는 미디어 유형(audio, document, image, sticker 또는 video)도 지정해야 합니다. 요청을 수신하면 미디어가 WhatsApp 서버에 업로드되고 to 필드에 표시된 사용자에게 전송됩니다.
현재 WhatsApp Business API로 미디어 메시지를 보내는 방법에는 두 가지가 있습니다.
- ID — ID를 사용하려면 먼저
media노드를 사용하여 미디어를 업로드하고messagesAPI 호출에 필요한 ID를 얻어야 합니다. - 링크 — 링크를 사용하려면 HTTP(S) 링크를 제공해야 합니다. 앱이 이 링크에서 미디어를 다운로드하므로 미디어를 직접 업로드하는 단계를 생략할 수 있습니다.
1단계: /messages로 POST 요청 보내기
미디어를 업로드한 후 미디어 메시지를 보내는 API 호출의 id 필드에 반환된 ID를 사용합니다. 또는 전송하고자 하는 미디어를 가리키는 link 매개변수를 제공할 수도 있습니다(현재는 HTTP/HTTPS 링크만 지원함).
id 또는 link가 필수이지만 동시에 사용해서는 안 됩니다.
예
아래의 샘플은 audio, document, image, sticker 및 video 등의 다양한 개체를 참고용으로 제공합니다. 유효한 요청 본문에는 그중 하나만 포함됩니다.
POST /v1/messages
{
"recipient_type": "individual",
"to": "whatsapp-id",
"type": "audio" | "contact" | "document" | "image" | "location" | "sticker" | "text" | "video",
"audio": {
"id": "your-media-id"
}
"document": {
"id": "your-media-id",
"filename": "your-document-filename"
}
"document": {
"link": "the-provider-name/protocol://the-url",
"provider": {
"name" : "provider-name"
}
}
"document": {
"link": "http(s)://the-url.pdf"
}
"video": {
"id": "your-media-id"
}
"image": {
"link": "http(s)://the-url",
"provider": {
"name" : "provider-name"
}
}
"image": {
"id": "your-media-id"
}
"sticker": {
"id": "your-media-id"
}
"sticker": {
"link": "http(s)://the-url",
"provider": {
"name" : "provider-name"
}
}
}
매개변수에 대한 자세한 내용은 다음을 참조하세요.
2단계: 응답 확인
성공한 응답에는 메시지 ID와 함께 messages 개체가 포함되어 있습니다.
{
"messages": [{
"id": "gBEGkYiEB1VXAglK1ZEqA1YKPrU"
}]
}
응답이 실패할 경우, 응답에 메시지 전송이 성공한 것과 유사한 메시지 ID가 표시되더라도 Webhooks URL로 콜백이 전송됩니다. 그래서 Webhooks 서버를 설정하는 것이 중요합니다.
오류에 대한 자세한 내용은 오류 및 상태 코드를 참조하세요.