Excluir contatos com a API REST
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Excluir contatos em lotes com a API REST.
- Obter o status das solicitações de Exclusão de contatos.
- Solucionar problemas das solicitações de exclusão de contatos.
Excluir contatos com mais eficiência
É bem simples excluir um ou dois contatos diretamente do Marketing Cloud Engagement. No entanto, se for excluir muitos mais, o processo poderá rapidamente se tornar tedioso. Portanto, embora o limite por lote de solicitação seja de um milhão de contatos, não esperamos que você selecione esse número de contatos manualmente. Portanto, se precisar excluir um grande número de contatos (e estiver bem informado para garantir que a exclusão de contatos será a melhor opção), há vários recursos da API REST disponíveis para fazer isso no Marketing Cloud Engagement.
Habilitar a Exclusão de contatos
Lembre-se de que a Exclusão de contatos precisa estar ativada antes de começar. Consulte a unidade anterior para relembrar como fazer isso. Da mesma forma, você pode modificar o período de supressão da conta com o recurso configSettings, conforme mostrado neste exemplo.
Exemplo: Configurar o período de supressão da exclusão de contatos
Este exemplo define o valor para 0 dias (usando um valor de -1) ou uma exclusão imediata.
Optar por excluir contatos com a API REST
Agora que sua conta está ativada para excluir contatos, você pode usar um dos três valores diferentes para escolher quais contatos excluir: IDs de contatos, chaves de contatos ou extensões de dados. Vamos dar uma olhada mais atenta em cada um, juntamente com códigos de exemplo.
IDs de contatos
Se optar por excluir contatos usando um valor de ID de contato, você deve passar os valores em uma matriz, como mostrado neste exemplo.
Exemplo: Excluir contatos pela ID de contatos
Chaves de contatos
Se optar por excluir contatos usando o valor ContactKey, você também deve transmitir esses valores em uma matriz.
Exemplo: Excluir contatos pelas chaves de contatos
Extensões de dados
Você também pode optar por remover todos os contatos contidos em uma extensão de dados específica. Lembre-se de que esta operação exclui os registros de contato descritos na extensão de dados em todas as extensões de dados enviáveis. Isso inclui extensões de dados que enviam com base nos valores de ContactKey, ContactID e Endereço de email. Você também pode decidir se deve ou não excluir toda a extensão de dados quando terminar. São tantas opções!
Esse processo cria uma solicitação assíncrona para seu lote de solicitações de exclusão. Você pode entrar em contato com o gerente da conta do Marketing Cloud Engagement para obter mais informações sobre como configurar os limites de solicitação de exclusão na conta.
Exemplo: Excluir contatos usando uma extensão de dados
Verifique suas solicitações
Como mencionamos, as solicitações de exclusão de contatos levam algum tempo para serem concluídas. Na verdade, o processo pode levar várias horas dependendo de quantos contatos você incluiu na solicitação, quantas solicitações você fez e outros fatores do sistema. No entanto, você pode manter-se atualizado sobre o andamento das solicitações usando o valor de OperationID. Cada solicitação de Exclusão de contatos retorna um valor de OperationID que pode ser usado para recuperar todas as informações disponíveis. Veja algumas solicitações de exemplo.
Exemplo: Obter o status de uma solicitação de exclusão de contatos específica
Esta resposta de exemplo mostra as informações de um contato excluído.
Exemplo: Recuperar solicitações de exclusão de contatos por data
Você também pode recuperar um resumo das solicitações feitas durante determinado período.
A resposta inclui os valores de OperationID e resumos curtos de todas as solicitações aplicáveis. Para obter informações mais específicas, use o OperationID com o recurso /contacts/v1/contacts/actions/delete/status?operationID=
.
Exemplo: Recuperar um resumo das solicitações de exclusão de contatos
Este exemplo exibe um resumo dos relatórios de status de todas as solicitações durante o período especificado.
A resposta de exemplo divide as solicitações em concluídas, em processamento ou inválidas.
Você pode usar os valores de OperationID para acompanhar solicitações inválidas ou que estejam em processamento.
Muitos códigos, não é? Vamos deixar o código um pouco de lado e prosseguir para a unidade final para ver qual é a melhor maneira de evitar armadilhas durante a exclusão de contatos.
Recursos
- Desenvolvedor do Salesforce: Configuração da Exclusão de contatos
- Desenvolvedor do Salesforce: Excluir pela ID de contatos
- Desenvolvedor do Salesforce: Excluir pela chave de contatos
- Desenvolvedor do Salesforce: Excluir pela referência da lista
- Desenvolvedor do Salesforce: Status da Exclusão de contatos
- Desenvolvedor do Salesforce: Detalhes das solicitações de Exclusão de contatos
- Desenvolvedor do Salesforce: Resumo das solicitações de Exclusão de contatos