Histórico de mudanças da API pública do Novus CRM. Aqui entram endpoints novos, campos novos em requisições e respostas, mudanças de comportamento e ferramentas MCP. Esta página é para quem integra sistemas com o Novus CRM. As novidades da plataforma, como telas e recursos que aparecem para quem usa o produto, ficam em Novidades.
Os caminhos abaixo são relativos à base da API pública e usam a versão v1. A autenticação por chave de API continua a mesma.

Atualizações recentes

Origens do negócio: CRUD completo

Novo recurso v1/origens-do-negocio, com listagem paginada, filtros e escrita.O corpo de criação aceita nome, cor e ativo, que vem como true quando omitido.
Ferramentas MCP: listar_origens_do_negocio, obter_origem_do_negocio, criar_origem_do_negocio, atualizar_origem_do_negocio e excluir_origem_do_negocio.

Ícone nos tipos de atividade

  • v1/tipos-de-atividade aceita e retorna icone, o nome do ícone, com até 60 caracteres (ex.: "phone", "calendar")
  • As respostas de atividade passam a trazer iconeTipoDeAtividade já resolvido a partir do tipo, o que dispensa uma segunda chamada só para exibir o ícone

Etiquetas do contato

Três rotas novas em v1/contatodechat para trabalhar as etiquetas de um contato sem mexer no cadastro dele.
Ferramentas MCP: listar_etiquetas_contato, vincular_etiquetas_contato e desvincular_etiqueta_contato.

Prioridade do negócio

O negócio ganhou o campo prioridade, aceito na criação e na atualização e disponível como filtro na listagem.Os valores aceitos são Nenhum, Baixa, Normal, Media, Alta e Urgente. Omitir o campo na criação equivale a Normal, e na atualização mantém a prioridade atual. Para filtrar, use ?prioridade=Alta.

Mover negócio entre pipelines

A etapa precisa pertencer ao pipeline de destino. Omitindo idEtapaDestino, o negócio entra na primeira etapa dele.Ferramenta MCP: mover_negocio_para_pipeline.

Exclusão de negócio passa a limpar os vínculos

O DELETE de negócio pela API pública passa a executar a mesma limpeza da exclusão feita pela plataforma. Ele remove atividades, anotações e arquivos do negócio e desfaz os vínculos que sobreviveriam à exclusão da linha. O caso que mais doía era o e-mail em fila de envio, que guardava o ID do negócio e ficava apontando para um registro inexistente.
O contrato não mudou. Mesma rota, mesma resposta. O que muda é o efeito colateral da exclusão.

Usuários

  • Nova ferramenta MCP listar_usuarios
  • GET /v1/usuarios passa a retornar administrador, booleano, e assinaturaTicket, o HTML anexado às respostas de ticket do usuário

Registrar mensagem como nota interna

Os três endpoints de envio aceitam o campo booleano nota, com padrão false:
  • POST /v1/message/SendText/{idCanal}
  • POST /v1/message/SendMedia/{idCanal}
  • POST /v1/message/SendAudio/{idCanal}
Com "nota": true, o conteúdo é gravado como nota interna do atendimento. Ele fica visível apenas para a equipe, e nada é entregue ao contato pelo canal. A mensagem nasce com status Nota em vez de Enviada.
Como a nota não trafega pelo canal, a validação que exige número ativo no WhatsApp Web não se aplica a ela. Registrar uma anotação interna não depende de o contato existir no WhatsApp.
As mudanças anteriores a esta data não foram registradas. Daqui em diante, toda alteração da API pública aparece nesta página.