Criar uma campanha externa usando gatilhos de eventos - Amazon Connect
Crie campanhas externas com gatilhos de eventos usando APIs

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criar uma campanha externa usando gatilhos de eventos

Configurar acionadores de eventos no site de administração Amazon Connect

  1. Na página Configuração da campanha, selecione Evento para clientes em Destinatários.

    Página Configuração da campanha com Evento para clientes selecionado na seção Destinatários para campanhas acionadas por eventos.

  2. Selecione uma fonte de eventos para especificar a fonte dos dados e configure as condições do atributo que ativarão o gatilho do evento.

    As fontes de eventos são baseadas em integrações em seu domínio Perfis de clientes. Para conhecer os detalhes sobre como configurar sua aplicação externa, consulte Integrar a aplicações externas. Você também pode fazer a integração ao Kinesis ou ao S3.

    Painel de seleção da fonte do evento mostrando as opções de integração e a configuração da condição do atributo.

  3. Selecione o modo de entrega e as configurações adicionais de comunicação.

    Seleção do modo de entrega e configurações adicionais de comunicação para campanhas acionadas por eventos.

  4. (Opcional) Configure a seção Recomendações para integrar o Predictive Insights à sua campanha acionada por eventos. Isso permite que você forneça conteúdo de modelo personalizado por meio de canais de e-mail e SMS.

    Seção de recomendações no console do Amazon Connect mostrando a lista suspensa Recomendador com frequently_paired_items selecionados, atributo calculado para recomendador com _last_interacted_item_id, número de recomendações definido como 3 e atributos de recomendação com nome, preço, descrição e categoria selecionados. ImageLink

    Configure as seguintes opções:

    • Nome do recomendador — Selecione o nome do recomendador que você deseja usar para gerar recomendações para os perfis associados à campanha. Você só pode usar recomendadores ativos para gerar recomendações.

      O Predictive Insights oferece vários tipos de recomendações. Para obter mais informações, consulte Etapa 3: Criação de insights preditivos.

    • Atributo calculado para o recomendador — Essa configuração só é necessária ao usar um tipo de recomendador de itens semelhantes ou itens frequentemente emparelhados. Esse contexto ajuda o mecanismo de recomendação a entender em qual produto basear as sugestões, permitindo recomendações mais relevantes e direcionadas para seus clientes.

      Por exemplo, você pode usar um atributo calculado como _last_interacted_item_id aquele que captura a ID do item comprado.

    • Número de recomendações — O número máximo de recomendações a serem geradas para um perfil. Isso pode variar de 1 a 3 recomendações.

    • Atributos de recomendação — defina quais atributos da resposta das recomendações são usados em seu modelo de mensagem.

    Para obter mais informações sobre o Predictive Insights, consulteComece a usar o Predictive Insights.

  5. Verifique suas configurações e escolha Publicar.

    Tela de análise final da configuração da campanha acionada por eventos com o botão Publicar.

Crie campanhas externas com acionadores de eventos usando APIs

Acionador do evento Amazon Connect Customer Profiles APIs

  • Duas chamadas de API são feitas para criar um gatilho de eventos funcional:

Exemplo de uma solicitação de gatilho de evento:

{
"Description": "string",
"EventTriggerConditions": [
{
"EventTriggerDimensions": [
{
"ObjectAttributes": [
{
"ComparisonOperator": "string",
"FieldName": "string",
"Source": "string",
"Values": [ "string" ]
}
]
}
],
"LogicalOperator": "string"
}
],
"EventTriggerLimits": {
"EventExpiration": number,
"Periods": [
{
"MaxInvocationsPerProfile": number,
"Unit": "string",
"Unlimited": boolean,
"Value": number
}
]
},
"ObjectTypeName": "string",
"SegmentFilter": "string",
"Tags": {
"string" : "string"
}
}

O ComparisonOperator comporta os seguintes valores:

