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.
Actualización de Amazon S3 a la API-based integración
nota
En los temas de esta sección se presupone que ha completado los requisitos previos para una integración con AWS Partner Central, una integración con AWS Marketplace o ambas. Para obtener más información, consulte la Requisitos previos para la integración sección Introducción anterior de esta guía.
Recomendado: Realice primero estas actividades en un entorno sandbox, pruébelas exhaustivamente y, a continuación, impleméntelas en producción.
En esta sección se explica cómo actualizar su AWS Partner CRM Connector de Amazon S3-based a la API-based integración. La API-based integración reemplaza el modelo de bucket anterior de Amazon S3 por una sincronización bidireccional en tiempo real mediante funciones y API de IAM.
Para ver un recorrido totalmente interactivo con capturas de pantalla, consulte el taller de actualización del conector CRM para AWS socios en el sitio web de AWS
La actualización incluye los siguientes pasos:
Requisitos previos
Orden de operaciones de migración
Los socios suelen preguntarse si deben migrar primero a la nueva experiencia de Partner Central en la AWS consola o actualizar primero de Amazon S3 a la API. Este es el enfoque recomendado:
| Escenario | Recomendación |
|---|---|
| Actualmente se encuentra en Amazon S3, pero aún no tiene una nueva experiencia en Partner Central | Migre primero a la API y, a continuación, migre a la nueva experiencia de Partner Central en paralelo o después |
| Actualmente usa Amazon S3 y ya tiene una nueva experiencia en Partner Central | Continúe directamente con la migración de la API |
| Ya utiliza la API, pero aún no tiene una nueva experiencia en Partner Central | Migre a la nueva experiencia de Partner Central según le convenga |
La vinculación de cuentas es el único requisito obligatorio
La vinculación de cuentas es el único requisito obligatorio para la S3-to-API migración a Amazon. NO es necesario migrar a la nueva experiencia de Partner Central para iniciar la actualización de la API.
Información clave:
S3-based Las integraciones de Amazon están en desuso y ya no están disponibles para los nuevos usuarios.
Los socios de Amazon S3 deben planificar completar la migración a la API lo antes posible para evitar la degradación del servicio.
Consulte la documentación sobre la integración de CRM para AWS socios para ver el cronograma más reciente sobre el final de la vida útil del backend de Amazon S3.
Asegúrese de que Partner Central esté vinculada a un AWS inscrita
El S3-based conector de Amazon se autenticó con los permisos de un bucket de Amazon S3 administrado en la cuenta AWS de administración. En su lugar, el API-based conector se autentica mediante funciones de IAM en la propia AWS cuenta vinculada del socio para llamar directamente a las API de Partner Central. Por este motivo, la vinculación de cuentas es un requisito técnico imprescindible: sin ella, el conector no tiene forma de llegar a las API de Partner Central con los permisos necesarios.
¿Por qué puede faltar?
Cuando se AWS lanzó la API de ventas de Partner Central en noviembre de 2024, se introdujo la vinculación de cuentas para permitir a los socios acceder a estas API mediante programación. A partir de la versión 3.0 del conector (también en noviembre de 2024), la vinculación de cuentas pasó a ser un requisito para API-based la sincronización. Los socios que hayan configurado su S3-based conector de Amazon antes de esta fecha no habrán completado la vinculación de cuentas.
Vincula tu cuenta de Partner Central a tu AWS cuenta principal. Elija su cuenta con cuidado desde el principio. Si bien es posible desvincular y volver a vincular una cuenta diferente, hacerlo crea problemas de persistencia de los datos y requiere esfuerzos de conciliación manual.
Reglas de selección de cuentas: la AWS cuenta debe cumplir con las siguientes condiciones:
Una cuenta de pago en regla (no de nivel gratuito)
Propiedad de la empresa del socio (no de la cuenta de un distribuidor)
Tenga una dirección de facturación que coincida con la ubicación comercial principal del socio
NO se trata de un entorno aislado, de desarrollador, personal o management/payer de cuenta
La vinculación de cuentas es permanente
La vinculación de cuentas es permanente tras la migración de Partner Central a la AWS consola. Todos los recursos de APN (oportunidades de ACE, historial, invitaciones a varios socios) están vinculados permanentemente a esta cuenta. Elige con cuidado.
Recursos:
Sección de vinculación de cuentas del taller de actualización
en el sitio web de AWS Workshops Cómo desvincular cuentas
en el sitio web de Partner Central
Opcional: migre a la nueva experiencia de Partner Central en AWS Consola
Este paso no es necesario para actualizar el S3-to-API conector de Amazon. La vinculación de cuentas por sí sola proporciona la API-based funcionalidad necesaria. Sin embargo, al migrar a la nueva experiencia de Partner Central, su equipo tendrá acceso a funciones adicionales:
Agentes de Partner Central (Co-Sell agente, agente de financiación, prospección autónoma)
Una experiencia de AWS consola centralizada para gestionar las actividades de los socios junto con sus recursos AWS
Visibilidad mejorada de los eventos del ciclo de vida de las oportunidades directamente en la consola
Cambio de formato de ID de solución
Si migra a la nueva experiencia de Partner Central y, a continuación, crea nuevas soluciones, esas soluciones utilizarán el nuevo soln-* formato. El CRM Connector aún no admite este formato; requiere el S-* formato anterior para el solutionOffered campo. Las soluciones antiguas creadas antes de la migración conservan el S-* formato y siguen funcionando.
Consulte la guía de migración de Partner Central para obtener más información.
Pre-migration limpieza de datos
Antes de comenzar la migración, asegúrese de que la S3-based integración con Amazon está completamente separada. El paso más importante es eliminar los trabajos programados pendientes que puedan interferir con el API-based conector y el proceso de relleno.
Al desactivar las programaciones de Amazon S3 a través de la interfaz de usuario del conector, los trabajos programados de Salesforce subyacentes (con el prefijo APN) permanecen en el sistema. Si siguen presentes al iniciar el proceso de rellenado o activar la API-based sincronización, es posible que tanto el antiguo programador como el nuevo conector escriban simultáneamente en los mismos registros, lo que provocaría la creación de oportunidades duplicadas o conflictos de datos.
La desactivación en la interfaz de usuario no es suficiente
No basta con desactivar las programaciones en la interfaz de usuario del conector. También debe eliminar las entradas de trabajos programados subyacentes en la configuración de Salesforce. Consulte Revise e inhabilite las programaciones de Amazon S3 el paso a paso completo.
Configuración AWS infraestructura
Esta fase requiere que un administrador de Salesforce trabaje con un administrador de TI en la nube para configurar dos nuevos componentes: una aplicación de cliente externa de Salesforce y los componentes de AWS infraestructura (EventBridge reglas y funciones de IAM).
Configure la aplicación de cliente externo de Salesforce
Con la versión de Amazon S3, ambas direcciones de sincronización pasaban por un bucket de Amazon S3 compartido por socio. La versión de la API cambia esta opción para las actualizaciones entrantes: Partner Central ahora envía los eventos directamente a su organización en tiempo real a través de. EventBridge La aplicación de cliente externo permite un flujo de credenciales de cliente de OAuth 2.0 para poder enviar las notificaciones a medida que EventBridge se producen.
El administrador de Salesforce debe seguir las instrucciones de la sección
Configuración AWS componentes
La AWS infraestructura de la versión de la API incluye:
EventBridgepara el procesamiento de eventos en tiempo real
Funciones de IAM para una autenticación segura
Estos componentes sustituyen al modelo de acceso a los cubos de Amazon S3 utilizado en la versión anterior.
El administrador de TI en la nube debe implementar la CloudFormation plantilla siguiendo las instrucciones de la sección
Finalice la instalación y la configuración en Salesforce
El resto de la configuración la realiza un administrador de Salesforce. Complete primero las actividades en Sandbox, pruébelas y, a continuación, pase a Producción.
Instale la versión más reciente del AWS Partner CRM Connector desde Salesforce y, a continuación AppExchange
Revise y ajuste sus mapeos
Con la versión Amazon S3, la sincronización saliente se basaba en Sync with AWS los campos y. Has Updates for AWS Ya no se utilizan en la API-based integración.
En la versión de la API, la sincronización saliente se controla mediante la opción Habilitar compartir con AWS integración en la configuración personalizada de AWS
Partner CRM Connector (Companion_App_Settings__c). Cuando está habilitada, las oportunidades de ACE se comparten automáticamente con ellas AWS cada vez que se produce una actualización válida.
Puntos clave:
Se recomienda utilizar el objeto ACE Opportunity como zona de aterrizaje, ya que coincide con los puntos de datos de AWS oportunidades de Partner Central y permite el mapeo automático.
Si ya utilizaba ACE Opportunity para el mapeo de la integración, la configuración subyacente no cambia. Sin embargo, el paquete actualizado introduce nuevos campos que no estaban presentes en las versiones anteriores.
Revisa las automatizaciones que hagan referencia a los antiguos S3-era campos de Amazon (
Sync_with_AWS__c,Has_Updates_for_AWS__c) para usar los nuevos equivalentes.
El modelo de datos de ACE Opportunity está disponible en el sitio GitHub web.
La versión más reciente del conector incluye una plantilla de flujo para ayudar a asignar su oportunidad estándar a la oportunidad ACE. Para obtener más información, consulte las plantillas de flujo.
Revisa y agrega los campos y botones obligatorios
El conector ha introducido nuevos campos y botones desde la versión 3.0 o posterior. Debe actualizar manualmente el diseño de la página Lightning Record.
Agregue los siguientes botones a la página de registro de ACE Opportunity Lightning:
| Button | Finalidad |
|---|---|
| Compartir con AWS | Ofrece manualmente la oportunidad de acceder a Partner Central a través de la API. |
| Actualiza desde AWS | Extrae los datos más recientes de Partner Central para incluirlos en este registro de oportunidades de ACE. |
| Accept/Reject | Acepte o rechace las oportunidades AWS referidas. |
| Associate/Disassociate | Enlaza o desvincula AWS ofertas de soluciones, productos y mercados de partners aprobados. |
| Assign | Reasigne una oportunidad a otro usuario de su cuenta de Partner Central. |
Elimine los siguientes botones antiguos de la página de registro de ACE Opportunity Lightning:
| Button | Motivo |
|---|---|
| Enviar a AWS | Sustituido por Compartir con AWS. |
| Vincular oferta privada | Reemplazado por Associate/Disassociate. |
Agregue los siguientes botones de visualización de listas a la pestaña ACE Opportunity:
Acepte oportunidades: oportunidades AWS con Bulk-accept múltiples referencias.
Asigne oportunidades: Bulk-reassign múltiples oportunidades.
Para los campos nuevos, revise todos los campos agregados después de la versión 3.0 del conector
Revise e inhabilite las programaciones de Amazon S3
Con API-based este enfoque, ya no es necesario programar trabajos: la integración se ejecuta en tiempo real.
Para deshabilitar los trabajos programados
Diríjase a la pestaña Programaciones de la aplicación AWS Partner CRM Connector.
Seleccione Desactivar todos los trabajos y, a continuación, vuelva a seleccionar Desactivar.
Elimine también los registros programados. Para eliminar de la configuración los trabajos programados de APN restantes:
Para eliminar los trabajos programados de APN de la configuración
Navegue hasta Configuración. Busque «Programados» y seleccione Trabajos programados.
Revisa la lista para ver si hay APN-related trabajos. Elija Del para eliminarlos.
Sigue CustomLogInteractionBatch corriendo
Mantenga el CustomLogInteractionBatch trabajo en marcha (AppExchange App Analytics).
Elimine los trabajos programados, no se limite a desactivarlos
No deje los trabajos en un estado «desactivado pero no eliminado». Los trabajos persistentes han provocado la creación de oportunidades duplicadas cuando se combinan con la sincronización API-based en tiempo real.
Limpieza
Desactive las reglas de validación antiguas
Varias reglas de validación antiguas deben desactivarse y otras deben permanecer activas. Consulte esta sección del taller
Asegúrese también de que se hayan desactivado los siguientes flujos heredados:
Sincronice ACE Opportunity con la API de Partner Central
Búsqueda privada de ofertas
Notificación de error de sincronización de APN
Actualizando el campo de oferta privada en ACE Opportunity
Actualizando el campo de oportunidad de Ace en el registro de detalles del registro de sincronización
Flujo Standard-ACE de sincronización de oportunidades unificado (plantilla)
Pruebe el proceso antes de pasar a la producción. Consulte las pruebas desde la configuración
Recolección completa de oportunidades de AWS a Salesforce
Realice un rellenado para garantizar que los datos coincidan entre los entornos. El awsapn__Last_Modified_Date__c campo de la oportunidad ACE debe coincidir con la fecha de la última modificación en Partner Central para poder sincronizar las actualizaciones futuras. La integración de Amazon S3 no rellenó este campo, por lo que las oportunidades que migren desde Amazon S3 lo tendrán vacío; el campo se rellenará con el relleno.
El relleno ofrece tres modos:
| Mode | ¿Qué hace? | Cuándo se debe usar |
|---|---|---|
| Solo faltan las oportunidades de actualización: fecha de última modificación | Actualiza solo los registros awsapn__Last_Modified_Date__c que están vacíos | Recomendado para la S3-to-API migración a Amazon |
| Actualice únicamente AWS las oportunidades que ya existen en Salesforce | Actualiza todos los registros que ya tienen un ID de CRM de APN | Alternativa segura para la migración |
| Actualice todas las AWS oportunidades | Incorpora toda la cartera de Partner Central a Salesforce | Úselo únicamente en instalaciones nuevas |
Antes de realizar el relleno:
Confirme que todos los trabajos programados de APN se eliminen (no solo se hayan desactivado).
Si está activo, desactive el flujo «Sincronizar ACE Opportunity con la API de Partner Central».
Desactive Activar la opción Compartir con AWS integración en la configuración personalizada (
Companion_App_Settings__c).Complete la limpieza de datos previa a la migración que se describe en. Pre-migration limpieza de datos
Una vez completada la reposición:
Re-enable Habilita Compartir con AWS integración: esto impulsa la sincronización continua.
NO es necesario reactivar el flujo «Sincronizar la oportunidad con la API de Partner Central».
Verifique que se haya rellenado una muestra de registros para confirmar
awsapn__Last_Modified_Date__c.
Para obtener más información, consulte la sección
Post-migration: Monitorización de eventos EventBridge
Tras la migración, su organización de Salesforce recibe actualizaciones en tiempo real de Partner Central a través de. EventBridge Para verificar que los eventos fluyan:
CloudWatch Métricas: vaya a CloudWatch > Métricas > EventBridge. Consulta las invocaciones y FailedInvocations el destino de tu API.
Registros de sincronización de Salesforce: en cualquier oportunidad de ACE, consulte la lista relacionada con el registro de sincronización para ver las entradas entrantes recientes.
EventBridge Supervisión de reglas: compruebe la regla creada por la CloudFormation plantilla para ver los eventos coincidentes recientes.
| Síntoma | Causa probable | Resolución |
|---|---|---|
| No hay actualizaciones entrantes en Salesforce | El token de la aplicación de cliente externa ha caducado | Re-authenticate la aplicación conectada; verifique las credenciales de OAuth en EventBridge el destino de la API |
| Los eventos se detienen después de funcionar | Tiempo de espera de la sesión de Salesforce | Compruebe el estado del destino de la API en EventBridge; vuelva a conectarse |
| Actualizaciones parciales (faltan algunos campos) | La asignación de campos no coincide | Actualice a la versión más reciente del conector; verifique las asignaciones de campos |
Solución de problemas comunes de migración
| Error o síntoma | Causa raíz | Resolución |
|---|---|---|
FIELD_CUSTOM_VALIDATION_EXCEPTIONal hacer clic en «Actualizar desde AWS» | Las reglas de validación antiguas no están desactivadas | Desactivar y ACEOppNew_PreventUpdatesWhenPOSubmitted ACEOpp_PreventUpdatesWhenPOSubmitted |
| Oportunidades duplicadas | Trabajos programados persistentes o múltiples usuarios de integración | Elimine TODOS los trabajos programados de APN. Verifique que solo un usuario esté activo. APN Business Admin |
| Los registros de sincronización crecen rápidamente | Los registros que no se validan se vuelven a intentar cada ciclo | Identifique los registros fallidos mediante los registros de sincronización. Corrija los campos obligatorios que faltan. |
| El relleno supera los límites de almacenamiento | Demasiados registros a la vez | Se ejecuta en lotes más pequeños. Supervise el almacenamiento. |
| «Actualizar desde AWS» muestra datos obsoletos | awsapn__Last_Modified_Date__cdiscordancia | Re-run relleno dirigido utilizando «Solo las oportunidades de actualización en las que falta la fecha de última modificación» |
| Las oportunidades de Partner Central no aparecen | EventBridge se ha desactivado el problema de conexión o el uso compartido automático | Verifique el estado del destino de la EventBridge API. Confirme que la opción «Habilitar compartir con AWS integración» esté habilitada. |
Obtener ayuda
Si encuentra problemas que los pasos anteriores no pueden resolver:
Abra un caso de soporte: Partner Central → Soporte → Abrir un caso nuevo
→ Integración con CRM Asistencia en materia de migración: Para migraciones complejas (más de 500 oportunidades, integraciones personalizadas o incidentes de producción anteriores), solicite asistencia inmediata a través de su responsable de la alianza.
