Complete los requisitos previos para supervisar los eventos Configura Amazon EventBridge para supervisar los eventos Más información sobre la venta de eventos de API

Notificaciones para el AWS Partner Central Selling API

Los eventos de la API de ventas proporcionan notificaciones en tiempo real sobre los cambios en el estado o los detalles de las oportunidades. Estos eventos ayudan a mantener tus sistemas sincronizados con AWS Partner Central y ayudan a garantizar respuestas y actualizaciones oportunas.

Temas

Complete los requisitos previos para supervisar los eventos
Configura Amazon EventBridge para supervisar los eventos
Más información sobre la venta de eventos de API

Complete los requisitos previos para supervisar los eventos

Los usuarios necesitan los permisos de IAM adecuados para acceder y gestionar los eventos publicados por la API de ventas de Partner Central. Para obtener más información sobre las acciones, los recursos y las claves de condición disponibles EventBridge, consulta la sección Uso de las condiciones de la política de IAM en Amazon EventBridge en la Guía del EventBridge usuario de Amazon. Una de las claves de condición es events:detail-type la que se puede usar para asignar permisos a tipos de eventos específicos.

El siguiente ejemplo de política demuestra cómo personalizar y establecer el alcance de los permisos para los eventos propuestos. La AllowPutRuleForPartnercentralSellingEvents sentencia permite la creación de reglas, pero solo para los eventos de la aws.partnercentral-selling fuente.

Configura Amazon EventBridge para supervisar los eventos

Para supervisar los eventos de la API de ventas, crea una EventBridge regla que coincida con los eventos que quieres capturar. Puedes usar los SDK Consola de administración de AWS o los AWS SDK para crear y administrar reglas. En las siguientes secciones se explica cómo crear reglas con ambos métodos. Independientemente del método que utilice, debe crear la regla en la us-east-1 región EE.UU. Este (Norte de Virginia).

Consola de administración de AWS setup

Para configurar una EventBridge regla con el Consola de administración de AWS, sigue los pasos que se indican en la Guía del EventBridge usuario de Amazon para crear reglas que EventBridge reaccionen a los eventos de Amazon. Al crear la regla, debes configurar el bus de eventos como predeterminado y crear la regla en la us-east-1 región EE.UU. Este (Norte de Virginia).

A continuación se muestra un ejemplo de una regla de eventos:


{
    "source": ["aws.partnercentral-selling"],
    "detail": {
        "catalog": ["AWS"]
    }
}

AWS Configuración del SDK

Puede usar los AWS SDK para crear y administrar EventBridge reglas mediante programación. Para obtener más información, consulte la referencia de PutRule la API de Amazon EventBridge .

El siguiente ejemplo usa el AWS SDK para Python (Boto3):


import boto3

client = boto3.client('events', region_name='us-east-1')

response = client.put_rule(
    Name='MyOpportunityCreatedRule',
    EventPattern=
    '{
        "source": ["aws.partnercentral-selling"], 
        "detail-type": ["Opportunity Created"], 
        "detail": {"catalog": ["AWS"]}
    }',
    State='ENABLED'
)
print('Rule ARN:', response['RuleArn'])

Más información sobre la venta de eventos de API

En las siguientes secciones se describen los tipos de eventos de la API de venta, los escenarios que los activan y los ejemplos de eventos.

Event types (Tipos de eventos)

A continuación se muestran los tipos de eventos y sus desencadenantes.

Oportunidad creada: se activa cuando se crea una nueva oportunidad.
Oportunidad actualizada: se activa cuando se actualiza una oportunidad (la AWS oportunidad o su correspondiente resumen de oportunidades).
Invitación de participación creada: se activa cuando se crea una invitación de AWS recomendación.
Invitación de participación aceptada: se activa cuando un socio acepta una invitación de AWS participación y confirma su interés en colaborar con ella AWS para aprovechar la oportunidad.
Invitación de compromiso rechazada: se activa cuando un socio rechaza una invitación de AWS compromiso.
La invitación de compromiso ha caducado: este evento se activa cuando un socio rechaza una EngagementInvitation. Notifica al socio remitente y receptor que la invitación ha caducado.
Miembro de compromiso agregado: este evento se activa cuando un nuevo miembro se une al compromiso después de aceptar una invitación. Notifica a todos los miembros actuales de la Participación que el nuevo miembro se está añadiendo a la Participación.
Se creó una instantánea del recurso de participación: este evento se activa cuando se crea una nueva revisión de la instantánea de los recursos (como las oportunidades) asociados a una participación. Notifica a todos los miembros actuales de la participación sobre los cambios en la instantánea del recurso asociado.
Interacción creada: se activa cuando se crea una nueva participación.
Interacción actualizada: se activa cuando se actualiza una interacción.

