

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# AWS 최종 사용자 메시징 소셜을 사용하여 WhatsApp을 통해 메시지 전송
<a name="whatsapp-send-message"></a>

메시지를 보내기 전에 WhatsApp 비즈니스 계정(WABA)을 설정해야 하며 사용자는 사용자의 메시지 수신을 옵트인해야 합니다. 자세한 내용은 [권한 획득](whatsapp-best-practices.md#best-practices-whatsapp-obtain-permission) 단원을 참조하십시오.

사용자가 메시지를 보내면 고객 서비스 창이라는 24시간 타이머가 시작되거나 새로 고쳐집니다. 템플릿 메시지를 제외한 모든 메시지 유형은 사용자와 사용자 간에 고객 서비스 창이 열려 있는 경우에만 전송할 수 있습니다. 템플릿 메시지는 사용자가 사용자의 메시지 수신을 옵트인한 한 언제든지 전송할 수 있습니다.

전송하거나 수신하는 각 메시지에 대해 메시지 상태가 생성되어 이벤트 대상으로 전송됩니다. 고객이 WhatsApp에 가입하지 않은 경우 메시지 상태가 인 이벤트가 생성됩니다`fail`. [메시지 상태를 수신하려면 메시지 및 이벤트 대상](managing-event-destinations.md)을 켜야 합니다. [WhatsApp 메시지 상태](managing-event-destinations-status.md) 

메시지 유형 목록은 WhatsApp Business Platform Cloud API 참조[의 메시지를](https://developers.facebook.com/docs/whatsapp/conversation-types/) 참조하세요. *WhatsApp * 

**중요**  
WhatsApp 비즈니스 솔루션 사용에는 [WhatsApp 비즈니스 서비스 약관](https://www.whatsapp.com/legal/business-terms), [WhatsApp 비즈니스 솔루션 약관](https://www.whatsapp.com/legal/business-solution-terms), [WhatsApp 비즈니스 메시징 정책](https://business.whatsapp.com/policy), [WhatsApp 메시징 지침](https://www.whatsapp.com/legal/messaging-guidelines) 및 참조로 통합된 기타 모든 약관, 정책 또는 지침이 적용됩니다. 때때로 업데이트될 수 있습니다.
Meta 또는 WhatsApp은 언제든지 WhatsApp 비즈니스 솔루션 사용을 금지할 수 있습니다.
WhatsApp 비즈니스 솔루션 사용과 관련하여 사용자는 관련 법률 또는 규정에 따라 배포를 보호하거나 제한해야 하는 콘텐츠, 정보 또는 데이터를 제출하지 않습니다.

**Topics**
+ [AWS End User Messaging Social에서 템플릿 메시지를 보내는 예제](send-message-text.md)
+ [AWS End User Messaging Social에서 미디어 메시지를 보내는 예](send-message-media.md)

# AWS End User Messaging Social에서 템플릿 메시지를 보내는 예제
<a name="send-message-text"></a>

전송할 수 있는 메시지 템플릿 유형에 대한 자세한 내용은 *WhatsApp Business Platform Cloud API* 참조의 [메시지 템플릿을](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates) 참조하세요. 전송할 수 있는 메시지 유형 목록은 *WhatsApp Business Platform Cloud API* 참조의 [메시지를 참조하세요](https://developers.facebook.com/docs/whatsapp/conversation-types/).

다음 예제에서는 템플릿을 사용하여를 사용하여 고객에게 [메시지를 보내는](https://docs.aws.amazon.com//social-messaging/latest/APIReference/API_SendWhatsAppMessage.html) 방법을 보여줍니다 AWS CLI. 구성에 대한 자세한 내용은 [AWS Command Line Interface 사용 설명서](https://docs.aws.amazon.com/cli/latest/userguide/)[의 구성을 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) AWS CLI참조하세요.

**참고**  
 AWS CLI 버전 2를 사용할 때는 base64 인코딩을 지정해야 합니다. 이 작업은 AWS CLI 파라미터 추가 `--cli-binary-format raw-in-base64-out` 또는 AWS CLI 전역 구성 파일 변경을 통해 수행할 수 있습니다. 자세한 내용은 버전 2용 명령줄 인터페이스 사용 설명서[https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-settings](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-settings)의 섹션을 참조하세요. *AWS * 

```
aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","to":"'{PHONE_NUMBER}'","type":"template","template":{"name":"statement","language":{"code":"en_US"},"components":[{"type":"body","parameters":[{"type":"text","text":"1000"}]}]}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0
```

위의 명령에서 다음을 수행합니다.
+ *\$1PHONE\$1NUMBER\$1*를 고객의 전화번호로 바꿉니다.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*를 전화번호의 ID로 바꿉니다.

다음 예제에서는 구성 요소가 포함되지 않은 템플릿 메시지를 보내는 방법을 보여줍니다.

```
aws socialmessaging send-whatsapp-message --message '{"messaging_product": "whatsapp","to": "'{PHONE_NUMBER}'","type": "template","template": {"name":"simple_template","language": {"code": "en_US"}}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0
```
+ *\$1PHONE\$1NUMBER\$1*를 고객의 전화번호로 바꿉니다.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*를 전화번호의 ID로 바꿉니다.

# AWS End User Messaging Social에서 미디어 메시지를 보내는 예
<a name="send-message-media"></a>

다음 예제에서는를 사용하여 고객에게 미디어 메시지를 보내는 방법을 보여줍니다 AWS CLI. 구성에 대한 자세한 내용은 [AWS Command Line Interface 사용 설명서](https://docs.aws.amazon.com/cli/latest/userguide/)[의 구성을 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) AWS CLI참조하세요. 지원되는 미디어 파일 유형 목록은 섹션을 참조하세요[WhatsApp에서 지원되는 미디어 파일 유형 및 크기지원되는 미디어 파일 유형](supported-media-types.md).

**참고**  
WhatsApp은 미디어 파일을 삭제하기 전에 30일 동안 저장합니다. *WhatsApp Business Platform Cloud API 참조*의 [미디어 업로드](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#upload-media)를 참조하세요.

1. 미디어 파일을 Amazon S3 버킷에 업로드합니다. 자세한 내용은 [WhatsApp으로 전송할 미디어 파일 업로드](managing-media-files-s3.md) 단원을 참조하십시오.

1. [post-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/post-whatsapp-message-media.html) 명령을 사용하여 미디어 파일을 WhatsApp에 업로드합니다. 성공적으로 완료되면 명령은 미디어 메시지를 보내는 데 필요한 *\$1MEDIA\$1ID\$1*를 반환합니다.

   ```
   aws socialmessaging post-whatsapp-message-media --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID}  --source-s3-file bucketName={BUCKET},key={MEDIA_FILE}
   ```

   위의 명령에서 다음을 수행합니다.
   + *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*를 전화번호의 ID로 바꿉니다.
   + *\$1BUCKET\$1*을 Amazon S3 버킷의 이름으로 바꿉니다.
   + *\$1MEDIA\$1FILE\$1*을 미디어 파일의 이름으로 바꿉니다.

   `--source-s3-presigned-url` 대신를 [사용하여 사전 서명 URL](managing-media-files-s3.md#managing-media-files-s3.title)을 사용하여 업로드할 수도 있습니다`--source-s3-file`. `headers` 필드에 `Content-Type`를 추가해야 합니다. 둘 다 사용하면가 반환`InvalidParameterException`됩니다.

   ```
   --source-s3-presigned-url headers={"Name":"Value"},url=https://BUCKET.s3.REGION/MEDIA_FILE
   ```

1. [send-whatsapp-message](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/send-whatsapp-message.html) 명령을 사용하여 미디어 메시지를 전송합니다.

   ```
   aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","to":"'{PHONE_NUMBER}'","type":"image","image":{"id":"'{MEDIA_ID}'"}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0
   ```
**참고**  
 AWS CLI 버전 2를 사용할 때는 base64 인코딩을 지정해야 합니다. 이 작업은 AWS CLI 파라미터 추가 `--cli-binary-format raw-in-base64-out` 또는 AWS CLI 전역 구성 파일 변경을 통해 수행할 수 있습니다. 자세한 내용은 버전 2용 명령줄 인터페이스 사용 설명서[https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-settings](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-settings)의 섹션을 참조하세요. *AWS *   

   ```
   aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","to":"'{PHONE_NUMBER}'","type":"image","image":{"id":"'{MEDIA_ID}'"}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0 --cli-binary-format raw-in-base64-out
   ```

   위의 명령에서 다음을 수행합니다.
   + *\$1PHONE\$1NUMBER\$1*를 고객의 전화번호로 바꿉니다.
   + *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*를 전화번호의 ID로 바꿉니다.
   + *\$1MEDIA\$1ID\$1*를 이전 단계에서 반환된 미디어 ID로 바꿉니다.

1. 미디어 파일이 더 이상 필요하지 않은 경우 [delete-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/delete-whatsapp-media-message.html) 명령을 사용하여 WhatsApp에서 삭제할 수 있습니다. 이렇게 하면 Amazon S3 버킷이 아닌 WhatsApp에서만 미디어 파일이 제거됩니다.

   ```
   aws socialmessaging delete-whatsapp-message-media --media-id {MEDIA_ID} --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID}
   ```

   위의 명령에서 다음을 수행합니다.
   + *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*를 전화번호의 ID로 바꿉니다.
   + *\$1MEDIA\$1ID\$1*를 미디어 ID로 바꿉니다.