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.
# Responder a un mensaje en AWS End User Messaging Social
Para poder recibir un mensaje de texto o multimedia, debes haber configurado tu cuenta WhatsApp empresarial (WABA) y un destino para el evento. Cuando recibes un mensaje entrante, se guarda un evento en el tema Amazon SNS de destino del evento. Para recibir una notificación, debe suscribirse al punto de enlace de temas de Amazon SNS.
Para ver un ejemplo de un mensaje multimedia recibido, consulte[Ejemplo de WhatsApp JSON para recibir un mensaje multimedia](managing-event-destination-dlrs.md#managing-event-destination-dlrs-example-receive-media). 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).
**importante**
Para recibir mensajes entrantes, debe tener los [destinos de los eventos](managing-event-destinations-add.md) habilitados para la WABA. Para obtener más información, consulte [Agregue un mensaje y un destino de evento a AWS End User Messaging Social](managing-event-destinations-add.md).
# Ejemplo de cómo cambiar el estado de un mensaje para que se lea en AWS End User Messaging Social
Puede configurar el [estado del mensaje](managing-event-destinations-status.md) para que muestre `read` al usuario final dos marcas de verificación azules en la pantalla.
```
aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","message_id":"'{MESSAGE_ID}'","status":"read"}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0
```
En el comando anterior, haga lo siguiente.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sustitúyalo por el identificador de tu número de teléfono.
+ *\$1MESSAGE\$1ID\$1*Sustitúyalo por el identificador único del mensaje. Utilice el valor del `id` campo en el objeto de mensaje del tema de Amazon SNS.
# Ejemplo de cómo responder a un mensaje con una reacción en AWS End User Messaging Social
Puedes añadir una reacción al mensaje, como un visto bueno hacia arriba.
```
aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","recipient_type":"individual","to":"'{PHONE_NUMBER}'","type": "reaction","reaction": {"message_id": "'{MESSAGE_ID}'","emoji":"\uD83D\uDC4D"}}' --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.
+ *\$1MESSAGE\$1ID\$1*Sustitúyalo por el identificador único del mensaje. Utilice el valor del `id` campo en el objeto de mensaje del tema de Amazon SNS.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sustitúyalo por el identificador de tu número de teléfono.
# Descargar un archivo multimedia desde WhatsApp Amazon S3
Para recuperar un archivo multimedia y guardarlo en un bucket de Amazon S3, utilice el [get-whatsapp-message-media](https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/get-whatsapp-message-media.html)comando.
```
aws socialmessaging get-whatsapp-message-media --media-id {MEDIA_ID} --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --destination-s3-file bucketName={BUCKET},key=inbound_
{
"mimeType": "image/jpeg",
"fileSize": 78144
}
```
En el comando anterior, haga lo siguiente.
+ *\$1BUCKET\$1*Sustitúyalo por el nombre del bucket de Amazon S3.
+ *\$1MEDIA\$1ID\$1*Sustitúyalo por el valor del `id` campo del evento recibido. Para ver un ejemplo de un evento multimedia entrante, consulte[Ejemplo de WhatsApp JSON para recibir un mensaje multimedia](managing-event-destination-dlrs.md#managing-event-destination-dlrs-example-receive-media).
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sustitúyalo por el identificador de tu número de teléfono.
Para recuperar el contenido multimedia del bucket de Amazon S3, utilice el siguiente comando:
```
aws s3 cp s3://{BUCKET}/inbound_{MEDIA_ID}.jpeg
```
En el comando anterior, haga lo siguiente.
+ *\$1BUCKET\$1*Sustitúyalo por el nombre del bucket de Amazon S3.
+ *\$1MEDIA\$1ID\$1*Sustitúyalo por el MEDIA\$1ID devuelto en el paso anterior.
# Ejemplo de respuesta a un mensaje con una confirmación de lectura y una reacción
En este ejemplo, tu cliente, Diego, te envió un mensaje diciendo «Hola» y tú le respondes con un recibo leído y un emoji con la mano.
## Requisitos previos
Para recibir una notificación de que Diego ha enviado un mensaje, debes haber configurado un tema de Amazon SNS de destino para eventos y suscribirte a un punto de enlace del tema.
## Respondiendo
1. Cuando se recibe el mensaje de Diego, se publica un evento en los puntos finales del tema. El siguiente es un fragmento de lo que publica el tema.
**nota**
El hecho de que Diego haya iniciado la conversación no se descontará de la cuota de conversaciones iniciadas por tu empresa.
`whatsAppWebhookEntry`En este ejemplo, se muestra en notación JSON. Para ver un ejemplo de cómo `whatsAppWebhookEntry` convertir la cadena JSON a JSON, consulte[Ejemplo de WhatsApp JSON para recibir un mensaje](managing-event-destination-dlrs.md#managing-event-destination-dlrs-example-receive-text).
```
{
"context": {
"MetaWabaIds": [
{
"wabaId": "1234567890abcde",
"arn": "arn:aws:social-messaging:us-east-1:123456789012:waba/fb2594b8a7974770b128a409e2example"
}
],
"MetaPhoneNumberIds": [
{
"metaPhoneNumberId": "abcde1234567890",
"arn": "arn:aws:social-messaging:us-east-1:123456789012:phone-number-id/976c72a700aac43eaf573ae050example"
}
]
},
"whatsAppWebhookEntry": "{\"...JSON STRING....",
"aws_account_id": "123456789012",
"message_timestamp": "2025-01-08T23:30:43.271279391Z"
}
//Decoding the contents of whatsAppWebhookEntry
{
"id": "365731266123456",
"changes": [
{
"value": {
"messaging_product": "whatsapp",
"metadata": {
"display_phone_number": "12065550100",
"phone_number_id": "321010217712345"
},
"contacts": [
{
"profile": {
"name": "Diego"
},
"wa_id": "12065550102"
}
],
"messages": [
{
"from": "14255550150",
"id": "wamid.HBgLMTQyNTY5ODgzMDIVAgASGCBDNzBDRjM5MDU2ODEwMDkwREY4ODBDRDE0RjVGRkexample",
"timestamp": "1723506035",
"text": {
"body": "Hi"
},
"type": "text"
}
]
},
"field": "messages"
}
]
}
```
1. Para mostrarle a Diego que has recibido el mensaje, establece el estado en`read`. Diego verá dos marcas de verificación azules junto al mensaje en su dispositivo.
**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","message_id":"'{MESSAGE_ID}'","status":"read"}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0
```
En el comando anterior, haga lo siguiente.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sustitúyalo por el identificador del número de teléfono al que Diego envió su mensaje`phone-number-id-976c72a700aac43eaf573ae050example`.
+ *\$1MESSAGE\$1ID\$1*Sustitúyalo por el identificador único del mensaje. Es el mismo valor del `id` campo del mensaje recibido`wamid.HBgLMTQyNTY5ODgzMDIVAgASGCBDNzBDRjM5MDU2ODEwMDkwREY4ODBDRDE0RjVGRkexample`.
1. Puedes enviarle a Diego una reacción con la mano.
```
aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","recipient_type":"individual","to":"'{PHONE_NUMBER}'","type": "reaction","reaction": {"message_id": "'{MESSAGE_ID}'","emoji":"\uD83D\uDC4B"}}' --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 Diego,`14255550150`.
+ *\$1MESSAGE\$1ID\$1*Sustitúyalo por el identificador único del mensaje. Es el mismo valor del `id` campo del mensaje recibido`wamid.HBgLMTQyNTY5ODgzMDIVAgASGCBDNzBDRjM5MDU2ODEwMDkwREY4ODBDRDE0RjVGRkexample`.
+ *\$1ORIGINATION\$1PHONE\$1NUMBER\$1ID\$1*Sustitúyalo por el número de teléfono al que Diego envió su mensaje:`phone-number-id-976c72a700aac43eaf573ae050example`.
## Recursos adicionales
+ Habilite [los destinos de eventos](managing-event-destinations.md) para registrar eventos y recibir mensajes entrantes.
+ Para obtener una lista de los objetos de los WhatsApp mensajes, consulte la *referencia sobre los [mensajes](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/messages#message-object) en la API de WhatsApp Business Platform Cloud*.