Repository files navigation

• Installed Package:
  • Crie umInstalled Package na sua conta Salesforce Marketing Cloud.
  • Adicione um componente deAPI Integration (Server-to-Server).
  • Conceda as permissões necessárias para acessar o endpoint:

    /contacts/v1/contacts/actions/delete

  • Anote os seguintes valores:
    • Client ID
    • Client Secret
    • Subdomínio
    • MID

• Acesse oContact Configuration e habilite a funcionalidade de exclusão de contatos em sua BU.

• Se necessário, ajuste as configurações ou contate o suporte para liberar esta funcionalidade.
• Caso seja necessário, clique emManage Settings e altere a supressão para0 dias.
  (Apenas faça isso se estiver seguro do processo.)

• A Data Extension que armazena os contatos a serem deletados deve serSendable.
• Anote aExternal Key da Data Extension para referenciá-la no script.

• A abaContact Analytics ficará disponível somente após a habilitação da funcionalidade de exclusão de contatos em sua BU.
• A exclusão dos contatos é realizada de formaassíncrona.
• Pode haver um período em que os contatos ainda permanecem visíveis até que o processo seja concluído
  (aguarde alguns minutos).

⚠️ATENÇÃO - Riscos e Considerações Importantes⚠️
A exclusão de contatos é uma ação irreversível. Certifique-se de revisar os contatos a serem deletados e realizar backups, se necessário.

• Ação Irreversível: Uma vez que um contato é excluído, o processo não pode ser desfeito.
• Perda de Histórico: Ao apagar um contato, você perderá todo o histórico de engajamento associado, como aberturas, cliques, conversões e outras interações.
• Perda de Dados do Dispositivo: Informações como DeviceID e outros dados relacionados aos dispositivos utilizados pelos contatos serão removidos.
• Perda de Atributos Personalizados: Qualquer dado adicional, como atributos customizados e preferências, será perdido, o que pode impactar análises futuras e segmentações.
• Impacto nas Métricas: A remoção de contatos pode afetar relatórios e métricas previamente consolidadas, alterando a visão geral da performance da sua conta.

Recomenda-se realizar testes em um ambiente controlado e manter backups dos dados antes de proceder com a exclusão completa.

✒️ Este código foi baseado nos conteúdos e nas ideias apresentadas nos seguintes artigos:

• Digital Marketing on Cloud by Lukas Lunow
• Salesforce StackExchange

Caso tenha qualquer tipo de dúvida ou sugestão, fico disponível pelo meu LinkedIn. 😁 🤙

• Installed Package:
  • Create anInstalled Package in your Salesforce Marketing Cloud account.
  • Add aServer-to-Server API Integration component.
  • Grant the necessary permissions to access the endpoint:

    /contacts/v1/contacts/actions/delete

  • Note down the following values:
    • Client ID
    • Client Secret
    • Subdomain
    • MID

• AccessContact Configuration and enable the contact deletion feature in your Business Unit (BU).

• If necessary, adjust the settings or contact support to enable this functionality.
• If required, click onManage Settings and set the suppression period to0 days.
  (Only do this if you are sure about the process.)

• The Data Extension that stores the contacts to be deleted must beSendable.
• Note theExternal Key of the Data Extension to reference it in the script.

• TheContact Analytics tab will only be available after enabling the contact deletion feature in your BU.
• Contact deletion is performedasynchronously.
• There might be a delay during which contacts remain visible until the process is complete
  (please wait a few minutes).

⚠️WARNING - Risks and Important Considerations⚠️
Contact deletion is an irreversible action. Make sure to review the contacts to be deleted and back up your data if necessary.

• Irreversible Action: Once a contact is deleted, the process cannot be undone.
• Loss of History: Deleting a contact will remove all associated engagement history, such as opens, clicks, conversions, and other interactions.
• Loss of Device Data: Information such as DeviceID and other data related to the devices used by contacts will be removed.
• Loss of Custom Attributes: Any additional data, such as custom attributes and preferences, will be lost, which may impact future analyses and segmentation.
• Impact on Metrics: Removing contacts can affect consolidated reports and metrics, altering the overall performance view of your account.

It is recommended to test in a controlled environment and back up your data before proceeding with complete deletion.

✒️ This code is based on the content and ideas presented in the following articles:

• Digital Marketing on Cloud by Lukas Lunow
• Salesforce StackExchange

If you have any questions or suggestions, feel free to reach out to me on LinkedIn. 😁 🤙