Configurar uma lista de permissões allow-list
A lista de permissões é uma lista de segurança de envio que você pode definir no nível sandbox. Ele restringe o envio de emails para endereços ou domínios específicos, garantindo que somente os recipients explicitamente listados possam receber mensagens de uma determinada sandbox.
Em sandboxes de não produção, em que podem ocorrer envios acidentais, a lista de permissões impede que mensagens indesejadas cheguem a endereços reais de clientes, fornecendo um ambiente seguro para fins de teste.
Quando a lista de permissões está ativa, mas vazia, nenhum email é enviado. Isso faz dele um freio de emergência útil: se ocorrer um problema crítico, você pode ativar uma lista de permissões vazia para interromper todas as comunicações de saída de Journey Optimizer até que o problema seja resolvido. Saiba mais sobre a lógica de lista de permissões.
Você também pode usar a API REST de Supressão do Journey Optimizer para gerenciar mensagens de saída de forma programática por meio de supressão e listas de permissões. Saiba como trabalhar com a API REST de supressão
Acessar a lista de permissões access-allowed-list
Para acessar a lista detalhada de domínios e endereços de email permitidos, vá para Administração > Canais > Configurações de email e selecione Lista de permissões.
Para exportar a lista de permissões como um arquivo CSV, selecione o botão Baixar CSV.
Use o botão Excluir para remover permanentemente uma entrada.
Você pode pesquisar endereços de email ou domínios e filtrar por Tipo de endereço. Depois de selecionado, é possível limpar o filtro exibido na parte superior da lista.
Ativar a lista de permissões enable-allow-list
Para ativar a lista de permissões, siga as etapas abaixo.
-
Acesse o menu Canais > Configuração de email > Lista de permissões.
-
Selecione o botão de alternância.
-
Selecione Ativar lista de permissões. A lista de permissões agora está ativa.
note NOTE - Após a ativação, há um atraso de 10 minutos antes da lista de permissões entrar em vigor em jornadas e campanhas. As atualizações na lista de lista de permissões e supressão também podem levar até 10 minutos para serem refletidas.
- Quando ativa, a lista de permissões é imposta não apenas em jornadas ativas, mas também ao testar mensagens com provas e jornadas no modo de teste.
A lógica de lista de permissões se aplica quando o recurso está ativo. Saiba mais nesta seção.
Desativar a lista de permissões deactivate-allow-list
Para desativar a lista de permissões, siga as etapas abaixo.
-
Acesse o menu Canais > Configuração de email > Lista de permissões.
-
Selecione o botão de alternância.
-
Selecione Desativar lista de permissões. A lista de permissões não está mais ativa.
note NOTE Depois de desativar a lista de permissões, há um atraso de 10 minutos antes de ela entrar em vigor em suas jornadas e campanhas. Da mesma forma, as atualizações nas listas de lista de permissões e supressão podem levar até 10 minutos para serem refletidas.
A lógica de lista de permissões não se aplica quando o recurso é desativado. Saiba mais nesta seção.
Adicionar entidades à lista de permissões add-entities
Para adicionar novos domínios ou endereços de email à lista de permissões para uma sandbox específica, você pode preencher manualmente a lista ou usar uma chamada de API.
Preencher manualmente a lista de permissões manually-populate-list
Você pode preencher manualmente a lista de permissões Journey Optimizer adicionando um endereço de email ou um domínio por meio da interface do usuário.
Para fazer isso, siga as etapas abaixo.
-
Selecione o botão Adicionar email ou domínio.
-
Escolha o tipo de endereço: Endereço de email ou Endereço de domínio.
-
Insira o endereço de email ou domínio para o qual deseja enviar emails.
note NOTE Certifique-se de inserir um endereço de email (como abc@empresa.com) ou de domínio (como abc.empresa.com) válido. -
Especifique um motivo, se necessário.
note NOTE Todos os caracteres ASCII no intervalo de 32 a 126 são permitidos no campo Motivo. Para referência, consulte a lista completa nesta página. -
Clique em Enviar.
Adicionar entidades usando uma chamada de API api-call-allowed-list
Para preencher a lista de permissões, você também pode chamar a API de supressão com o valor ALLOWED para o atributo listType. Por exemplo:
Você pode executar as operações Adicionar, Excluir e Obter.
Saiba mais sobre como fazer chamadas de API na documentação de referência das APIs do Adobe Experience Platform.
Baixar a lista de permissões download-allowed-list
Para exportar a lista de permissões como um arquivo CSV, siga as etapas abaixo:
-
Selecione o botão Baixar CSV.
-
Espere até que o arquivo seja gerado.
note NOTE O tempo de download depende do tamanho do arquivo, o que significa o número de endereços na lista de permissões. Uma solicitação de download pode ser processada de cada vez para uma determinada sandbox. -
Depois que o arquivo for gerado, você receberá uma notificação. Clique no ícone de sino na parte superior direita da tela para exibi-lo.
-
Click the notification itself to download the file.
note NOTE The link is valid for 24 hours.
Lógica de lista de permissões logic
When the allowed list is active, the following logic applies:
-
If the allowed list is empty, no email will be sent out.
-
If an entity is on the allowed list, and not on the suppression list, the email is sent to the corresponding recipient(s). However, if the entity is also on the suppression list, the corresponding recipient(s) will not receive the email, the reason being Suppressed.
-
If an entity is not on the allowed list (and not on the suppression list), the corresponding recipient(s) will not receive the email, the reason being Not allowed.
When the allowed list is deactivated, all the emails that you are sending from the current sandbox are sent out to all recipients (provided they are not on the suppression list), including real customer addresses.
Exclusion reporting reporting
When the allowed list is active, you can retrieve email addresses or domains that were excluded from a sending because they were not on the allowed list. To do this, you can use the Adobe Experience Platform Query Service to make the API calls below.
To get the number of emails that were not sent because the recipients were not on the allowed list, use the following query:
SELECT count(distinct _id) from cjm_message_feedback_event_dataset WHERE
_experience.customerJourneyManagement.messageExecution.messageExecutionID = '<MESSAGE_EXECUTION_ID>' AND
_experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus = 'exclude' AND
_experience.customerJourneyManagement.messageDeliveryfeedback.messageExclusion.reason = 'EmailNotAllowed'
To get the list of email addresses that were not sent because the recipients were not on the allowed list, use the following query:
SELECT distinct(_experience.customerJourneyManagement.emailChannelContext.address) from cjm_message_feedback_event_dataset WHERE
_experience.customerJourneyManagement.messageExecution.messageExecutionID IS NOT NULL AND
_experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus = 'exclude' AND
_experience.customerJourneyManagement.messageDeliveryfeedback.messageExclusion.reason = 'EmailNotAllowed'