Escenarios de eventos

En la tabla siguiente se describe cómo funcionan los eventos en diferentes escenarios. Se basan en las siguientes suposiciones para estos escenarios:

AWS también es un socio en estos escenarios.
ResourceSnapshotJobestá configurado correctamente por el socio.
Los campos actualizados de la oportunidad también se encuentran en la plantilla de oportunidades de Resource Snapshot.

Acción de su parte como socio	Eventos recibidos	Tipo de participante
Creas una oportunidad	Oportunidad creada
Usas `StartEngagementFromOpportunityTask` para enviar una oportunidad	Oportunidad actualizada, participación creada, instantánea de recursos de participación creada, miembro de participación agregado, invitación de participación creada
AWS aprueba la oportunidad presentada	Se acepta la invitación de participación, se agrega un miembro de participación, se actualiza la oportunidad, se crea una instantánea del recurso de participación
AWS rechaza la oportunidad presentada	Invitación de participación rechazada, oportunidad actualizada, creación de una instantánea del recurso de participación
Asocias una AWS Marketplace oferta con una oportunidad	Oportunidad actualizada
Asocias una solución con una oportunidad	Oportunidad actualizada, creación de una instantánea de los recursos de participación
Actualizas una oportunidad	Oportunidad actualizada, creación de una instantánea de los recursos de participación (opcional si `ResourceSnapshotJob` está configurada y las actualizaciones de campo están en la plantilla)
AWS actualiza tu oportunidad	Oportunidad actualizada, creación de una instantánea de los recursos de participación
Invitas a otro socio a un compromiso	Invitación de participación creada	Remitente
Un socio ha aceptado su invitación para unirse a una participación	Se acepta la invitación de participación, se ha agregado un miembro de participación	Remitente
Su invitación para unirse a una participación ha sido rechazada por un socio	Invitación de compromiso rechazada	Remitente
Un socio no responde a su invitación para unirse a un compromiso durante 15 días	La invitación de compromiso ha caducado	Remitente
Recibes una invitación de otro socio para unirte a una participación	Invitación de participación creada	Receptor
Aceptas la invitación de otro socio para unirte a una participación a través de `StartEngagementByAcceptingInvitationTask`	Invitación de participación aceptada, miembro de participación agregado, oportunidad creada, oportunidad actualizada, instantánea del recurso de participación	Receptor
Rechazas la invitación de otro socio para unirte a una interacción	Invitación de compromiso rechazada	Receptor
No aceptas una invitación de otro socio para unirte a un compromiso durante 15 días	La invitación de compromiso ha caducado	Receptor
Creas un compromiso	Compromiso creado	Remitente
Actualizas un compromiso	Compromiso actualizado	Remitente, receptor

Eventos de ejemplo

En las siguientes secciones se proporcionan ejemplos de los eventos enumerados anteriormente en la sección anterior.

Temas

Oportunidad creada
Oportunidad actualizada
Invitación de compromiso creada
Invitación de compromiso aceptada
Invitación de compromiso rechazada
La invitación de compromiso ha caducado
Miembro de compromiso agregado
Se creó una instantánea del recurso de participación
Participación creada
Compromiso actualizado

Oportunidad creada

Los socios utilizan este evento para:

Notificar a sus usuarios que se ha creado una nueva oportunidad.
Impulse flujos de trabajo automatizados, como la actualización de los sistemas de CRM o la notificación a los equipos de ventas sobre la creación de nuevas oportunidades.

El siguiente ejemplo muestra un evento típico de creación de oportunidades.


