

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.

# Configurar la mensajería WhatsApp empresarial
<a name="whatsapp-integration"></a>

En los temas de esta sección se explica cómo configurar y probar la mensajería WhatsApp empresarial para Amazon Connect. Utiliza [AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/what-is-service.html) para vincular una cuenta WhatsApp empresarial y un número de teléfono a una instancia de Amazon Connect y, a continuación, importar el número de teléfono vinculado a Amazon Connect. Luego, los clientes pueden WhatsApp utilizarlos para enviar mensajes a su centro de llamadas. 

También puede utilizar Amazon Lex para automatizar las respuestas a las preguntas de los clientes, lo que ahorra tiempo y esfuerzo a los agentes. Para obtener más información, consulte [Introducción a Amazon Lex](https://docs.aws.amazon.com/lexv2/latest/dg/getting-started.html) en la *Guía para desarrolladores de Amazon Lex*.

**Topics**
+ [Requisitos previos](#whatsapp-prerequisites)
+ [Paso 1: habilitación de Amazon Connect como destino del evento](#enable-connect-destination)
+ [Paso 2: configuración de un flujo de contactos entrantes en tu número de teléfono](#inbound-contact-flow)
+ [Paso 3: prueba del envío y la recepción de mensajes](#send-receive-test-messages)
+ [Próximos pasos: preparación para el lanzamiento](#whatsapp-next-steps)
+ [Solución de problemas comunes](#whatsapp-troubleshooting)
+ [WhatsApp Capacidades y limitaciones de la mensajería empresarial con Amazon Connect](whatsapp-messaging-capabilities.md)

## Requisitos previos
<a name="whatsapp-prerequisites"></a>

Para poder realizar la integración WhatsApp con Amazon Connect, debe disponer de los siguientes elementos:
+ Una cuenta WhatsApp empresarial.
+ Un número de WhatsApp teléfono. El número debe poder recibir una llamada de voz o un mensaje de texto SMS para completar el proceso de verificación del número de teléfono de Meta para la mensajería WhatsApp empresarial. Puedes usar un número de voz de Amazon Connect o un AWS End User Messaging SMS número como número de WhatsApp teléfono. También puedes usar un número de teléfono que no sea tuyo AWS.

  Si utilizas un número de voz o AWS End User Messaging SMS un número de Amazon Connect, te recomendamos solicitar un número nuevo que no se utilice con el tráfico de voz o SMS en directo para evitar posibles interrupciones del servicio.

  Puede usar la consola social de mensajería para usuarios finales de AWS en [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/)para crear la cuenta WhatsApp empresarial y el número de teléfono. Para obtener más información, consulte Cómo [registrarse WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/getting-started.html#getting-started-embedded) en la *Guía del usuario social de AWS End User Messaging Social*. 

**importante**  
WhatsApp cuenta con un proceso de verificación empresarial automatizado que puede tardar hasta 2 semanas en completarse. Le recomendamos que comience este proceso lo antes posible. WhatsApp puede deshabilitar las cuentas WhatsApp empresariales si se infringe la WhatsApp política empresarial o si no se puede verificar la identidad empresarial.   
Además, le recomendamos encarecidamente que consulte [las prácticas recomendadas para las redes sociales y WhatsApp prácticas [recomendadas](https://business.whatsapp.com/policy#best_practices) de mensajería para usuarios finales de AWS](https://docs.aws.amazon.com/social-messaging/latest/userguide/best-practices.html) antes de crear y vincular WhatsApp recursos. 

Después de crear la cuenta y el número de teléfono, complete los pasos de las siguientes secciones en el orden indicado. 

## Paso 1: habilitación de Amazon Connect como destino del evento
<a name="enable-connect-destination"></a>

En los siguientes pasos se explica cómo utilizar AWS End User Messaging Social para habilitar Amazon Connect como destino del evento para su cuenta WhatsApp empresarial vinculada. Esto permite al sistema importar su número de WhatsApp teléfono.

 Puede utilizar la [consola social de mensajería para el usuario AWS final](https://console.aws.amazon.com/social-messaging/) o la AWS CLI para completar esta tarea. Para utilizarla AWS CLI, consulte [https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html](https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html)la referencia de la *API de Amazon Connect y la referencia [https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html)*de la *API social de mensajería para usuarios AWS finales*.

En los siguientes pasos se explica cómo utilizar la consola.

**Para utilizar la consola de**

1. Inicie sesión en la consola social de mensajería para usuarios finales de AWS en [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/).

1. En el panel de navegación, elija **Cuentas WhatsApp empresariales** y, a continuación, elija la cuenta que desee.

1. En la pestaña **Destino del evento**, seleccione **Editar destino**. 

1.  En **Tipo de destino**, elija **Amazon Connect**. 

1.  Para la **instancia de Connect**, elija su instancia de Amazon Connect en la lista desplegable. 

1.  Para el **ARN del rol**, elija un rol de IAM que conceda permiso para entregar mensajes y eventos y para importar números de teléfono. Para ver ejemplos de políticas de IAM, consulte [Agregar un destino de mensaje y evento a Mensajería social para usuarios finales de AWS](https://docs.aws.amazon.com/social-messaging/latest/userguide/managing-event-destinations-add.html#managing-event-destinations-amazon-connect-policies) en la *Guía del usuario de Mensajería social para usuarios finales de AWS*.  

1. Seleccione **Save changes (Guardar cambios)**.

   Esto inicia el proceso de importación de su número de teléfono en Amazon Connect. 

   Cuando finaliza la operación, el número aparece en el sitio web de administración de Amazon Connect.

**Cómo ver el número**
   + En el menú de navegación, elija **Canales** y, a continuación, **Números de teléfono**. 

     La columna **Canales activos** aparece **WhatsApp**para todos los WhatsApp números.   
![\[La página de números de teléfono que muestra un WhatsApp número.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/whats-app-imported-number.png)

## Paso 2: configuración de un flujo de contactos entrantes en tu número de teléfono
<a name="inbound-contact-flow"></a>

Puedes crear un flujo de contactos entrantes para usarlo con tu número de WhatsApp teléfono o puedes reutilizar un flujo existente. Si reutiliza un flujo, puede agregar un bloque de `CheckContactAttribute` y habilitar la ramificación del flujo. El bloqueo te permite enviar WhatsApp contactos a una cola específica o realizar otra acción.

Para obtener más información sobre cómo crear su flujo de contactos, incluidos los mensajes interactivos y las vistas previas de enlace enriquecido, consulte [WhatsApp Capacidades y limitaciones de la mensajería empresarial con Amazon Connect](whatsapp-messaging-capabilities.md) más adelante en esta sección.

En los siguientes conjuntos de pasos se explica cómo configurar un flujo de contactos entrantes y agregar un bloque `CheckContactAttribute` al flujo.

**Cómo configurar un flujo**

1. Inicie la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)

1. En el menú de navegación, elija **Canales** y, a continuación, **Números de teléfono**. 

1. Elige el WhatsApp número y, a continuación, selecciona **Editar**.

1. En **Flujo/IVR**, elija el flujo que ha actualizado.  
![\[La sección Flujo de contactos/IVR de la página de edición que muestra un WhatsApp flujo.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/whatsapp-flow-ivr.png)

1. Seleccione **Save**.

**Cómo agregar el bloque CheckContactAttribute**

1. Siga los pasos 1 a 4 [de la sesión anterior](#enable-connect-destination).

1. Abra la página de **propiedades** del flujo.

1. En la sección **Atributo que comprobar**, defina **Espacio de nombres** como **Atributos de segmento** y **Clave** como **Subtipo**. Para obtener más información sobre los atributos de segmento, consulte [SegmentAttributes](ctr-data-model.md#segmentattributes) más adelante en esta guía.

1. En la sección **Condiciones a comprobar**, defina la **condición** como **Igual** y **el valor** para **conectarse: WhatsApp**. 

1. Seleccione **Save**.

## Paso 3: prueba del envío y la recepción de mensajes
<a name="send-receive-test-messages"></a>

En este paso, utiliza el Panel de control de contactos (CCP) y un teléfono móvil para enviar y recibir mensajes de WhatsApp prueba. 

**Cómo probar la integración**

1. En el CCP, defina el estado como **Disponible**. 

1. Desde su WhatsApp teléfono móvil, inicie una conversación ingresando el número de teléfono que agregó anteriormente. 

   En la siguiente imagen se muestra un mensaje con **Opciones** y la lista de opciones resultante.  
![\[La pantalla del teléfono móvil con un mensaje de ejemplo.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/whatsapp-options-results.png)

## Próximos pasos: preparación para el lanzamiento
<a name="whatsapp-next-steps"></a>

Después de probar la integración, te recomendamos añadir las siguientes funciones y capacidades a tu canal WhatsApp de mensajería. 

### Adición de características de Amazon Connect
<a name="add-features"></a>

Los enlaces de la siguiente lista le llevan a información sobre las características de Amazon Connect que puede agregar a sus experiencias de clientes y agentes.
+  Más información sobre el [WhatsApp Capacidades y limitaciones de la mensajería empresarial con Amazon Connect](whatsapp-messaging-capabilities.md). 
+  [Permiso para que los clientes reanuden las conversaciones de chat en Amazon Connect](chat-persistence.md): los clientes pueden reanudar conversaciones anteriores manteniendo el contexto, los metadatos y las transcripciones. No es necesario que repitan lo que han dicho cuando vuelven a un chat y los agentes tienen acceso a todo el historial de la conversación. 
+  [Creación de respuestas rápidas para usarlas en los contactos por chat y correo electrónico en Amazon Connect](create-quick-responses.md): proporcione a los agentes respuestas preescritas a las consultas habituales de los clientes para que puedan utilizarlas mientras chatean con los clientes. Las respuestas rápidas permiten que los agentes respondan más rápido a los clientes. 

### Adición de puntos de entrada
<a name="add-entry-points"></a>

Los enlaces de la siguiente lista le llevan a información sobre cómo agregar diferentes tipos de puntos de entrada de clientes.
+ Puntos de entrada: [5 formas de dirigir a los clientes potenciales y a los clientes a las conversaciones de mensajería empresarial](https://business.whatsapp.com/blog/messaging-app-entry-points) (entrada WhatsApp del blog) 
+  Códigos QR: [gestiona el código QR WhatsApp de tu plataforma empresarial](https://business.facebook.com/business/help/890732351439459) (artículo de ayuda de Meta) 
+  Click-to-WhatsAppanuncios: [crea anuncios que hagan clic WhatsApp en el Administrador de anuncios](https://business.facebook.com/business/help/447934475640650?id=371525583593535) (metaartículo de ayuda) 

### Adición de un nombre para mostrar a su número de teléfono
<a name="add-display-name"></a>

Para añadir un nombre visible verificado que vean los clientes, consulta el [nombre visible de WhatsApp About Business](https://business.facebook.com/business/help/338047025165344) en la ayuda de Meta.

### Ampliación del tráfico
<a name="scale-traffic"></a>

Después de incorporar el tráfico en directo a tu WhatsApp integración, te recomendamos que supervises las siguientes cuotas.

**Cuotas de Amazon Connect**  
Para obtener más información acerca de las cuotas predeterminadas y cómo ampliarlas, consulte[Amazon Connect cuotas de servicio](amazon-connect-service-limits.md).
+ Cuota de [Chats activos simultáneos por instancia](amazon-connect-service-limits.md#concurrent-active-chats). Para obtener más información sobre la monitorización de esta cuota, consulte [Supervisión de su instancia de Amazon Connect mediante CloudWatch](monitoring-cloudwatch.md).
+ Cuota de limitación [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html).
+ Cuota de limitación [SendChatIntegrationEvent](https://docs.aws.amazon.com/connect/latest/APIReference/API_SendChatIntegrationEvent.html).
+ Cuota de limitación `SendIntegrationEvent`. Una API solo con permisos utilizada por AWS End User Messaging Social para publicar WhatsApp eventos entrantes.

**Cuotas de mensajería social para usuarios finales**  
AWS End User Messaging Social impone límites de frecuencia en varios mensajes APIs. Supervise lo siguiente APIs para ver si necesita cambiar una o más cuotas. Los enlaces llevan a la *referencia de API de Mensajería social para usuarios finales de AWS*.
+  [SendWhatsAppMessage](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_SendWhatsAppMessage.html)
+  [PostWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PostWhatsAppMessageMedia.html)
+  [GetWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_GetWhatsAppMessageMedia.html)

Para obtener más información sobre cómo aumentar las cuotas de Mensajería social para usuarios finales de AWS, consulte los siguientes temas en la *Guía del usuario de Mensajería social para usuarios finales de AWS*:
+ [Cuotas de Mensajería social para usuarios finales de AWS](https://docs.aws.amazon.com/social-messaging/latest/userguide/quotas.html)
+ [Aumente los límites de mensajería y conversación en WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-limit.html)
+ [Aumente el rendimiento de los mensajes en WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-throughput.html)

## Solución de problemas comunes
<a name="whatsapp-troubleshooting"></a>

Utilice la siguiente información para solucionar problemas comunes relacionados con una WhatsApp integración.

**Topics**
+ [No se pueden ver los números de teléfono importados en su instancia de Amazon Connect.](#no-imported-number)
+ [Los mensajes entrantes de los clientes no se entregan.](#whatsapp-messages-not-delivered)

### No se pueden ver los números de teléfono importados en su instancia de Amazon Connect.
<a name="no-imported-number"></a>

Si el número importado no aparece en el sitio web de administración de Amazon Connect, siga estos pasos:
+ Asegúrese de que el rol de IAM de destino del evento tenga los permisos necesarios. Para obtener más información, consulte [Paso 1: habilitación de Amazon Connect como destino del evento](#enable-connect-destination).
+ Compruebe si es necesario aumentar la cuota de *números de teléfono por instancia*. Para obtener más información, consulte [Amazon Connect cuotas de servicio](amazon-connect-service-limits.md).
+ Para reasignar una cuenta WhatsApp empresarial vinculada a una instancia de Amazon Connect diferente, primero debe liberar los números de teléfono importados de la instancia de Amazon Connect original. Una vez publicados los números de teléfono, puedes actualizar el destino del evento de tu cuenta WhatsApp empresarial vinculada a otra instancia de Amazon Connect.
**importante**  
No libere números que gestionen el tráfico de clientes en directo. En su lugar[, solicite nuevos números de teléfono](https://docs.aws.amazon.com/connect/latest/adminguide/claim-and-manage-phonenumbers.html).
+ Para ayudar a determinar la causa del problema de importación, busca `ImportPhoneNumber` eventos en tus CloudTrail registros y comprueba los detalles del error. Si la llamada de `ImportPhoneNumber` se realiza correctamente, puede llamar a `DescribePhoneNumber` para obtener otros detalles del error.

Si ha corregido el problema, debe volver a importar los números de teléfono. Para ello, repita [Paso 1: habilitación de Amazon Connect como destino del evento](#enable-connect-destination).

### Los mensajes entrantes de los clientes no se entregan.
<a name="whatsapp-messages-not-delivered"></a>

Si se detiene la entrega de los mensajes WhatsApp entrantes, busca en AWS CloudTrail los registros los detalles del error. `SendIntegrationEvent` `SendChatIntegrationEvent`

También puede comprobar estas situaciones habituales:
+ Asegúrese de que su cuenta WhatsApp empresarial vinculada en AWS End User Messaging Social tenga activado un destino para eventos de Amazon Connect.
+ Asegúrese de que el rol de IAM de destino del evento tenga los permisos necesarios. Para obtener más información, consulte [Paso 1: habilitación de Amazon Connect como destino del evento](#enable-connect-destination) mencionado previamente en esta sección. Tiene un rol mal configurado si CloudTrail arroja `AccessDeniedException` errores desde la `SendIntegrationEvent` API. 
+ Asegúrese de que su número de WhatsApp teléfono se importó correctamente a su instancia de Amazon Connect y de que el número tiene un flujo de contactos entrantes asociado. Para obtener más información, consulte [Paso 2: configuración de un flujo de contactos entrantes en tu número de teléfono](#inbound-contact-flow).
+ Los mensajes de entrada se han eliminado porque todavía no se admiten. Para obtener más información, consulte [WhatsApp Capacidades y limitaciones de la mensajería empresarial con Amazon Connect](whatsapp-messaging-capabilities.md). 

# WhatsApp Capacidades y limitaciones de la mensajería empresarial con Amazon Connect
<a name="whatsapp-messaging-capabilities"></a>

La integración de la mensajería WhatsApp empresarial ofrece las siguientes funciones:
+ Mensajes de texto
+ Mensajes interactivos Para obtener más información, consulte [Adición de mensajes interactivos de Amazon Lex para los clientes en el chat](interactive-messages.md).
+ Mensajes con vistas previas de enlaces enriquecidos
+ Confirmación de entrega y lectura de los mensajes comerciales.
+ Archivos adjuntos

## Limitaciones
<a name="whatsapp-messaging-limitations"></a>

Al integrar la mensajería WhatsApp empresarial con Amazon Connect, tenga en cuenta las siguientes limitaciones:

**Limitaciones de confirmación de entrega**
+ No se admiten las confirmaciones de lectura de los mensajes de los clientes.
+ No se admiten las confirmaciones de entrega de los mensajes de los clientes. Los comprobantes de entrega que aparecen en WhatsApp indican que WhatsApp ha recibido el mensaje, no Amazon Connect. 



**Limitaciones de mensajes de texto**
+ No se admiten mensajes de texto entrantes de clientes con más de 1024 caracteres. 



**Tipos de mensajes no admitidos**
+ No se admiten los mensajes de contacto de entrada enviados por los clientes. 
+ No se admiten los mensajes de ubicación de entrada enviados por los clientes. 
+ No se admiten los mensajes de reacción enviados por los clientes. 
+ No se admiten los mensajes de respuesta enviados por los clientes. El contenido del mensaje nuevo se entrega sin el contexto de respuesta. 
+ No se admite la recepción de estados de mensajes que indiquen que el cliente ha eliminado un mensaje. 



**Limitaciones de archivos adjuntos**
+ No se admiten todos los archivos adjuntos de los clientes al iniciar un nuevo contacto o conversación. Los clientes solo pueden enviar archivos adjuntos durante un contacto existente. 
+ No se admiten los archivos adjuntos de clientes de más de 20 MB. 
+ No se admiten archivos adjuntos con subtítulos. Amazon Connect elimina los subtítulos y entrega el archivo adjunto. 
+ No se admiten los stickers. 