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.
# Configuración de la integración de aplicaciones destacadas en Amazon Connect
Estas integraciones utilizan aplicaciones destacadas de Amazon Connect para proporcionar actualizaciones periódicas a Perfiles de clientes de Amazon Connect.
## Antes de empezar
### Ingesta en bloque de datos
Cuando configure su integración, se le pedirá que introduzca una fecha hasta la que desee retroceder para la ingesta de datos. Si elige una fecha de hace más de dos meses, Perfiles de clientes habilita automáticamente la ingesta masiva mediante la creación de varios flujos. Lo hace para que no tenga que calcular cuántos flujos necesita para la ingesta de datos.
Cuando la ingesta en bloque automática está habilitada, Perfiles de clientes hace lo siguiente:
+ Establece el tamaño del lote en dos meses.
+ Hace tres reintentos en errores transitorios antes de fallar.
Puedes usar la [CreateIntegrationWorkflowRequest](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/CreateIntegrationWorkflowRequest .html)API para calcular tu propio tamaño de lote.
### ¿Por qué se me pide que seleccione o cree un rol de IAM?
En el caso de Salesforce, Marketo y Customer Profiles ServiceNow, ayuda a mejorar el registro histórico de estas fuentes, ya que utiliza su función de IAM para crear varios flujos de trabajo que le permitan procesar sus datos de forma rápida y eficiente.
Para estos orígenes, si selecciona más de 60 días atrás en el selector **Fecha de importación de los registros**, se le pedirá que cree un nuevo rol de IAM o que seleccione uno existente. Este rol permite a Perfiles de clientes administrar su integración. Proporciona a Perfiles de clientes los permisos necesarios para actualizar y crear un flujo de trabajo para la ingesta de sus datos. Una vez completado el flujo de trabajo, Perfiles de clientes crea una integración estándar y continua que realiza la ingesta de sus nuevos datos a medida que se actualizan en su origen.
El rol creado en la consola solo lo puede utilizar el dominio en el que se creó. Esto se debe a que Amazon Connect limita el acceso del rol solo a la clave de KMS que utiliza el dominio.
Para obtener más información, consulte [Concesión de acceso de privilegio mínimo a su rol de ejecución de Perfiles de clientes](#grant-least-privilege-cp).
## Concesión de acceso de privilegio mínimo a su rol de ejecución de Perfiles de clientes
Si desea crear su propio rol de IAM, le recomendamos que utilice los permisos que se muestran en el siguiente código para limitar el rol a los permisos mínimos necesarios. Utilice el siguiente fragmento para crear su rol manualmente. Utilice su propia clave de KMS y especifique su región cuando sea necesario.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:RequestTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:CreateFlow",
"appflow:TagResource",
"profile:TagResource",
"profile:PutIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "CreateFlowResources"
},
{
"Action": [
"appflow:UseConnectorProfile"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "UseConnectorResources"
},
{
"Condition": {
"ForAnyValue:StringEquals": {
"aws:ResourceTag/awsOwningService": "customer-profiles-integration-workflow"
}
},
"Action": [
"appflow:DescribeFlow",
"appflow:DescribeFlowExecutionRecords",
"appflow:DeleteFlow",
"appflow:StartFlow",
"appflow:StopFlow",
"appflow:UpdateFlow",
"profile:DeleteIntegration"
],
"Resource": "*",
"Effect": "Allow",
"Sid": "AccessFlowResources"
},
{
"Action": [
"kms:CreateGrant",
"kms:ListGrants"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"appflow.us-east-1.amazonaws.com"
]
}
},
"Effect": "Allow",
"Sid": "KMSAppflow"
},
{
"Action": [
"kms:CreateGrant"
],
"Resource": [
"arn:aws:kms:us-east-1:111122223333:key/KeyId"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"profile.us-east-1.amazonaws.com"
]
},
"ForAllValues:StringEquals": {
"kms:GrantOperations": [
"Decrypt"
]
}
},
"Effect": "Allow",
"Sid": "KMSCustomerProfiles"
}
]
}
```
------
## Monitoreo de sus integraciones de Perfiles de clientes
Una vez establecida la conexión, si deja de funcionar, elimine la integración y vuelva a establecerla.
## Qué hacer si no se envían objetos
Si no se realiza el envío de un objeto, elija **Detalles del flujo** para obtener más información sobre el error.
Puede que tenga que eliminar la configuración y volver a conectarse a la aplicación externa.
# Configuración de la integración de Amazon Connect Cases
Para actualizar Amazon Connect los datos de sus casos en los perfiles de clientes de Amazon Connect y utilizar funciones como los atributos calculados, puede realizar la integración mediante Amazon AppIntegrations. Comience por configurar una transmisión de eventos de Cases para enviar los campos del sistema a un EventBridge autobús y, a continuación, utilice Amazon AppIntegrations para reenviar estos eventos a los perfiles de los clientes.
## Transmisión de datos desde Amazon Connect Cases a EventBridge
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[El alias de la instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-1.png)
1. En el panel de navegación, seleccione **Casos** y anote su ID de dominio de Cases en la sección **Detalles del dominio**.
![\[En la página Casos, en la sección Detalles del dominio, una flecha apunta hacia el ID del dominio.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-2.png)
1. Con AWS CLI, cree una configuración de eventos de casos para enviar los eventos de Amazon Connect Cases al bus Cuenta de AWS de Event Bridge predeterminado.
```
// set up Case Event Configuration including all system fields
aws connectcases put-case-event-configuration --domain-id --region --event-bridge "{
\"enabled\": true,
\"includedData\": {
\"caseData\": {
\"fields\": [
{
\"id\": \"status\"
},
{
\"id\": \"title\"
},
{
\"id\": \"summary\"
},
{
\"id\": \"reference_number\"
},
{
\"id\": \"created_datetime\"
},
{
\"id\": \"last_updated_datetime\"
},
{
\"id\": \"last_closed_datetime\"
},
{
\"id\": \"customer_id\"
}
]
}
}
}"
```
1. Abra la consola de Event Bridge de su AWS región. Por ejemplo, [¿https://us-west-2.console.aws.amazon.com/events/en casa? region=us-west-2\$1/eventbuses](https://us-west-2.console.aws.amazon.com/events/home?region=us-west-2#/eventbuses)
1. Seleccione **Crear bus de eventos**.
![\[La página de autobuses de eventos de la EventBridge consola de Amazon, el botón Crear bus de eventos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-3.png)
1. Cree un bus de eventos con el nombre `connect-cases-to-customer-profiles`.
![\[La página Crear bus de eventos con el cuadro Nombre.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-4.png)
1. Vuelva al **bus de eventos predeterminado** y cree una regla con el nombre `connect-cases-to-customer-profiles-rule`.
![\[El bus de eventos predeterminado con el botón Crear regla.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-5.png)
![\[El paso Crear patrón de eventos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-6.png)
+ Fragmento de Patrón de eventos:
```
{
"source": ["aws.cases"],
"detail": {
"eventType": ["CASE.UPDATED", "CASE.CREATED", "CASE.DELETED"]
}
}
```
![\[La sección Método de creación con la opción Patrón personalizado (editor JSON) y el código del patrón de eventos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-7.png)
+ Seleccione **Saltar a revisar y crear** y elija **Crear regla**.
![\[El botón Saltar a revisar y crear.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/stream-data-from-connect-cases-to-event-bridge-8.png)
## Introduzca los datos de los casos de Event Bridge en los perfiles de los clientes mediante AppIntegrations
1. Con el AWS CLI, cree una integración de eventos con AppIntegrations y registre la salida del ARN. Esto representa un origen de datos que puede utilizar una instancia de Amazon Connect.
```
aws appintegrations create-event-integration --region
--name Connect-Cases-Event-Integration
--event-bridge-bus connect-cases-to-customer-profiles --event-filter
"{\"Source\": \"aws.cases\" }"
--description "Event Integration for Cases Event Bus"
```
1. Con el AWS CLI, cree una integración con los perfiles de los clientes mediante la API put-integration. Esto iniciará el flujo de datos hacia Perfiles de clientes y sustituirá los valores de los marcadores de posición por el ARN de integración de eventos y el nombre de dominio del perfil del cliente.
```
aws customer-profiles put-integration --region
--domain-name
--uri --object-type-name Connect-case
```
## Verificación de la integración de Casos
1. Cree un caso en Amazon Connect Cases.
1. La entrega del evento debe ser casi instantánea, pero espere un minuto a que se entregue y asóciela con un perfil de cliente.
1. Con el AWS CLI, busque el objeto Connect-case debajo del perfil y sustituya los marcadores de posición por los valores correctos.
```
aws customer-profiles list-profile-objects --domain-name
--region
--object-type-name Connect-case --profile-id
```
1. Si no encuentra ningún elemento en la respuesta a la llamada a la API anterior, significa que hay un problema con su integración. Para solucionar el problema:
1. Ve a la EventBridge consola de Amazon.
1. Comprueba si EventSource está activo y si la coincidencia EventBus existe y se está ejecutando.
1. Compruebe si la configuración de eventos de su caso está configurada correctamente.
1. Si funcionan, ponte en contacto con nosotros Soporte para obtener ayuda para investigar el problema.
# Configura la integración de Amazon Connect con Salesforce ServiceNow, Marketo o Zendesk
Para proporcionar actualizaciones periódicas a los perfiles de los clientes de Amazon Connect, puede realizar la integración con Salesforce ServiceNow, Marketo o Zendesk mediante Amazon. AppFlow Primero debe configurar la conexión en Amazon Connect y la aplicación de su elección y, a continuación, verificar la integración.
## Configurar la conexión en Amazon Connect y Salesforce ServiceNow, Marketo o Zendesk
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[Página de instancias del centro de contacto virtual de Amazon Connect, alias de instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/instance.png)
1. En el panel de navegación, elija **Perfiles de clientes**.
1. En la página **Configuración de perfiles de clientes**, elija **Agregar integración**, como se muestra en la imagen siguiente.
![\[Página Configuración de perfiles de clientes, botón Agregar integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. En la página **Seleccionar origen de datos**, elija de qué aplicación externa desea obtener los datos de los perfiles de clientes. Puede ver los [requisitos de integración](https://docs.aws.amazon.com/appflow/latest/userguide/requirements.html) para comprender mejor los requisitos de conexión necesarios para su aplicación.
![\[Página Seleccionar origen de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-cp-salesforce-source.png)
1. En la página **Establecer conexión**, elija una de las siguientes opciones:
+ **Utilizar la conexión existente**: esto le permite reutilizar AppFlow los recursos de Amazon existentes que haya creado en su cuenta de AWS.
+ **Crear nueva conexión**: introduzca la información que requiera la aplicación externa.
![\[Página Establecer conexión.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-establish-connection.png)
1. En la página **Opciones de integración**, elija los objetos de origen de los que desea realizar la ingesta y seleccione su tipo de objeto.
Los tipos de objetos almacenan los datos ingeridos. También definen cómo se asignan los objetos de sus integraciones a los perfiles cuando se ingieren. Perfiles de clientes proporciona plantillas predeterminadas de tipos de objetos que puede utilizar y que definen cómo se asignan los atributos de sus objetos de origen a los objetos estándar en Perfiles de clientes. También puede utilizar las asignaciones de objetos que ha creado a partir de. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html) Cuando agregue o cree la integración de Salesforce para la asignación de datos creada por el usuario, deberá especificar la asignación de datos específica; de lo contrario, elegirá la asignación de datos predeterminada de Salesforce para el tipo de objeto. Puede crear su asignación de datos y utilizarla cuando establezca un conector de datos destacado.
![\[La página de opciones de integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-integration-options.png)
1. Para la **Fecha de inicio de la ingesta**, Perfiles de clientes comienza la ingesta de los registros creados después de esta fecha. De forma predeterminada, la fecha de importación de registros se establece 30 días antes.
1. En la página **Revisar e integrar**, compruebe que el **Estado de la conexión** sea **Conectado** y, a continuación, seleccione **Crear integración**.
![\[Página Revisar e integrar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-review-and-integrate.png)
1. Una vez configurada la integración, vuelva a la página **Configuración de perfiles de clientes** y seleccione **Ver objetos** para ver qué datos se están agrupando y enviando. Actualmente, este proceso realiza la ingesta de los registros que se crearon o modificaron en los últimos 30 días.
![\[Página Configuración de perfiles de clientes.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-objects.png)
# Configuración de la integración de Segment para proporcionar actualizaciones periódicas a Perfiles de clientes de Amazon Connect
Para proporcionar actualizaciones periódicas a los perfiles de los clientes de Amazon Connect, puedes integrarlos con Segment mediante Amazon AppFlow. Primero debe configurar la conexión en Amazon Connect y Segment; a continuación, verificar la integración de Segment.
## Configuración de la conexión en Amazon Connect y Segment
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[Página de instancias del centro de contacto virtual de Amazon Connect, alias de instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/instance.png)
1. En el panel de navegación, elija **Perfiles de clientes**.
1. En la página **Configuración de perfiles de clientes**, elija **Agregar integración**.
![\[Página Configuración de perfiles de clientes, botón Agregar integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. En la página **Seleccionar origen de datos**, elija **Segment**. Revise los requisitos de solicitud que aparecen en la página **Seleccionar aplicación**.
![\[Página Seleccionar origen de datos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-cp-segment-source.png)
1. En la página **Establecer conexión**, elija una de las siguientes opciones:
+ **Usa la conexión existente**: esto te permite reutilizar EventBridge los recursos de Amazon existentes que hayas creado en tu Cuenta de AWS.
+ **Crear nueva conexión**: introduzca la información que requiera la aplicación externa.
![\[Página Establecer conexión.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-segment-establish-connection.png)
+ **Nombre de la conexión**: proporcione un nombre para la conexión. Las integraciones que utilizan esta conexión hacen referencia al nombre de la conexión.
+ **URL de conexión**: introduzca la URL de conexión de la aplicación. Esta URL se utiliza para establecer enlaces profundos a los objetos creados en la aplicación externa. La URL de conexión es la URL del espacio de trabajo de Segment disponible en el sitio web de la aplicación.
Para encontrar la URL de su espacio de trabajo:
1. Inicie sesión en su cuenta de segment.com.
1. Vaya a **Configuración**, **Configuración general**.
1. Copie la URL del navegador.
1. Customer Profiles utiliza Amazon EventBridge para las integraciones con Segment. En la página de **configuración de Source**, copia tu Cuenta de AWS ID en el portapapeles y, a continuación, selecciona **Log in to Segment** para configurar Amazon EventBridge.
1. Utilice las siguientes instrucciones para configurar Segment:
1. Inicie sesión en Segment.
1. En tu aplicación, selecciona una fuente para configurar el destino en Amazon EventBridge.
1. Pega tu Cuenta de AWS ID y selecciona tu AWS región.
1. Cambie a **ACTIVAR**, para activar el origen de evento de socio.
1. Vaya a **Evaluador de eventos** y envíe un evento de prueba para completar la activación del origen de evento de socio.
1. **ID de cliente**: es una cadena que distingue de forma única al cliente en la aplicación externa. Este ID de cliente es el nombre de origen disponible en el sitio web de la aplicación. Utilizará el ID que especifique para identificar al cliente del que desea que Perfiles de clientes ingiera sus objetos.
Para encontrar el ID de origen:
1. Vaya a **Orígenes** y elija un origen.
1. Vaya a **Configuración**, **Claves de API**.
1. Copie su **ID de origen**.
Tras configurar el destino de origen de evento, vuelva a la consola de Perfiles de clientes y pegue el ID de cliente.
1. Verá una alerta que indica que Amazon Connect se ha conectado correctamente con Segment.
1. En la página **Opciones de integración**, elija los objetos de origen de los que desea realizar la ingesta y seleccione su tipo de objeto.
Los tipos de objetos almacenan los datos ingeridos. También definen cómo se asignan los objetos de sus integraciones a los perfiles cuando se ingieren. Perfiles de clientes proporciona plantillas predeterminadas de tipos de objetos que puede utilizar y que definen cómo se asignan los atributos de sus objetos de origen a los objetos estándar en Perfiles de clientes. También puedes usar las asignaciones de objetos que has creado a partir de. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[Página Opciones de integración, sección Tipo de objeto.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-integration-options-segment.png)
1. Para la **Fecha de inicio de la ingesta**, Perfiles de clientes comienza la ingesta de los registros creados después de agregar la integración.
**nota**
Si necesita registros históricos, puede [utilizar Amazon S3 como origen de integración para importarlos](customer-profiles-object-type-mappings.md).
1. En la página **Revisar e integrar**, compruebe que el **Estado de la conexión** sea **Conectado** y, a continuación, seleccione **Agregar integración**.
1. Una vez configurada la integración, de vuelta en la página **Configuración de perfiles de clientes**, la página **Integraciones** muestra las integraciones que están actualmente configuradas. La **Última ejecución** y el **Estado de integración** no están disponibles actualmente para este tipo de integración.
![\[Página Configuración de perfiles de clientes, sección Integraciones.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Para ver qué datos se están enviando, elija la integración y, a continuación, seleccione **Ver objetos**.
## Verificación de la integración de Segment
Para realizar este paso, necesita los siguientes requisitos previos:
+ Acceda a su espacio de trabajo de Segment.
+ [Acceda al panel de control de contactos de Amazon Connect](amazon-connect-contact-control-panel.md).
**Para verificar la integración de Segment**
1. Vaya al panel de su espacio de trabajo de Segment y elija **Destinos**.
![\[Página de descripción general de Segment.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-segment-1.png)
1. Verá una lista de destinos a los que Segment envía datos. Elija el EventBridge destino de los perfiles de los clientes.
![\[Página de la lista de destinos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-segment-2.png)
1. Seleccione la pestaña **Evaluador de eventos**. Desde esta página, enviará un evento de prueba a Perfiles de clientes. Se realiza la ingesta del evento y se convierte en un perfil de cliente que puede consultar en la aplicación del agente de Amazon Connect.
![\[Pestaña del evaluador de eventos.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-segment-3.png)
1. Seleccione **Identificar** como tipo de evento y seleccione **Generador de eventos** como método de entrada.
1. Puede especificar un **seudónimo** y algunas características. Los agentes pueden buscar estas características en la aplicación del agente.
1. Elija **Enviar evento**.
1. La entrega del evento debe ser casi instantánea, pero espere un minuto a que se entregue y cree un perfil de cliente.
1. Abra la aplicación de agente de Amazon Connect. Busque el ID de usuario que introdujo en el **Generador de eventos**. Debería ver el perfil del cliente con el ID de usuario y las características que ha introducido.
1. Si no ve el perfil del cliente, significa que hay un problema con su integración. Para solucionar el problema:
1. Ve a la EventBridge consola de Amazon.
1. Comprueba si EventSource está activo y si la coincidencia EventBus existe y se está ejecutando.
Si funcionan, ponte en contacto con nosotros Soporte para obtener ayuda para investigar el problema.
## Monitoreo de sus integraciones de Perfiles de clientes
Una vez establecida la conexión, si deja de funcionar, elimine la integración y vuelva a establecerla.
## Qué hacer si no se envían objetos
Si no se realiza el envío de un objeto, elija **Detalles del flujo** para obtener más información sobre el error.
Puede que tenga que eliminar la configuración y volver a conectarse a la aplicación externa.
# Configuración de la integración de Shopify para proporcionar actualizaciones periódicas a Perfiles de clientes de Amazon Connect
Para proporcionar actualizaciones periódicas a los perfiles de los clientes de Amazon Connect, puedes integrarte con Shopify mediante Amazon AppIntegrations. Primero debe configurar la conexión en Amazon Connect y Shopify; a continuación, verificar la integración de Shopify.
## Configuración de la conexión en Amazon Connect y Shopify
1. Abra la consola Amazon Connect en [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).
1. En la página de instancias, elija el alias de instancia. El alias de instancia también es su **nombre de instancia**, que aparece en su URL de Amazon Connect. En la siguiente imagen se muestra la página de **instancias del centro de contacto virtual de Amazon Connect**, con un recuadro alrededor del alias de instancia.
![\[Página de instancias del centro de contacto virtual de Amazon Connect, alias de instancia.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/instance.png)
1. En el panel de navegación, elija **Perfiles de clientes**.
1. En la página **Configuración de perfiles de clientes**, elija **Agregar integración**.
![\[Página Configuración de perfiles de clientes, botón Agregar integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-addintegration.png)
1. En la página **Seleccionar origen**, seleccione **Shopify**. Revise los requisitos de solicitud que aparecen en la página **Seleccionar aplicación**.
![\[La página de selección de origen.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-cp-shopify-source.png)
1. En la página **Establecer conexión**, elija una de las siguientes opciones:
+ **Usa la conexión existente**: esto te permite reutilizar EventBridge los recursos de Amazon existentes que hayas creado en tu Cuenta de AWS.
+ **Crear nueva conexión**: introduzca la información que requiera la aplicación externa.
![\[Página Establecer conexión.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-shopify-establish-connection.png)
+ **Nombre de la conexión**: proporcione un nombre para la conexión. Las integraciones que utilizan esta conexión hacen referencia al nombre de la conexión.
+ **URL de conexión**: introduzca la URL de conexión de la aplicación. Esta URL se utiliza para establecer enlaces profundos a los objetos creados en la aplicación externa. La URL de conexión es la URL de la aplicación de Shopify Partner disponible en el sitio web de la aplicación.
Para encontrar la URL de su aplicación de Shopify Partner:
+ Inicie sesión en su cuenta de partners.shopify.com.
+ Vaya a la aplicación.
+ Copie la URL del navegador.
+ **ID de cliente**: introduzca el ID de cliente de la aplicación. Es una cadena que distingue de forma única al cliente en la aplicación externa. Este ID de cliente es el nombre de origen disponible en el sitio web de la aplicación. Utilizará el ID que especifique aquí para identificar al cliente del que desea que Perfiles de clientes ingiera sus objetos. Su ID de cliente puede estar disponible después de seguir los pasos de configuración de origen.
Para encontrar su nombre de origen:
+ Inicie sesión en su cuenta de partners.shopify.com.
+ Vaya a la aplicación.
+ Copia el nombre de la fuente de tus EventBridge eventos de Amazon.
1. En la página de **configuración de la fuente**, copia tu Cuenta de AWS ID en el portapapeles y, a continuación, selecciona **Iniciar sesión en Shopify**.
1. Utilice las siguientes instrucciones para configurar Shopify:
1. Inicie sesión en partners.shopify.com.
1. En Amazon EventBridge, selecciona **Crear fuente**.
1. Pega tu Cuenta de AWS ID y selecciona tu AWS región.
1. Tras configurar el destino de origen de evento, vuelva a Perfiles de clientes. Verá una alerta que indica que Amazon Connect se ha conectado correctamente con Shopify.
1. En la página **Opciones de integración**, elija los objetos de origen de los que desea realizar la ingesta y seleccione su tipo de objeto.
Los tipos de objetos almacenan los datos ingeridos. También definen cómo se asignan los objetos de sus integraciones a los perfiles cuando se ingieren. Perfiles de clientes proporciona plantillas predeterminadas de tipos de objetos que puede utilizar y que definen cómo se asignan los atributos de sus objetos de origen a los objetos estándar en Perfiles de clientes. También puedes usar las asignaciones de objetos que has creado a partir de. [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)
![\[La página de opciones de integración.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-integration-options-shopify.png)
1. Para la **Fecha de inicio de la ingesta**, Perfiles de clientes comienza la ingesta de los registros creados después de agregar la integración.
**nota**
Si necesita registros históricos, puede [utilizar Amazon S3 como origen de integración para importarlos](customer-profiles-object-type-mappings.md).
1. En la página **Revisar e integrar**, compruebe que el **Estado de la conexión** sea **Conectado** y, a continuación, seleccione **Agregar integración**.
**nota**
Tras agregar esta integración, deberá [configurar suscripciones a webhooks](#shopify-webhook-subscriptions) para permitir que los eventos empiecen a fluir hacia esta integración.
![\[Página Revisar e integrar.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook.png)
1. Una vez configurada la integración, de vuelta en la página **Configuración de perfiles de clientes**, la sección **Integraciones** muestra las integraciones que están actualmente configuradas. La **Última ejecución** y el **Estado de integración** no están disponibles actualmente para este tipo de integración.
![\[La sección Integraciones.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-shopify-integrations-view-card.png)
Para ver qué datos se están enviando, elija la integración y, a continuación, seleccione **Ver objetos**.
1. Vaya al siguiente paso para utilizar la API y configurar las **suscripciones a webhooks** para que los eventos puedan empezar a fluir hacia esta integración.
## Configuración de suscripciones de webhook
1. Utilice la siguiente URL para asegurarse de que su aplicación dispone de los permisos necesarios:
```
https://{shop}.myshopify.com/admin/oauth/authorize?client_id={api_key}&scope={scopes}&redirect_uri={redirect_uri}&state={nonce}
```
Donde:
+ `shop` es el nombre de su tienda de Shopify.
+ `api_key` es la clave de API de su aplicación de Shopify. Puede encontrarla en la página de detalles **Aplicación** de Shopify.
+ `scopes` debe tener el valor `read_customers,read_orders,read_draft_orders`.
+ `redirect_uri` es el URI de redireccionamiento que especificó para su aplicación cuando la creó. Para nuestros fines, puede ser cualquier URL válida.
+ `nonce` puede ser cualquier valor único para identificar una solicitud de autorización determinada de otras personas. Recomendamos utilizar una marca temporal.
Después de crear la URL, péguela en el navegador. Aparece una installation/authorization página similar a la siguiente imagen, en la que se pide al propietario de la tienda que otorgue permisos para el ámbito definido.
![\[Un ejemplo de una página de Shopify para instalar y autorizar la aplicación.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/customer-profiles-enable-shopify-webhook-embedded-app.png)
1. Elija **Instalar aplicación no incluida en la lista** para instalar y autorizar la aplicación en nombre de su tienda.
Accederá al URI de redirección que introdujo con un código de autorización añadido al URI de redirección como parámetro de consulta. Por ejemplo:
```
https://example.org/some/redirect/uri?code={authorization_code}&hmac=da9d83c171400a41f8db91a950508985&host={base64_encoded_hostname}×tamp=1409617544&state={nonce}&shop={shop_origin}&host={host}
```
1. Copie el `authorization_code` de este URI. Lo utilizará para obtener un token de acceso permanente en los próximos pasos.
1. Vaya a la herramienta que utilice para realizar llamadas a la API. Por ejemplo, [CURL](https://curl.se/) o [POSTMAN](https://www.postman.com/).
1. Para obtener un token de acceso permanente, haga una solicitud POST a la API `Admin` de Shopify a este punto de conexión:
```
https://{shop}.myshopify.com/admin/oauth/access_token
```
con el siguiente cuerpo de solicitud:
```
{
"code": "authorization_code_received_from_redirect_uri",
"client_id": "your_app_api_key",
"client_secret": "your_app_api_secret"
}
```
Esta solicitud devolverá la siguiente respuesta:
```
{
"access_token": "permanent_access_token",
"scope": "read_customers,read_orders,read_draft_orders"
}
```
1. Anote el `access_token`. Se trata de un token permanente que tiene el ámbito proporcionado en un paso anterior. Ahora ya puede crear suscripciones de webhook.
1. Para las siguientes llamadas a la API, asegúrese de establecer la clave del encabezado HTTP `X-Shopify-Access-Token` al `access_token` que recibió de la respuesta de la llamada anterior.
1. Para configurar las suscripciones de webhook, realice la siguiente solicitud POST para cada uno de los valores de `topic` enumerados en el siguiente paso:
Punto de conexión: `https://{shop}.myshopify.com/admin/api/2021-04/webhooks.json`
Cuerpo de la solicitud:
```
{
"webhook": {
"topic": "replace_this_with_one_of_the_topics_in_the_list_below",
"address": "this_is_the_event_source_arn_generated_when_you_created_the_event_integration",
"format": "json"
}
}
```
1. Para cada suscripción, sustituya el valor de `topic` por los siguientes valores:
+ `customers/create`
+ `customers/enable`
+ `customers/update`
+ `draft_orders/create`
+ `draft_orders/update`
+ `orders/cancelled`
+ `orders/create`
+ `orders/fulfilled`
+ `orders/paid`
+ `orders/partially_fulfilled`
+ `orders/updated`
Ahora ya puede recibir eventos de su tienda de Shopify. A continuación, verifique su integración con Shopify.
## Verificación de su integración de Shopify
1. Inicie sesión como administrador en su tienda de Shopify.
1. En el menú de navegación izquierdo, elija **Usuarios**.
1. Seleccione **Agregar cliente**.
1. Introduzca sus datos de cliente. Asegúrese de introducir un número de teléfono y un correo electrónico. No es necesario que pertenezcan a un cliente real. Eliminará esta entrada de cliente tras verificar la integración.
1. Guarde el objeto de cliente.
1. La entrega del evento debe ser casi instantánea, pero espere un minuto a que se entregue y cree un perfil de cliente.
1. Abra la experiencia de agente de Amazon Connect y busque al usuario por el correo electrónico o el número de teléfono que introdujo en la tienda de Shopify. Debería poder ver el perfil de cliente con el mismo correo electrónico o número de teléfono.
1. Si no ve el perfil del cliente, significa que hay un problema con su integración. Para solucionar el problema:
1. Ve a la EventBridge consola de Amazon.
1. Comprueba si EventSource está activo y si la coincidencia EventBus existe y se está ejecutando.
Si funcionan, ponte en contacto con nosotros Soporte para obtener ayuda para investigar el problema.
## Monitoreo de sus integraciones de Perfiles de clientes
Una vez establecida la conexión, si deja de funcionar, elimine la integración y vuelva a establecerla.
## Qué hacer si no se envían objetos
Si no se realiza el envío de un objeto, elija **Detalles del flujo** para obtener más información sobre el error.
Puede que tenga que eliminar la configuración y volver a conectarse a la aplicación externa.