- Atualizar (modo aditivo): cria o que falta, atualiza o que existe e nunca apaga. É o que o MCP e a API de template fazem.
- Sobrescrever (modo destrutivo): apaga a configuração do projeto e recria a partir do template. Hoje o painel não oferece essa opção.
Qual caminho usar
Atualizar (aditivo)
A regra é uma só: cria o que falta, atualiza o que existe e nunca apaga.- Só os blocos enviados são considerados. Mandar
tagsmexe só nas tags. - O bloco enviado é a lista completa daquele tipo. O que existe no projeto e não veio vira órfão: fica intacto e volta na resposta para alguém decidir no painel.
- Cada item é reconhecido pela chave do bloco (
slugem colunas, tags, departamentos, propriedades e skills; nome nos demais). Com oslug, dá para renomear sem perder o vínculo com os leads. - Endereço ou credencial vazio não grava por cima. Exceção: dentro de
langchain.config, a chave do modelo e a do LangSmith só são preservadas quando o campo está ausente;""grava vazio e o agente para de responder. - Automação nova nasce desligada.
- O agente (bloco
langchain) vira uma versão não publicada. Uma pessoa publica no painel. - Aplicar o mesmo template duas vezes não muda nada na segunda.
Sobrescrever (destrutivo)
O modo de sobrescrever apaga a configuração do projeto e grava a do template no lugar. Ele já existiu no painel (Agente → Importar → Sobrescrever atual) e não está mais disponível: o botão de importar saiu da página do agente em 07/04/2026. Vídeos e textos antigos ainda podem citá-lo. Se um dia alguém pedir para “sobrescrever o projeto”, é isto que esse modo fazia, e por que ele foi trocado pelo aditivo:Como recomeçar um projeto sem perder o número
Quando o projeto em produção precisa de uma configuração inteiramente nova:1
Crie o projeto novo
Novo Projeto, com o modelo, em branco ou Importar JSON. Se a conta já tem outro
projeto pago, use Deixar para depois no passo da assinatura.
2
Configure e teste
Monte o agente, o funil e as automações no projeto novo. Teste no chat de teste do
agente. O projeto novo já nasce no LangChain Agent.
3
Passe o número
No projeto antigo, WhatsApp → Trocar projeto e escolha o novo. A conexão oficial e
a assinatura vão para o projeto novo; o antigo fica desligado. Só o admin faz.
4
Confira e limpe
No projeto novo, sincronize os templates do WhatsApp, ligue as automações e o agente.
Depois, guarde o que precisar do antigo (o template pelo MCP ou pela
API de template) e exclua-o.
Pelo MCP
update_template é sempre aditivo. Não há opção de sobrescrever, nem pelo MCP nem pela
API de template.
Armadilhas
- “Atualizar” não remove. Um item que saiu do template continua no projeto e continua agindo (uma automação ligada segue ligada). Desligue ou exclua no painel.
- Mandar um bloco com um item só deixa os outros como órfãos. Eles não são apagados, mas o relatório fica cheio de “ficou de fora”.
- Renomear sem
slugcria um item novo e deixa o antigo como órfão. - Importar JSON sempre cria um projeto novo. Não existe “importar por cima” no painel.
- Trocar projeto leva a assinatura junto. O projeto antigo fica sem assinatura; o novo passa a ser o cobrado.
Perguntas frequentes
Como apago os órfãos?
Como apago os órfãos?
No painel, na tela de cada item. As travas continuam valendo: coluna com leads não
pode ser excluída, por exemplo. O assistente só guia; quem apaga é uma pessoa.
Atualizar mexe nos leads?
Atualizar mexe nos leads?
Não diretamente. Renomear uma coluna pelo
slug mantém os leads nela. Mudar uma
propriedade de texto livre já preenchida para lista é recusado, com nota.E se eu quiser zerar só o funil?
E se eu quiser zerar só o funil?
Crie as colunas novas pelo template, mova os leads no painel e exclua as colunas
antigas vazias. Coluna com leads não pode ser excluída.
Para saber mais
- Como uma escrita funciona
- Referência do template (JSON)
- Organizações e projetos
- WhatsApp oficial e coexistência: trocar a conexão de projeto.
- API de template (REST)
- Termos para buscar: “operação idempotente”, “upsert”, “aplicação aditiva”.