미디어

/v1/media

media 노드를 사용하여 미디어를 업로드하거나 검색 또는 삭제합니다.

에지

이 노드와 연결되는 에지는 다음과 같습니다.

시작하기 전에

미디어 메시지를 발송하면 미디어는 WhatsApp 서버에 14일간 저장됩니다. 사용자가 14일 후에 미디어 다운로드를 요청하면 WhatsApp 서버가 동일한 미디어 파일을 WhatsApp Business 온프레미스 클라이언트에 요청하게 됩니다. 미디어가 제거되었다면 사용자에게 미디어를 사용할 수 없다고 알립니다.

메시지 전송 또는 확인 여부로 미디어가 다운로드되었다고 섣불리 가정해서는 안 됩니다. 최근 30일 이내의 발송 미디어는 대개 삭제해도 문제가 없지만 비즈니스에 가장 적절한 전략을 적용해야 합니다.

제약 사항

• 미디어 URL에 링크하는 대신 미디어 업로드 프로세스를 사용할 경우, 파일은 반드시 미디어 볼륨에 업로드해야 합니다. 업로드가 완료되면 미디어 ID를 사용하여 메시지를 보낼 수 있습니다.
• 애플리케이션은 업로드된 미디어를 서버로 보내기 전에 처리합니다. media 노드에 업로드할 수 있는 미디어의 최대 파일 용량은 100MB이지만 다양한 미디어 유형의 후처리 제한은 아래의 후처리 미디어 용량 표를 참조하세요.
• 미디어 스토리지는 비즈니스에서 처리해야 합니다. 미디어 볼륨이 가득 차면 메시지 발송이 실패합니다.
• 다음에 대한 지원은 제공하지 않습니다.

  • 바이트 스트림으로 미디어를 전송할 수 없습니다.
  • 애니메이션 스티커가 적용된 메시지를 전송할 수 없습니다.

업로드

미디어를 업로드하려면 POST 요청을 /v1/media로 보냅니다. 온프레미스 요청 본문에는 바이너리 미디어 데이터를 포함해야 하고 Content-Type 헤더는 업로드하는 미디어의 유형으로 설정해야 합니다. 지원되는 옵션은 지원되는 콘텐츠 유형 섹션을 참조하세요.

POST HTTP 요청에 바이너리 데이터를 보내는 것은 표준적인 바이너리 데이터 업로드 방식입니다. 예를 들어 이미지를 업로드하려면 페이로드의 실제 이미지 바이트가 있는 POST 요청을 보내야 합니다. 또는 cURL에 --data-binary를 함께 사용하여 바이너리의 해당 파일을 주어진 그대로 읽고 사용할 수 있습니다.

예

미디어 업로드:

POST /v1/media
Content-Type: image/jpeg or other appropriate media type

your-binary-media-data

cURL로 미디어 업로드:

curl -X POST \
https://your-webapp-hostname:your-webapp-port/v1/media \
-H 'Authorization: Bearer your-auth-token' \ 
-H 'Content-Type: image/jpeg'  \ # or other appropriate media type
--data-binary @your-file-path

두 가지 경우 모두, 요청이 성공하면 응답에서 id 필드를 반환합니다. 이 필드는 미디어를 검색하거나 미디어 메시지를 고객에게 보낼 때 필요합니다.

{
    "media": [
        {
            "id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
        }
    ]
}

오류 메시지가 표시되는 경우 오류 및 상태 메시지에서 자세한 내용을 참조하세요.

지원되는 콘텐츠 유형

후처리 미디어 용량

압축 및 암호화 후 미디어 파일에 허용되는 최대 용량입니다.

FAQ

docker volume inspect whatsappMedia

[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data",
        "Name": "whatsappMedia",
        "Options": {},
        "Scope": "local"
    }
]

ls /var/lib/docker/volumes/whatsappMedia/_data/

더 알아보기

• 모범 사례
• 메시지
• 참고 자료