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.
Temas
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
Inicie sesión en su organización de Salesforce como administrador del sistema.
En Configuración, en el cuadro Búsqueda rápida, introduzca y, a continuación
apps
, seleccione App Manager.-
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.
Haga lo siguiente:
En el cuadro Nombre de la aplicación conectada, introduzca un nombre para la aplicación.
En el cuadro Correo electrónico de contacto, introduce tu dirección de correo electrónico.
(Opcional) Rellene los campos restantes tal y como se describe en Configurar los ajustes básicos de la aplicación conectada
, en la documentación de Salesforce.
-
Seleccione la casilla de verificación Habilitar la OAuth configuración y, a continuación, haga lo siguiente:
Seleccione la casilla Activar el flujo de dispositivos. Puede ignorar la URL de devolución de llamada resultante.
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.
-
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
En el mensaje que aparece después de seleccionar Activar el flujo de credenciales de cliente, pulse Aceptar.
Desplácese hasta el final de la página y elija Save (Guardar).
-
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.
-
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.
En Detalles del consumidor, selecciona los botones Copiar para ver la clave del consumidor y el secreto del cliente.
-
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.
-
Selecciona Editar políticas y, a continuación, haz lo siguiente:
En la lista de usuarios permitidos, selecciona Todos los usuarios pueden autoautorizarse.
En la lista de relajación de IP, seleccione Aplicar restricciones de IP.
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.
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 AWS CloudFormation plantilla para configurar los AWS componentes de la EventBridge integración de Amazon o puede crear los componentes manualmente. Para AWS CloudFormation utilizarlas, descargue las plantillas desde:
Temas
Cómo encontrar la URL de tu dominio
La AWS CloudFormation plantilla utiliza la URL de tu dominio como uno de sus parámetros obligatorios.
Para buscar la URL
Inicie sesión en Salesforce.
En la sección Configuración, en el cuadro Búsqueda rápida, introduzca
my domain
.En el panel izquierdo, en Configuración de la empresa, selecciona el enlace Mi dominio.
Copia la dirección en el cuadro URL actual de Mi dominio.
nota
Debe utilizar el prefijo https://al introducir la URL en la AWS CloudFormation plantilla.
Uso de la pila AWS CloudFormation
En los pasos de los siguientes temas se explica cómo crear e implementar una AWS CloudFormation pila que configure las notificaciones en tiempo real.
-
Descarga las siguientes plantillas:
nota
Implementa cada plantilla por separado y sigue los mismos pasos para ambas.
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.
Sigue en la consola, busca y
cloudformation
, a continuación, abre la AWS CloudFormation consola.En la página de pilas, selecciona Crear pila.
Selecciona los botones de opción Elegir una plantilla existente y Cargar un archivo de plantilla.
Selecciona Elegir archivo para abrir la plantilla descargada y, a continuación, selecciona Siguiente.
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_URL
.
Cuando haya terminado, elija Next (Siguiente).
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.
Elija 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.
Temas
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
Para crear un destino de API en la EventBridge consola:
Sigue los pasos de Crear un destino de API 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
Abre la EventBridge consola en y https://console.aws.amazon.com/events/
, en el panel de navegación izquierdo, selecciona los destinos de la API. -
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.
Introduzca la información siguiente:
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 (_).
El nombre debe ser exclusivo de la cuenta en la región actual.
(Opcional) Introduzca una descripción del destino de la API.
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
En Método HTTP, seleccione POST.
-
En Configuración de conexión, selecciona Crear una nueva conexión y, a continuación, haz lo siguiente:
Introduzca un nombre y una descripción opcional.
En Tipo de destino, elija Otro.
Elija las credenciales OAuth del cliente.
-
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 En Método HTTP, seleccione POST.
En el caso del ID de cliente, introduzca la clave de consumidor de la aplicación conectada en Salesforce.
En Secreto de cliente, introduzca el secreto del consumidor de la aplicación conectada en Salesforce.
Añada los siguientes OAuth valores:
Parámetro: campo de cuerpo
Clave: grant_type
Valor: client_credentials
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
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 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.
-
En Amazon EventBridge, selecciona Reglas.
-
En la lista, selecciona el bus de eventos deseado.
-
En la sección Reglas, elija Crear regla.
-
Introduzca un nombre para la regla y, a continuación, seleccione Siguiente.
-
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 en la AWS documentación.
-
Elija Siguiente.
-
En Seleccionar objetivos, en Target 1, selecciona el destino de la EventBridge API.
-
En la lista, selecciona el destino de la API que acabas de crear.
-
Amplíe Configuración adicional.
-
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
} -
Seleccione Siguiente y, a continuación, Siguiente.
-
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 Amazon SQS en la Guía del usuario de Amazon SQS.
Creación de eventos de ofertas publicadas
En los siguientes pasos se explica cómo crear eventos de ofertas publicadas.
-
En la EventBridge consola de Amazon, selecciona Rules.
-
Selecciona el bus de eventos deseado de la lista.
-
En la sección Reglas, elija Crear regla.
-
Introduce un nombre para la regla y, a continuación, selecciona Siguiente.
-
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 de Amazon en la Guía EventBridge del usuario de Amazon.
-
Elija Siguiente.
-
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.
-
Amplíe Configuración adicional.
-
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
} -
Seleccione Siguiente y, a continuación, Siguiente.
-
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 y Recepción y eliminación de mensajes (consola) 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
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: se activa cuando se crea una nueva oportunidad.
-
Oportunidad actualizada: se activa cuando se actualiza una oportunidad.
Invitación de participación creada: se activa cuando se crea una oportunidad.
Invitación de compromiso aceptada: 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: 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 |
|
Oportunidad actualizada |
|
Invitación de compromiso creada |
|
Invitación de compromiso aceptada |
|
Invitación de compromiso rechazada |
|
Todos los eventos |
|