View a markdown version of this page

Criar uma campanha externa usando gatilhos de eventos - Amazon Connect Customer
Criar 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

Configure gatilhos de eventos no Connect Customer site de administração

  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.
    Importante

    Para criar uma campanha de widget de comunicação, você deve ter uma integração de perfis de clientes entre seu domínio de perfis de clientes e sua instância. O nome do tipo de objeto necessário éCampaign-WebNotification. Você pode fazer isso escolhendo o botão de upgrade no console Connect Customer administrativo do site, selecionando sua instância e acessando a subpágina Campanhas externas.

    Seção de comunicação mostrando a lista suspensa do modo de entrega com o widget de comunicação selecionado entre as opções, incluindo voz assistida por agente, voz automatizada, e-mail, SMS e. WhatsApp
    Seção de comunicação mostrando a lista suspensa do widget de comunicação com a seção My-custom-widget selecionada e a seção Tipo de notificação com as opções Ação e Visualização.

    Há dois tipos de notificação para escolher: Exibir e Ação.

    Visão

    Uma notificação de visualização exibe uma mensagem visual ou um aviso acima do botão do widget de comunicação. Ele apresenta informações ao usuário final, como uma saudação, oferta ou mensagem contextual. A notificação convida o usuário final a participar de uma conversa com um agente ou bot.

    Selecione Exibir quando quiser exibir uma mensagem, promoção ou aviso contextual para o usuário final antes que ele inicie uma conversa. Isso dá ao usuário final um momento para ler e decidir se deseja interagir.

    Exemplos:

    • Um banner proativo dizendo “Olá! Percebemos que você está nesta página há algum tempo. Precisa de ajuda para encontrar o plano certo?”

    • Uma mensagem promocional: “Oferta por tempo limitado — converse conosco para obter 20% de desconto no seu upgrade”.

    • Uma sugestão contextual: “Está tendo problemas para concluir seu pedido? Estamos aqui para ajudar.”

    Ação

    Uma notificação de ação ignora qualquer mensagem visual e aciona imediatamente a abertura do widget de comunicação e inicia uma conversa diretamente com um bot ou agente humano.

    Selecione Ação quando quiser pular totalmente a etapa de notificação e iniciar o usuário final diretamente em uma conversa ao vivo. Nenhuma mensagem intermediária é exibida.

    Exemplos:

    • O sistema conecta imediatamente um cliente de alta intenção em uma página de checkout a um agente de suporte.

    • O sistema direciona um cliente recorrente com um caso aberto diretamente para um fluxo de bots para verificar o status.

    • Um cliente VIP aciona uma conexão instantânea com um agente dedicado ao visitar a página de ajuda.

    Visualize o tipo de notificação selecionado mostrando o menu suspenso Exibir seleção, o menu suspenso Exibir versão e a seção Recomendações com o menu suspenso Recomendador.

    Depois de escolher um tipo de notificação, você pode selecionar um recomendador.

  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: Criando 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 _last_interacted_item_id 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 com 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.

Criar campanhas externas com gatilhos de eventos usando APIs

APIs de ativação de eventos Connect Customer Customer Profiles

  • 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. Number/Date*
NOT_BETWEEN Verdadeiro se o destino não estiver dentro de um intervalo de valores ou carimbo de data/hora específicos. Number/Date*
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.

APIs de gatilho de eventos de campanhas externas

  • 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.