Mesclar usuários
/users/merge
Use este endpoint para mesclar um usuário em outro.
É possível especificar até 50 mesclagens por solicitação. Este endpoint é assíncrono.
Solução de problemas
Uma resposta de sucesso foi retornada, mas o usuário mesclado ainda aparece nas buscas
Uma resposta de sucesso confirma que a solicitação foi aceita. No entanto, a operação de mesclagem tem duas etapas: primeiro os perfis são mesclados e depois o perfil de origem é removido. Por isso, o perfil identifier_to_merge pode continuar aparecendo nas buscas do dashboard por um curto período após uma resposta de sucesso. Esse é o comportamento esperado. Aguarde alguns minutos e depois verifique se a mesclagem foi concluída.
Se o usuário mesclado ainda existir depois de vários minutos, verifique se os identificadores na sua solicitação estão corretos e pertencem a usuários do mesmo espaço de trabalho da chave de API usada na solicitação.
Referência de erros
A tabela a seguir lista as possíveis mensagens de erro.
| Erro | Solução de problemas |
|---|---|
'merge_updates' must be an array of objects |
Verifique se merge_updates é um array de objetos. |
a single request may not contain more than 50 merge updates |
Você só pode especificar até 50 atualizações de mesclagem em uma única solicitação. |
identifiers must be objects with an 'external_id' property that is a string, 'user_alias' property that is an object, 'email' property that is a string, or 'phone' property that is a string |
Verifique os identificadores na sua solicitação. |
'merge_updates' must only have 'identifier_to_merge' and 'identifier_to_keep' |
Verifique se merge_updates contém apenas os dois objetos identifier_to_merge e identifier_to_keep. |
Você pode baixar o documento OpenAPI e usá-lo para validar esquemas. Para saber como, consulte Usar esquemas OpenAPI para validação de solicitações.