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 notificaciones en tiempo real para AWS Partner Central y AWS Marketplace eventos En los siguientes temas se explica cómo configurar EventBridge las notificaciones en tiempo real para AWS Partner Central y AWS Marketplace los eventos. Puede configurar las notificaciones en Salesforce configurando una aplicación conectada o puede usar AWS CloudFormation plantillas. **Topics** + [Configurar una aplicación conectada a Salesforce](#configuring-salesforce-connected-app) + [Uso de una AWS CloudFormation pila para configurar las notificaciones](#configuring-aws-components) ## Configurar una aplicación conectada a Salesforce En los siguientes pasos se explica cómo configurar una aplicación conectada en Salesforce. Debe crear una aplicación conectada para poder utilizar la OAuth autenticación en las conexiones de destino. Para obtener más información, consulte más adelante en esta guía. [Crear componentes de notificación manualmente](#manual-creation-of-aws-components) 1. Inicie sesión en su organización de Salesforce como administrador del sistema. 1. En **Configuración**, en el cuadro **Búsqueda rápida**, introduzca y, a continuación**apps**, seleccione **App Manager**. 1. En la página del **administrador de aplicaciones de Lightning Experience**, elija **Nueva aplicación conectada**, elija **Crear una aplicación conectada** y, a continuación, elija **Continuar**. Aparece la página **Nueva aplicación conectada**. 1. Haga lo siguiente: 1. En el cuadro **Nombre de la aplicación conectada**, introduzca un nombre para la aplicación. 1. En el cuadro **Correo electrónico de contacto**, introduce tu dirección de correo electrónico. 1. (Opcional) Rellene los campos restantes tal y como se describe en [Configurar los ajustes básicos de la aplicación conectada](https://help.salesforce.com/s/articleView?id=sf.connected_app_create_basics.htm), en la documentación de Salesforce. 1. Seleccione la casilla de verificación **Habilitar la OAuth configuración** y, a continuación, haga lo siguiente: 1. Seleccione la casilla **Activar el flujo de dispositivos**. Puede ignorar la URL de devolución de llamada resultante. 1. En ** OAuth Ámbitos disponibles, selecciona **Administrar datos de usuario mediante APIs** y utiliza el botón **Añadir** para mover el ámbito a la lista de ámbitos** seleccionados. 1. Seleccione las siguientes casillas de verificación: + **Solicite la extensión Proof Key for Code Exchange (PKCE) para los flujos de autorización admitidos** + **Se requiere un secreto para el flujo del servidor web** + **Se requiere un secreto para actualizar el flujo del token** + **Habilite el flujo de credenciales del cliente** 1. En el mensaje que aparece después de seleccionar **Activar el flujo de credenciales de cliente**, pulse **Aceptar**. 1. Desplácese hasta el final de la página y elija **Save (Guardar)**. 1. Seleccione **Continuar** y, a continuación, seleccione **Administrar detalles del consumidor**. Aparece la página **Verifica tu identidad** y el sistema envía un código de verificación a tu dirección de correo electrónico de contacto. 1. Introduce el código de verificación en el cuadro **Código de verificación** y selecciona **Verificar**. Aparece la página de la aplicación conectada. 1. En **Detalles del consumidor**, selecciona los botones **Copiar** para ver la clave del consumidor y el secreto del cliente. 1. En **Configuración**, en el cuadro **Búsqueda rápida**, ingresa **Aplicaciones**, selecciona **Administrar aplicaciones conectadas** y, a continuación, elige la aplicación conectada que acabas de crear. 1. Selecciona **Editar políticas** y, a continuación, haz lo siguiente: 1. En la lista de **usuarios permitidos**, selecciona **Todos los usuarios pueden autoautorizarse**. 1. En la lista de **relajación de IP**, seleccione **Aplicar restricciones de IP**. 1. En la lista **Ejecutar como**, seleccione el *usuario de ejecución*, el usuario al que le asigna el flujo de credenciales del cliente. Salesforce requiere que el usuario de ejecución devuelva los tokens de acceso en nombre del usuario. 1. Seleccione **Save**. ## Uso de una AWS CloudFormation pila para configurar las notificaciones En los siguientes temas se explica cómo usar AWS CloudFormation plantillas para configurar EventBridge las notificaciones en tiempo real. Los pasos solo se aplican a la versión 3.0 y posteriores del conector AWS Partner CRM. Para la versión 3.0 y posteriores del conector AWS Partner CRM, puede usar una CloudFormation plantilla para configurar los AWS componentes de la EventBridge integración de Amazon o puede crear los componentes manualmente. Para CloudFormation utilizarlas, descargue las plantillas desde: **Topics** + [Cómo encontrar la URL de tu dominio](#find-domain-url) + [Uso de la pila CloudFormation](#downloading-templates) + [Crear componentes de notificación manualmente](#manual-creation-of-aws-components) + [Reglas de ejemplo](#example-rules) ### Cómo encontrar la URL de tu dominio La CloudFormation plantilla utiliza la URL de tu dominio como uno de sus parámetros obligatorios. **Para buscar la URL** 1. Inicie sesión en Salesforce. 1. En la sección **Configuración**, en el cuadro **Búsqueda rápida**, introduzca**my domain**. 1. En el panel izquierdo, en **Configuración de la empresa**, selecciona el enlace **Mi dominio**. 1. Copia la dirección en el cuadro **URL actual de Mi dominio**. **nota** Debe utilizar el prefijo https://al introducir la URL en la CloudFormation plantilla. ### Uso de la pila CloudFormation En los pasos de los siguientes temas se explica cómo crear e implementar una CloudFormation pila que configure las notificaciones en tiempo real. 1. Descarga las siguientes plantillas: **nota** Implementa cada plantilla por separado y sigue los mismos pasos para ambas. + Integración de la API de Partner Central: [https://servicecatalogconnector---s3.amazonaws.com.rproxy.govskope.usAPIDestination//CFT\$1PCAPI.json](https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_PCAPI.json) + [Integración (opcional):/CFT\$1.json AWS Marketplace https://servicecatalogconnector.s3.amazonaws.com APIDestination AWSMP](https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_AWSMP.json) 1. **En la AWS consola, inicia sesión en tu cuenta de AWS Marketplace vendedor y asegúrate de que funciona en el norte de Virginia.** EventBridge solo opera en esa región. 1. Sigue en la consola, busca y**cloudformation**, a continuación, abre la CloudFormation consola. 1. En la página de **pilas**, selecciona **Crear pila**. 1. Selecciona los botones de **opción Elegir una plantilla existente** y **Cargar un archivo de plantilla**. 1. Selecciona **Elegir archivo** para abrir la plantilla descargada y, a continuación, selecciona **Siguiente**. 1. En la página **Especificar los detalles de la pila**, introduce lo siguiente: + **Nombre de la pila**: introduzca un nombre para la pila. + **ID de cliente**: introduce la clave de consumidor que anotaste al crear la aplicación conectada. + **Secreto de cliente**: introduce el secreto de consumidor que anotaste al crear la aplicación conectada. + **URL del dominio**: utilice el siguiente formato: **https://*domain\$1URL*.** Cuando haya terminado, elija **Next (Siguiente)**. 1. **En la página **Configurar opciones de pila**, desplázate hasta el final, selecciona la casilla de verificación **Sé que AWS CloudFormation podría crear recursos de IAM** y, a continuación, selecciona Siguiente.** 1. Seleccione **Enviar**. Cuando se implementan correctamente, las plantillas crean el destino de la API, la conexión, las reglas de eventos y la cola de mensajes sin respuesta. ### Crear componentes de notificación manualmente En los pasos siguientes se explica cómo crear manualmente los componentes de las EventBridge notificaciones. **Topics** + [Crear un destino y una conexión de la EventBridge API de Amazon](#manual-destination-connection) + [Crear una EventBridge regla y conectarla al destino de la API](#create-connect-ev-rule) + [Crear eventos de conjuntos de cambios](#change-set-events) + [Creación de eventos de ofertas publicadas](#offer-released-events) + [Crear eventos de oportunidad](#opportunity-events) + [Tipos de eventos](#types-of-events) + [Evento de ejemplo de](#example-event) #### Crear un destino y una conexión de la EventBridge API de Amazon Para crear un destino de API y una conexión EventBridge, cree un destino de API que utilice una conexión nueva. En este caso, el destino de la API es una llamada a la API de REST a Salesforce para publicar un evento. La conexión contiene la información de autenticación de la llamada a la API. La conexión acepta varios métodos de autorización. **Requisitos previos** Para usar la OAuth autorización para la conexión de destino de la API, cree una aplicación conectada en Salesforce. Para ello, siga los pasos que se indican en [Configurar una aplicación conectada para el flujo de credenciales de los clientes OAuth 2.0](https://help.salesforce.com/s/articleView?id=sf.connected_app_client_credentials_setup.htm), en la documentación de Salesforce. Para la conexión de destino de la API, debe utilizar la clave de consumidor y el secreto de la aplicación conectada. Para crear un destino de API en la EventBridge consola: + Sigue los pasos de [Crear un destino de API](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-api-destinations.html#eb-api-destination-create) en la *Guía del EventBridge usuario de Amazon*. + Configure las configuraciones específicas de Salesforce. En Salesforce, en la página **Mi dominio**, en **Configuración**, anote el nombre de dominio de su organización. Se usa para configurar el destino y la conexión de la API en la EventBridge consola. En los siguientes pasos se explica cómo hacerlo. **Para crear el destino y la conexión** 1. Abre la EventBridge consola en y [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/), en el panel de navegación izquierdo, selecciona los **destinos de la API**. 1. Desplázate hacia abajo hasta la tabla de **destinos de la API** y selecciona **Crear destino de la API**. Aparece la página **de destino para crear la API**. 1. Introduzca la información siguiente: 1. Un **nombre** para el destino de la API. Puede utilizar hasta 64 letras mayúsculas o minúsculas, números, puntos (.), guiones (-) o caracteres de subrayado (\$1). El nombre debe ser exclusivo de la cuenta en la región actual. 1. (Opcional) Introduzca una **descripción** del destino de la API. 1. Para el **punto final de destino de la API**, utilice esta URL:**https://*my-salesforce-domain-name*.my.salesforce.com/services/data/v58.0/sobjects/*event-api-name***. 1. En **Método HTTP**, seleccione **POST**. 1. En **Configuración de conexión**, selecciona **Crear una nueva conexión** y, a continuación, haz lo siguiente: 1. Introduzca un nombre y una descripción opcional. 1. En **Tipo de destino**, elija **Otro**. 1. Elija **las credenciales OAuth del cliente**. 1. Para el **punto final de autorización**, acepte el punto final rellenado previamente. -O BIEN- si utiliza una organización de producción, sustituya el punto final rellenado por esta URL: **https://*my-salesforce-domain-name*.my.salesforce.com/services/oauth2/token** 1. En **Método HTTP**, seleccione **POST**. 1. En el **caso del ID de cliente**, introduzca la clave de consumidor de la aplicación conectada en Salesforce. 1. En **Secreto de cliente**, introduzca el secreto del consumidor de la aplicación conectada en Salesforce. 1. Añada los siguientes OAuth valores: + **Parámetro**: campo de cuerpo + **Clave**: grant\$1type + **Valor: client\$1credentials** 1. Seleccione **Crear**. **nota** Si su organización de Salesforce utiliza la autenticación multifactorial para el acceso a la API, los usuarios deben completar un segundo desafío de autenticación para acceder a Salesforce. APIs Para obtener más información, consulte [Establecer los requisitos de inicio de sesión con autenticación multifactor para el acceso a la API en](https://help.salesforce.com/s/articleView?id=sf.security_require_2fa_api.htm&language=en_US&type=5) la documentación de Salesforce. Tras crear el destino de la API, puede crear una regla que utilice el destino como destino. #### Crear una EventBridge regla y conectarla al destino de la API EventBridge las reglas enrutan los eventos desde el bus de eventos al destino de la API, lo que resulta en una llamada REST para publicar un evento en Salesforce. Para obtener más información sobre EventBridge las reglas, consulta [Cómo crear EventBridge reglas de Amazon que reaccionen a los eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) en la *Guía del EventBridge usuario de Amazon*. #### Crear eventos de conjuntos de cambios En los pasos siguientes se explica cómo crear eventos de conjuntos de cambios. 1. En [Amazon EventBridge](https://docs.aws.amazon.com/marketplace/latest/userguide/seller-eventbridge.html#events-changesets), selecciona **Reglas**. 1. En la lista, selecciona el bus de eventos deseado. 1. En la sección **Reglas**, elija **Crear regla**. 1. Introduzca un nombre para la regla y, a continuación, seleccione **Siguiente**. 1. En **Patrón de eventos**, selecciona **Patrones personalizados (editor JSON)** e introduce el siguiente filtro. Puede utilizar cualquier combinación de tipos de detalles. ``` {   "source": [     "aws.marketplacecatalog"   ],   "detail-type": [     "Change Set Succeeded",     "Change Set Failed",     "Change Set Cancelled"   ] } ``` Para obtener más información sobre la coincidencia de patrones de eventos, consulte [Filtrado de contenido en patrones de EventBridge eventos de Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html) en la AWS documentación. 1. Elija **Siguiente**. 1. En **Seleccionar objetivos**, en **Target 1**, selecciona el **destino de la EventBridge API**. 1. En la lista, selecciona el destino de la API que acabas de crear. 1. Amplíe **Configuración adicional**. 1. En **Configurar entrada de destino**, seleccione **Transformador de entrada** y **Configurar transformador de entrada**. Esto garantiza que solo se envíen los campos de eventos de Salesforce de la sección de detalles del evento original. La ruta de entrada debe ser:  ``` {   "Name": "$.detail-type",   "awsapn__Account_Number__c": "$.account",   "awsapn__EntityId__c": "$.detail.ChangeSetId" } ``` La plantilla debe ser:  ``` {   "Name": Name,   "awsapn__Account_Number__c": awsapn__Account_Number__c,   "awsapn__EntityId__c": awsapn__EntityId__c } ``` 1. Seleccione **Siguiente** y, a continuación, **Siguiente**. 1. Revisa la regla y, a continuación, selecciona **Crear regla**. **nota** Para solucionar los problemas de un destino de API, puede utilizar la consola Amazon SQS para añadir una cola de mensajes sin salida al destino. La cola recibe los mensajes que no se han podido entregar, además de los errores. Desde la consola Amazon SQS, puede sondear los mensajes de la cola para detectar errores. *Para obtener más información, consulte [Uso de colas de texto sin procesar para procesar eventos no entregados en Amazon SQS y Recepción y eliminación de mensajes en EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html) [Amazon SQS en la Guía del usuario de Amazon](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-using-receive-delete-message.html) SQS.* #### Creación de eventos de ofertas publicadas En los siguientes pasos se explica cómo crear eventos de ofertas publicadas. 1. En la EventBridge consola de [Amazon](https://docs.aws.amazon.com/marketplace/latest/userguide/seller-eventbridge.html#events-changesets), selecciona **Rules**. 1. Selecciona el bus de eventos deseado de la lista. 1. En la sección **Reglas**, elija **Crear regla**. 1. Introduce un nombre para la regla y, a continuación, selecciona **Siguiente**. 1. En **Patrón de eventos**, selecciona **Patrones personalizados (editor JSON)** e introduce el siguiente filtro:  ``` {   "source": [     "aws.marketplacecatalog"   ],   "detail-type": [     "Offer Released"   ] } ``` Para obtener más información sobre la coincidencia de patrones de eventos, consulte [Filtrado de contenido en patrones de EventBridge eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns-content-based-filtering.html) de Amazon en la Guía EventBridge del usuario de Amazon. 1. Elija **Siguiente**. 1. En **Seleccionar objetivos**, en **Target 1**, selecciona el **destino de la EventBridge API**, abre la lista y selecciona el destino de la API que acabas de crear. 1. Amplíe **Configuración adicional**. 1. En **Configurar entrada de destino**, seleccione **Transformador de **entrada y seleccione Configurar transformador** de entrada**. Este paso evita que los campos de eventos de Amazon de nivel superior se envíen a Salesforce. Solo se envía la parte que contiene los campos de eventos de Salesforce de la sección de detalles del evento original. Utilice la siguiente ruta de entrada:  ``` {    "Name":"$.detail-type",    "awsapn__Account_Number__c":"$.account",    "awsapn__EntityId__c":"$.detail.offer.id",    "awsapn__Manufacturer_Account_Id__c":"$.detail.manufacturer.accountId",    "awsapn__Product_Id__c":"$.detail.product.id",    "awsapn__Seller_Account_Id__c":"$.detail.sellerOfRecord.accountId" } ``` Utilice la plantilla siguiente:  ``` {   "Name": Name,   "awsapn__Account_Number__c": awsapn__Account_Number__c,   "awsapn__EntityId__c": awsapn__EntityId__c,   "awsapn__Seller_Account_Id__c": awsapn__Seller_Account_Id__c,   "awsapn__Manufacturer_Account_Id__c": awsapn__Manufacturer_Account_Id__c,   "awsapn__Product_Id__c": awsapn__Product_Id__c } ``` 1. Seleccione **Siguiente** y, a continuación, **Siguiente**. 1. Revisa la regla y, a continuación, selecciona **Crear regla**. **nota** Para ayudar a solucionar los problemas de ejecución del destino de la API, añada una cola de cartas muertas de Amazon SQS al destino. La cola recibe los mensajes que no se han podido entregar junto con los errores. A continuación, puede sondear los mensajes para ver los errores. Para obtener más información, consulte la [política de reintentos de eventos y el uso de colas con letra muerta](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-dlq.html) y [Recepción y eliminación de mensajes (consola)](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-using-receive-delete-message.html) en la documentación. AWS #### Crear eventos de oportunidad Los eventos de oportunidad proporcionan notificaciones en tiempo real sobre los cambios en el estado o los detalles de las oportunidades También puede crear y administrar EventBridge reglas mediante programación mediante el. [AWS SDKs](https://docs.aws.amazon.com/partner-central/latest/selling-api/opportunity-events.html#aws-eventbridge) #### Tipos de eventos En la siguiente lista se describen los tipos de eventos que se generan cuando los socios trabajan con oportunidades. Los enlaces le llevan a la documentación de la API de cada evento. + [Oportunidad creada:](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#opportunity-created) se activa cuando se crea una nueva oportunidad. + [Oportunidad actualizada](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#opportunity-updated): se activa cuando se actualiza una oportunidad. + [Invitación de participación creada](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-created): se activa cuando se crea una oportunidad. + [Invitación de compromiso aceptada](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-accepted): se activa cuando un socio acepta una invitación de AWS compromiso, lo que confirma su interés en colaborar con AWS ella en el momento de la oportunidad. + [Invitación de compromiso rechazada](https://docs.aws.amazon.com/partner-central/latest/selling-api/selling-api-events.html#invitation-rejected): se activa cuando se rechaza una oportunidad. #### Evento de ejemplo de ``` {     "version": "1",     "id": ""d1example-0c9c-4655-15bf-c5exampleb08",     "source": "aws.partnercentral-selling",     "detail-type": "Opportunity Created",     "time": ""2023-10-28T13:31:05Z",     "region": ""us-east-1",     "account": ""123456789123",     "detail": {          "schemaVersion": "1",         "catalog": "AWS",         "opportunity": {             "identifier": ""O1234567",             "url": "Partner Central Opportunity Page URL"         }     } } ``` ### Reglas de ejemplo En la siguiente tabla se muestran ejemplos de las EventBridge reglas que puede usar con los eventos enumerados en la sección anterior. Las reglas dirigen los eventos desde el bus de eventos al destino de la API, lo que resulta en una llamada REST para publicar un evento en Salesforce. | Tipo de evento | Ejemplo | | --- | --- | | **Oportunidad creada** | 
{
  "source": ["aws.partnercentral-selling"],
  "detail-type": ["Opportunity Created"],
  "detail": {
    "catalog": ["AWS"]
  }
}
| | **Oportunidad actualizada** | 
{
  "source": ["aws.partnercentral-selling"],
  "detail-type": ["Opportunity Updated"],
  "detail": {
    "catalog": ["AWS"]
  }
}
| | **Invitación de compromiso creada** | 
{
  "source": ["aws.partnercentral-selling"],
  "detail-type": ["Engagement Invitation Created"],
  "detail": {
    "catalog": ["AWS"]
  }
}
| | **Invitación de compromiso aceptada** | 
{
  "source": ["aws.partnercentral-selling"],
  "detail-type": ["Engagement Invitation Accepted"],
  "detail": {
    "catalog": ["AWS"]
  }
}
| | **Invitación de compromiso rechazada** | 
{
  "source": ["aws.partnercentral-selling"],
  "detail-type": ["Engagement Invitation Rejected"],
  "detail": {
    "catalog": ["AWS"]
  }
}
| | **Todos los eventos** | 
{
  "source": ["aws.partnercentral-selling"],
  "detail": {
    "catalog": ["AWS"]
  }
}
|