{
    "version": "1",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "source": "aws.partnercentral-selling",
    "detail-type": "Opportunity Created",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "account": "123456789012",
    "detail": {
        "schemaVersion": "<version number>",
        "catalog": "<Sandbox | AWS>",
        "opportunity": {
            "identifier": "String"
        }
    }
}

Oportunidad actualizada

Los socios utilizan este evento para:

Notificar a sus usuarios que se ha actualizado una oportunidad existente.
Active flujos de trabajo automatizados, como la actualización de los sistemas de CRM o la notificación a los equipos de ventas.

El siguiente ejemplo muestra un evento típico de actualización de oportunidades.


{
    "version": "1",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "source": "aws.partnercentral-selling",
    "detail-type": "Opportunity Updated",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "account": "123456789012",
    "detail": {
        "schemaVersion": "<version number>",
        "catalog": "<Sandbox | AWS>",
        "opportunity": {
             "identifier": "String"
        }
    }
}

Invitación de compromiso creada

Los socios utilizan este evento para:

Notificar a sus usuarios sobre las novedades EngagementInvitation que han recibido.
Active flujos de trabajo automatizados para aceptar o rechazar la invitación, como actualizar los sistemas de CRM o notificar a los equipos de ventas.

El siguiente ejemplo muestra un evento típico de creación de una invitación de participación.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Created",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-15T12:34:56Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"
    ],
    "detail": {
      "catalog": "AWS",
      "engagementInvitation": {
        "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
        "id": "engi-v7p8z56whnauo",
        "engagementId": "eng-12345678901234",      
        "senderAccountId": "string",
        "receiverAccountId": "string",      
        "senderCompanyName": "string",
        "expirationDate": "string",
        "participantType": "Enum", //Sender/Receiver
		"payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation
      }
    }
}

Invitación de compromiso aceptada

Los socios utilizan este evento para:

Notificar a sus usuarios que se EngagementInvitation ha aceptado.
Actualice sus registros internos para incluir al nuevo socio en el compromiso.
Active flujos de trabajo automatizados para sincronizar los datos o notificar a otros miembros del equipo sobre el nuevo miembro del compromiso.

El siguiente ejemplo muestra un evento típico de aceptación de una invitación de participación.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Accepted",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "resources": ["arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"],
    "detail": {
        "catalog": "AWS",
        "engagementInvitation": {
            "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
            "id": "engi-v7p8z56whnauo",
            "engagementId": "eng-12356whnauo",       
            "participantType": "Enum", //Sender/Receiver
            "senderAccountId": "string",
            "receiverAccountId": "string",
            "payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation
        }
    }
}

Invitación de compromiso rechazada

Los socios utilizan este evento para:

Notificar a sus usuarios que se EngagementInvitation ha rechazado.
Actualice sus registros internos para reflejar la invitación rechazada.
Activa los flujos de trabajo necesarios, como notificar al equipo de ventas sobre el rechazo.

El siguiente ejemplo muestra un evento típico de rechazo de una invitación de interacción.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Rejected",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-17T09:48:27Z",
    "region": "us-east-1",
    "resources": ["arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"],
    "detail": {
        "catalog": "AWS",
        "engagementInvitation": {
            "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
            "id": "engi-v7p8z56whnauo",
            "engagementId": "eng-12356whnauo",
            "participantType": "Enum", //Sender/Receiver
            "senderAccountId": "string",
            "receiverAccountId": "string",    
            "payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation 
        } 
    }
}

La invitación de compromiso ha caducado

Los socios utilizan este evento para:

Notifique a sus usuarios que EngagementInvitation ha caducado y que ya no se puede realizar ninguna acción al respecto.
Actualice sus registros internos para reflejar la invitación caducada.
Active los flujos de trabajo necesarios, como notificar al equipo de ventas sobre la caducidad de la invitación.

El siguiente ejemplo muestra un evento típico de invitación de compromiso caducada.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Invitation Expired",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo"
    ],
    "detail": {
      "catalog" : "AWS",    
      "engagementInvitation": {
        "arn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement-invitation/engi-v7p8z56whnauo",
        "id": "engi-v7p8z56whnauo",
        "engagementId": "eng-12356whnauo",        
        "participantType": "Enum", //Sender/Receiver
        "senderAccountId": "string",
        "receiverAccountId": "string",
        "payloadType": "LeadInvitation" //OpportunityInvitation|LeadInvitation
      }  
    }
}

