Por padrão, a atualização de dados via API é incremental: os dados de um lead já existente não são sobrescritos; apenas os campos que estiverem sem informação serão atualizados.
Isso evita problemas — por exemplo, quando você altera a informação de um lead e depois ele faz uma nova conversão digitando algo errado, o modo incremental garante que a informação permaneça fiel ao que já havia sido preenchido.
Se o modo for alterado de incremental para geral, qualquer dado enviado via API será atualizado. Use esse recurso apenas em casos específicos em que haja necessidade de atualizar as informações da base pelas integrações.
Como cada modo funciona
O contato é identificado pelo e-mail. Se o e-mail já existir na base, a nova conversão atualiza esse mesmo contato, de acordo com o modo configurado.
Incremental (padrão): apenas os campos vazios do contato são preenchidos. Campos que já têm informação não são alterados, mesmo que a nova conversão envie um valor diferente.
Geral: todos os campos enviados são atualizados. Se um campo for enviado em branco, a informação existente é apagada. Campos que não forem enviados na conversão não são alterados.
Exemplo
O contato tem Nome "Ana", Cargo vazio e Empresa "Loja X". Uma nova conversão envia Nome "Ana Souza", Cargo "Gerente" e Empresa em branco.
Modo incremental: o Nome continua "Ana", o Cargo passa a ser "Gerente" e a Empresa continua "Loja X".
Modo geral: o Nome passa a ser "Ana Souza", o Cargo passa a ser "Gerente" e a Empresa fica vazia.
Quando usar o modo geral
O modo geral é indicado quando o mesmo contato precisa ter as informações atualizadas a cada nova conversão, por exemplo:
E-commerce: manter os dados da última compra (valor, data, produtos) para usar nas automações.
Clínicas e agendamentos: atualizar a data da consulta a cada novo agendamento.
Integrações com CRM: manter o contato sincronizado com as mudanças feitas no CRM.
Importante: informações substituídas ou apagadas pelo modo geral não podem ser recuperadas e essas alterações não ficam registradas na linha do tempo do contato. Antes de solicitar a mudança, confirme quais campos cada integração envia e evite enviar campos em branco.
Como solicitar a alteração do modo
Acesse o seu usuário no canto superior direito e clique na aba Integrações.
Clique no botão Configurar ao lado da empresa Ramper Marketing.
Nas configurações da integração, clique no botão Formato de atualização para solicitar a alteração.
Após a liberação, você pode aplicar o modo geral a todos os eventos de conversão ou apenas a eventos específicos. Recomendamos ativá-lo somente nos eventos que realmente precisam de atualização.
Atenção: para que as integrações apareçam nessa tela e possam ser marcadas, é necessário haver ao menos uma integração do tipo. Por exemplo, se você integrou um formulário de contato do seu site por API, a integração só será exibida após a primeira conversão por esse formulário.