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.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-1.png) 1. 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](integrate-external-apps-customer-profiles.md#setup-integrations-title-menu). Você também pode fazer a integração ao [Kinesis](customer-profiles-kinesis-integration.md) ou ao [S3](customer-profiles-object-type-mappings.md). ![Painel de seleção da fonte do evento mostrando as opções de integração e a configuração da condição do atributo.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-2.png) 1. 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.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-3.png) **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.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/shows_channel_option.png) ![Seção de comunicação mostrando a lista suspensa do widget de comunicação com o tipo My-custom-widget selecionado e o tipo de notificação.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/shows_channel_option_after_a_widget_is_selected.png) 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. ![Exibir o tipo de notificação selecionado, uma visualização com a integração do Web Notification Service escolhida.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/shows_view_notification_type_recommender.png) Os recomendadores só estão disponíveis quando você seleciona o tipo de notificação **Exibir** e a exibição selecionada tem um tipo de integração com o **Web Notification Service**. Se você selecionar o tipo de notificação de **ação** ou se a visualização selecionada não tiver essa integração, a opção de recomendação não aparecerá. 1. (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.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/how-to-create-campaigns-recommendations.png) 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](predictive-insights-get-started.md#create-predictive-insights). + **Atributo calculado para 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, consulte[Comece com o Predictive Insights](predictive-insights-get-started.md). 1. 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.](http://docs.aws.amazon.com/pt_br/connect/latest/adminguide/images/how-to-create-campaigns-using-event-triggers-4.png) ## 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: + [CreateEventTrigger](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_CreateEventTrigger.html): define qual ação executar com base em uma condição especificada. + [PutIntegration](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_PutIntegration.html): define a ação a ser usada. **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": {{}}, "schedule": { "endTime": "2024-12-11T21:22:00Z", "startTime": "2024-10-31T20:14:49Z", "timeZone": "America/Los_Angeles" }, "source": { "eventTrigger": { "customerProfilesDomainArn": {{}} } ``` + **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.