Miembro de compromiso agregado

Los socios utilizan este evento para:

Notificar a sus usuarios sobre los cambios en la membresía de Engagement.
Actualice sus registros internos para reflejar al nuevo miembro de Engagement.
Activa los flujos de trabajo necesarios, como notificar los cambios a los miembros del equipo.

El siguiente ejemplo muestra un evento típico de Engagement Member Added.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Member Added",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-16T15:23:45Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-v7p8z56whnauo"
    ],
    "detail": {
      "catalog" : "AWS",
      "engagement": {
        "id": "eng-v7p8z56whnauo"
      },
      "engagementMember": {
        "accountId": "string",
        "companyName": "string"
      }
    }
}

Se creó una instantánea del recurso de participación

Los socios utilizan este evento para hacer un seguimiento de los cambios en los recursos asociados a una contratación y activar flujos de trabajo automatizados, como la actualización de los sistemas de CRM o la notificación a los equipos de ventas. La plantilla de instantáneas determina el tipo de actualización:

OpportunitySummaryView

Notifique a todos los miembros de una participación que la participación se ha actualizado.

AwsOpportunitySummaryFullView

Realice un seguimiento de las actualizaciones realizadas específicamente por AWS sobre las oportunidades incluidas en una contratación.
Esta notificación y esta instantánea solo son visibles para el propietario de la oportunidad.
Incluye actualizaciones sobre el tamaño de las ofertas, que no están disponibles en la OpportunitySummaryView plantilla.

El siguiente ejemplo muestra un evento típico de creación de instantáneas de recursos de interacción.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Resource Snapshot Created",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
      "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-v7p8z56whnauo"
    ],
    "detail": {
      "catalog" : "AWS",
      "resourceSnapshot": {
        "arn": "arn:aws:partnercentral-selling:us-east-1::catalog/AWS/engagement/eng-v7p8z56whnauo/resource/Opportunity/o-12312/template/temp-name/snapshot/snapshot-19232",
        "engagementId": "eng-v7p8z56whnauo",
        "resourceType": "Opportunity",      
        "resourceId" : "O123211231",
        "createdBy": "123123123123",
        "targetMemberAccounts": ["123123123123", "aws"], 
        "resourceSnapshotTemplateName": "temp-name"
      }
    }
}

Participación creada

Los socios utilizan este evento para:

Notificar a sus usuarios que se ha creado una nueva interacción.
Impulse flujos de trabajo automatizados, como actualizar los sistemas de CRM o notificar a los equipos de ventas sobre las nuevas creaciones de interacciones.

El siguiente ejemplo muestra un evento típico de creación de interacciones.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Created",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo"
    ],
    "detail": {
        "catalog": "AWS",
        "engagement": {
            "engagementArn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo",
            "engagementId": "eng-567a1j5hxp35lo",
            "CreatedAt": "2023-04-18T18:20:15Z",
            "CreatedBy": "aws",
            "ContextTypes": ["Lead"]
            
        }
    }
}

Compromiso actualizado

Los socios utilizan este evento para:

Notificar a sus usuarios que se ha actualizado una participación existente.
Active flujos de trabajo automatizados, como la actualización de los sistemas de CRM o la notificación a los equipos de ventas.

El siguiente ejemplo muestra un evento típico de actualización de la interacción.


{
    "version": "0",
    "id": "01234567-0123-0123-0123-0123456789ab",
    "detail-type": "Engagement Updated",
    "source": "aws.partnercentral-selling",
    "account": "123456789012",
    "time": "2023-04-18T18:20:15Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo"
    ],
    "detail": {
        "catalog": "AWS",
        "engagement": {
            "engagementArn": "arn:aws:partnercentral:us-east-1::catalog/AWS/engagement/eng-567a1j5hxp35lo",
            "engagementId": "eng-567a1j5hxp35lo",
            "LastModifiedAt": "2023-04-18T18:20:15Z",
            "LastModifiedBy": "aws",
            "ContextTypes": ["Lead", "CustomerProject"]
        }
    }
}

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Notificaciones para el AWS API de cuentas de Partner Central

Notificaciones para el AWS API de beneficios de Partner Central