ComparisonOperator Comment Tipos aceitos
INCLUSIVE Confere se o destino inclui todos os valores especificados. String
EXCLUSIVO Confere se o destino não contém todos os valores especificados. String
CONTAINS Confere se o destino contém algum dos valores especificados. String
BEGINS_WITH Confere se o destino começa com o valor especificado. String
ENDS_WITH Confere se o destino termina com o valor especificado. String
MAIOR_QUE Verdadeiro se o destino for maior que o valor especificado. Número
MENOS_QUE Verdadeiro se o destino for menor que o valor especificado. Número
GREATER_THAN_OR_EQUAL Verdadeiro se o destino for maior ou igual ao valor especificado. Número
LESS_THAN_OR_EQUAL Verdadeiro se o destino for menor ou igual ao valor especificado. Número
EQUAL Verdadeiro se o destino for igual ao valor especificado. Número
ENTRE Verdadeiro se o destino estiver dentro de um intervalo de valores ou carimbo de data/hora específicos. Número/Data*
NOT_BETWEEN Verdadeiro se o destino não estiver dentro de um intervalo de valores ou carimbo de data/hora específicos. Número/Data*
ANTES Verdadeiro se o destino for anterior ao carimbo de data/hora especificado. Data
DEPOIS Verdadeiro se o destino for após o carimbo de data/hora especificado. Data
LIGADO Verdadeiro se o destino estiver no carimbo de data/hora especificado. Data

  • Fonte: usada para definir um atributo no objeto.

    • Somente um atributo é permitido em uma única entrada ObjectAttribute.

  • FieldName: usado para apontar para o atributo mapeado no mapeamento de dados.

    • Somente um atributo é permitido em uma única entrada ObjectAttribute.

  • ObjectTypeName: oferece suporte a todos os nomes de tipos de objetos padrão e personalizados, mas não aos tipos de objetos padrão_profile, como _asset_order,, e outros.

  • EventTriggerLimits:

    • Por padrão, permite no máximo vinte gatilhos de eventos simultâneos por domínio do cliente.

    • Limite padrão de dez invocações por dia, por perfil, por gatilho. Você pode substituir isso especificando UNLIMITED em MaxInvocationPerProfile.

    • MaxInvocationPerProfile:

      • Faixa válida: valor mínimo de 1. Valor máximo de 1.000 (ou UNLIMITED).

    • Unidade:

      • Valores válidos: HOURS, DAYS, WEEKS, MONTHS

    • Value (Valor):

      • Faixa válida: valor mínimo de 1. Valor máximo de 24

  • Comparação de intervalo de tempo

    • O Customer Profiles usa bibliotecas padrão para analisar valores de tempo. Para serviços globais, é importante considerar as conversões de fuso horário para garantir um processamento preciso.

  • O valor EventExpiration é especificado em milissegundos. Quando usado para acionar uma campanha, o tempo máximo de expiração é limitado a 15 minutos.

Acionador de eventos de campanhas externas APIs

  • CreateCampaignV2

    As únicas mudanças necessárias para criar uma campanha acionada por eventos são os campos destacados. Os demais campos são os mesmos que aparecem em Campanhas agendadas.

    {
    "name": "string",
    "connectInstanceId": "string",
    "channelSubtypeConfig": { 
    // or other channel parameters 
        "email": {
            "outboundMode": {
                "agentless":{
                }
            },
            "defaultOutboundConfig":{
                "connectSourceEmailAddress":"example@example.com",
                "wisdomTemplateArn":"arn:aws:wisdom:us-west-2:123456789012:message-template/dXXXXX0Pc8-195a-776f-0000-EXAMPLE/51219d5c-b1f4-4bad-b8d3-000673332",
                "sourceEmailAddressDisplayName": "testEmailDisplayName"
            }
        }
    },
    "connectCampaignFlowArn": <Flow ARN>,
    "schedule": {
            "endTime": "2024-12-11T21:22:00Z",
            "startTime": "2024-10-31T20:14:49Z",
            "timeZone": "America/Los_Angeles"
    },
    "source": {
        "eventTrigger": {
            "customerProfilesDomainArn": <Domain ARN>
}

  • PutProfileOutboundRequestBatch

    Você não pode invocar diretamente essa API, mas ela será registrada nos seus logs do Cloudtrail. Essa API é usada para acionar uma campanha após o recebimento de um evento e é o mecanismo que inicia uma chamada de voz, e-mail ou SMS.