Este artigo apresenta orientações para o bloqueio de endereços de e-mail por meio da API da Dito, incluindo o formato correto da requisição e o prazo de atualização das informações no perfil do contato.
Nível de Acesso: Administrador, Editor.
Persona: Gerente de E-commerce, Diretor de Marketing, Analista de Marketing.

1. Como bloquear um endereço de e-mail pela API
Para bloquear endereços de e-mail inválidos, como caixas abandonadas ou endereços que retornam erros durante as tentativas de envio, é necessário atualizar a informação diretamente no perfil do contato.
Inicialmente, foi realizado um teste utilizando a Ingest API (estruturada), enviando o evento descadastrou-notificacao com a propriedade:
json
{
"custom_data": {
"blacklist_email": "unsubscribe"
}
}
Embora o evento seja aceito pela API e apareça na linha do tempo do contato, essa abordagem não atualiza o campo blacklist_email no perfil.
O procedimento correto é utilizar uma requisição do tipo IDENTIFY, destinada à atualização das características do usuário.

2.1. Como realizar a atualização
Para atualizar uma característica do perfil por meio da API, é necessário realizar duas alterações na estrutura da requisição:
Alterar o type para IDENTIFY.
Alterar a propriedade properties para traits.
Dessa forma, a API interpretará a requisição como uma atualização das características do usuário, em vez de registrar apenas um evento na linha do tempo.
2.2. Documentação e exemplos
Para consultar a estrutura das requisições e outros exemplos de integração, acesse nossa documentação Swagger:
Documentação Swagger – Ingest API da Dito .
2.3. Prazo para atualização
Após o envio da requisição IDENTIFY, a atualização das características do usuário ocorre em aproximadamente de 15/30 minutos no máximo.
Portanto, não é necessário aguardar o processamento diário para que a alteração seja refletida no perfil.
3. Onde visualizar o bloqueio de e-mail no perfil do contato?
É importante destacar que a propriedade blacklist_email possui uma particularidade na interface da Dito.
Diferentemente das demais características personalizadas, ela não aparece na seção Características extras do perfil do contato.

O status do bloqueio é apresentado na área de toggles (chaves de ativação/desativação) do perfil.
Assim, ao adicionar ou remover a propriedade blacklist_email por meio da API, o que será atualizado é o estado do respectivo toggle.
As demais características enviadas por meio do IDENTIFY continuam sendo exibidas normalmente na seção "Características extras.
Importante: o envio de um evento com a propriedade blacklist_email não é suficiente para atualizar o status de bloqueio no perfil. Para essa finalidade, utilize uma requisição IDENTIFY, garantindo que a informação seja processada como uma atualização das características do contato.

FAQ – Perguntas Frequentes
1. Como solicitar o reenvio do e-mail de definição de senha?
Resposta: É possível solicitar o reenvio do e-mail de definição de senha para o endereço de e-mail cadastrado do cliente. Caso necessário, também pode ser utilizado um endereço de e-mail alternativo.
Para mais detalhes sobre o procedimento, consulte o artigo: [Como realizar o primeiro acesso e definir a senha da Service Account (SA)].
2. Como bloquear um endereço de e-mail pela API?
Resposta: Para bloquear um endereço de e-mail inválido, como caixas abandonadas ou endereços que retornam erros de envio, é necessário realizar uma atualização no perfil do contato por meio de uma requisição do tipo IDENTIFY.
O envio de um evento comum, como descadastrou-notificacao, com a propriedade blacklist_email não atualiza o status de bloqueio no perfil.
3. Qual é o tipo de requisição correto para atualizar o campo blacklist_email?
Resposta: Deve ser utilizada uma requisição do tipo IDENTIFY. Para isso, é necessário alterar o campo type para IDENTIFY e utilizar traits no lugar de properties.
Essa estrutura permite atualizar diretamente as características do usuário.
Ficou com alguma dúvida ou identificou algum problema? Acione nosso time pelo chat disponível no app dito. (Horário de Atendimento de Segunda a Sexta das 9hrs as 18hrs)
Este artigo foi útil?
Que bom!
Obrigado pelo seu feedback
Desculpe! Não conseguimos ajudar você
Obrigado pelo seu feedback
Feedback enviado
Agradecemos seu esforço e tentaremos corrigir o artigo
