

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Envío de mensajes a través WhatsApp de AWS End User Messaging Social
<a name="whatsapp-send-message"></a>

Antes de enviar un mensaje, debes configurar tu cuenta WhatsApp empresarial (WABA) y tu usuario debe aceptar recibir tus mensajes. Para obtener más información, consulte [Obtención de permiso](whatsapp-best-practices.md#best-practices-whatsapp-obtain-permission). 

Cuando un usuario te envía un mensaje, se activa o se actualiza un temporizador de 24 horas denominado ventana de servicio al cliente. Todos los tipos de mensajes, excepto los mensajes de plantilla, solo se pueden enviar cuando hay una ventana de servicio al cliente abierta entre usted y el usuario. Los mensajes de plantilla se pueden enviar en cualquier momento, siempre que el usuario haya optado por recibir mensajes tuyos.

Para cada mensaje que envíes o recibas, se genera un estado de mensaje y se envía al destino del evento. Si su cliente no se ha registrado WhatsApp, se generará un evento con el estado del mensaje de`fail`. Debes activar un [destino de mensajes y eventos](managing-event-destinations.md) para recibir el [estado del mensaje](managing-event-destinations-status.md).

Para obtener una lista de los tipos de mensajes, consulte la *referencia sobre los [mensajes](https://developers.facebook.com/docs/whatsapp/conversation-types/) en la API de WhatsApp Business Platform Cloud*. 

**importante**  
El uso de la solución WhatsApp empresarial está sujeto a los términos y condiciones de las condiciones del [servicio WhatsApp empresarial, las condiciones de](https://www.whatsapp.com/legal/business-terms) la [solución WhatsApp empresarial](https://www.whatsapp.com/legal/business-solution-terms), la [política de mensajería WhatsApp empresarial](https://business.whatsapp.com/policy), [las directrices de WhatsApp mensajería](https://www.whatsapp.com/legal/messaging-guidelines) y todos los demás términos, políticas o directrices que se incorporen a las mismas como referencia. Es posible que se actualicen de vez en cuando. 
Meta o WhatsApp puede prohibir en cualquier momento el uso de la solución WhatsApp empresarial.
En relación con su uso de la Solución WhatsApp empresarial, no presentará ningún contenido, información o dato que esté sujeto a medidas de protección o a limitaciones de distribución de conformidad con las leyes o reglamentos aplicables.

**Topics**
+ [Ejemplo de envío de una plantilla de mensaje en AWS End User Messaging Social](send-message-text.md)
+ [Ejemplo de envío de un mensaje multimedia en AWS End User Messaging Social](send-message-media.md)

# Ejemplo de envío de una plantilla de mensaje en AWS End User Messaging Social
<a name="send-message-text"></a>

Para obtener más información sobre los tipos de plantillas de mensajes que se pueden enviar, consulte la [plantilla de mensajes](https://developers.facebook.com/docs/whatsapp/cloud-api/guides/send-message-templates) en la *referencia de la API de WhatsApp Business Platform Cloud*. Para obtener una lista de los tipos de mensajes que se pueden enviar, consulte la *referencia [sobre los mensajes](https://developers.facebook.com/docs/whatsapp/conversation-types/) en la API de WhatsApp Business Platform Cloud*. 

El siguiente ejemplo muestra cómo utilizar una plantilla para [enviar un mensaje](https://docs.aws.amazon.com//social-messaging/latest/APIReference/API_SendWhatsAppMessage.html) a su cliente mediante AWS CLI. Para obtener más información sobre cómo configurar el AWS CLI, consulte [Configurar el AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) en la [Guía del AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/).

**nota**  
Debe especificar la codificación base64 cuando utilice la AWS CLI versión 2. Esto se puede hacer añadiendo el AWS CLI parámetro `--cli-binary-format raw-in-base64-out` o cambiando el archivo de configuración AWS CLI global. Para obtener más información, consulte [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)la *Guía del usuario de la interfaz de línea de AWS comandos de la versión 2*.

```
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
```

En el comando anterior, haga lo siguiente.
+ *\$1PHONE\$1NUMBER\$1*Sustitúyalo por el número de teléfono de tu cliente.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sustitúyalo por el identificador de tu número de teléfono.

El siguiente ejemplo muestra cómo enviar un mensaje de plantilla que no contiene ningún componente.

```
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*Sustitúyalo por el número de teléfono de tu cliente.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sustitúyalo por el identificador de tu número de teléfono.

# Ejemplo de envío de un mensaje multimedia en AWS End User Messaging Social
<a name="send-message-media"></a>

El siguiente ejemplo muestra cómo enviar un mensaje multimedia a su cliente mediante el AWS CLI. Para obtener más información sobre la configuración del AWS CLI, consulte [Configurar el AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) en la [Guía del AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/). Para obtener una lista de los tipos de archivos multimedia compatibles, consulte[Tipos y tamaños de archivos multimedia compatibles en WhatsAppTipos de archivos multimedia compatibles](supported-media-types.md).

**nota**  
WhatsApp almacena los archivos multimedia durante 30 días antes de eliminarlos; consulte la *referencia [sobre cómo subir contenido multimedia](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#upload-media) en la API de WhatsApp Business Platform Cloud*.

1. Cargue el archivo multimedia en un bucket de Amazon S3. Para obtener más información, consulte [Cargar archivos multimedia para enviarlos con WhatsApp](managing-media-files-s3.md).

1. Cargue el archivo multimedia WhatsApp mediante el [post-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/post-whatsapp-message-media.html)comando. Al finalizar correctamente, el comando devolverá el*\$1MEDIA\$1ID\$1*, que es necesario para enviar el mensaje multimedia.

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

   En el comando anterior, haga lo siguiente.
   + *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sustitúyala por la ID de tu número de teléfono.
   + *\$1BUCKET\$1*Sustitúyalo por el nombre del bucket de Amazon S3.
   + *\$1MEDIA\$1FILE\$1*Sustitúyalo por el nombre del archivo multimedia. 

   También puede cargarlo mediante una [URL prefirmada](managing-media-files-s3.md#managing-media-files-s3.title) utilizando `--source-s3-presigned-url` en lugar de`--source-s3-file`. Debe añadirlo `Content-Type` en el `headers` campo. Si usa ambos, `InvalidParameterException` se devuelve un.

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

1. Utilice el [send-whatsapp-message](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/send-whatsapp-message.html)comando para enviar el mensaje multimedia.

   ```
   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
   ```
**nota**  
Debe especificar la codificación base64 cuando utilice la AWS CLI versión 2. Esto se puede hacer añadiendo el AWS CLI parámetro `--cli-binary-format raw-in-base64-out` o cambiando el archivo de configuración AWS CLI global. Para obtener más información, consulte [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)la *Guía del usuario de la interfaz de línea de AWS comandos de la versión 2*.  

   ```
   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
   ```

   En el comando anterior, haga lo siguiente.
   + *\$1PHONE\$1NUMBER\$1*Sustitúyalo por el número de teléfono de tu cliente.
   + *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sustitúyalo por el identificador de tu número de teléfono.
   + *\$1MEDIA\$1ID\$1*Sustitúyalo por el identificador multimedia devuelto en el paso anterior. 

1. Cuando ya no necesite el archivo multimedia, puede eliminarlo WhatsApp mediante el [delete-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/delete-whatsapp-media-message.html)comando. Esto solo elimina el archivo multimedia del bucket WhatsApp de Amazon S3, no de él.

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

   En el comando anterior, haga lo siguiente.
   + *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sustitúyalo por el ID de tu número de teléfono.
   + *\$1MEDIA\$1ID\$1*Sustitúyalo por el identificador multimedia. 