翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS エンドユーザーメッセージングソーシャルを使用して WhatsApp 経由でメッセージを送信する
メッセージを送信する前に、WhatsApp Business Account (WABA) を設定し、ユーザーがユーザーからメッセージを受信するようにオプトインする必要があります。詳細については、「[許可を取得する](whatsapp-best-practices.md#best-practices-whatsapp-obtain-permission)」を参照してください。
ユーザーがメッセージを送信すると、カスタマーサービスウィンドウと呼ばれる 24 時間のタイマーが起動または更新されます。テンプレートメッセージを除くすべてのメッセージタイプは、お客様とユーザーの間でカスタマーサービスウィンドウが開いている場合にのみ送信できます。テンプレートメッセージは、ユーザーがユーザーからのメッセージの受信をオプトインしている限り、いつでも送信できます。
送受信するメッセージごとに、メッセージステータスが生成され、イベント送信先に送信されます。顧客が WhatsApp にサインアップしていない場合、メッセージステータスが のイベントが生成されます`fail`。メッセージ[ステータス](managing-event-destinations-status.md)を受信するには、[メッセージとイベントの宛先](managing-event-destinations.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 でテンプレートメッセージを送信する例
送信できるメッセージテンプレートのタイプの詳細については、*WhatsApp Business Platform Cloud API リファレンス*」の[「メッセージテンプレート](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates)」を参照してください。送信できるメッセージタイプのリストについては、[「WhatsApp Business Platform Cloud API Reference」の「Messages](https://developers.facebook.com/docs/whatsapp/conversation-types/)*WhatsApp*」を参照してください。
次の例は、 テンプレートを使用して を使用して顧客に[メッセージを送信](https://docs.aws.amazon.com//social-messaging/latest/APIReference/API_SendWhatsAppMessage.html)する方法を示しています AWS CLI。の設定の詳細については 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 バージョン 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 でメディアメッセージを送信する例
次の例は、 を使用して顧客にメディアメッセージを送信する方法を示しています AWS CLI。の設定の詳細については 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)の設定」を参照してください。サポートされているメディアファイルタイプのリストについては、「」を参照してください[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 コマンドを使用して、メディアファイルを WhatsApp にアップロードします。 [post-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/post-whatsapp-message-media.html) 正常に完了すると、コマンドはメディアメッセージを送信するために必要な *\$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[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 コマンドを使用して WhatsApp から削除できます。 [delete-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/delete-whatsapp-media-message.html) これにより、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 に置き換えます。