Skip to main content
​
Versão 2.4.0

​
Leads duplicados são mesclados

O POST /lead não cria mais um lead novo quando a conta já tem um lead com o mesmo CPF/CNPJ, telefone ou e-mail. Nesse caso, a API:
  • devolve o lead existente, com o mesmo formato de resposta e o mesmo status 201;
  • preenche nele só os campos que estavam vazios, sem sobrescrever o que já estava preenchido.
A busca verifica primeiro o CPF/CNPJ, depois o telefone e por fim o e-mail. O telefone é comparado sem DDI e sem formatação, então 5547999999999, +55 (47) 99999-9999 e 47999999999 são o mesmo número. No e-mail, maiúsculas e minúsculas não fazem diferença.
Se a sua integração cria um lead e depois o exclui (por exemplo, em testes), confira o id devolvido antes de excluir: ele pode ser de um lead que já existia na conta.
Veja Criar Lead.

​
Todas as referências precisam ser da sua conta

A conta vem sempre do seu token. Um accountId enviado no corpo é ignorado. Qualquer id que você informar precisa pertencer à conta do token; se não pertencer, a API responde 404 e não grava nada:Nos campos leadOwner, dealOwner e conversationOwnerId, use o id do vínculo devolvido por Listar Membros da Conta, e não o User.id. Antes desta versão, um id inválido nesses campos devolvia 500; agora devolve 404.Também passam a responder 404 quando o registro é de outra conta:
  • GET, PUT e DELETE /account-crm-pipeline-stage/{id};
  • PUT /account-external-conversation/{id}/update-status.
E mais dois ajustes:
  • GET /account-crm-pipeline-stage sem pipelineId devolve só as etapas dos pipelines da sua conta.
  • Em PUT /category/{id}, os campos id, accountId, createdAt e updatedAt do corpo são ignorados.

​
Remetente das mensagens (senderId)

Em POST /whatsapp/send-message e POST /instagram/send-message, o senderId precisa ser de um membro da conta. Você pode enviar o User.id ou o id do vínculo (os dois vêm em Listar Membros da Conta).Um senderId que não é de um membro da conta responde 404 e a mensagem não é enviada. Omita o campo para registrar a mensagem como enviada por IA/automação.

​
Etiquetas

  • DELETE /lead/label/assign responde 404 quando o lead ou a etiqueta não existem na conta. Antes, respondia 200 mesmo sem ter o que remover.
  • POST /lead/label cria sempre etiquetas de lead. Um labelType diferente enviado no corpo é ignorado.

​
Tokens desativados

Um token de API desativado recebe 401 em todas as rotas.