Organizações e projetos

A organização é uma pasta de projetos dentro da conta da agência. O projeto é 1 número de WhatsApp + 1 agente, com funil, tags, propriedades, automações e assinatura próprios. Esta página é a referência das operações sobre os dois: criar, editar, mover, exportar, duplicar, trocar a conexão de projeto e excluir. O porquê dessa estrutura (uma organização por cliente final, um projeto por número) está em Agência, cliente final e projeto.

​

Onde fica no painel

Em Configurações → Projetos, cada organização é uma linha que se expande para mostrar os projetos dela. A busca aceita o nome ou o ID do projeto. Criar projeto é tarefa de Admin e Editor. No domínio white-label não existe o botão Novo Projeto: crie pelo endereço principal.

​

Organizações

​

Criar

Configurações → Projetos → Nova Organização. O único campo é o Nome. Também dá para criar uma organização no meio do assistente de Novo Projeto. Admin, Editor e Gestor podem criar. A conta já nasce com uma organização chamada Principal.

​

Renomear

Ícone de lápis na linha da organização (Editar Organização). Só o nome muda.

​

Excluir

Ícone de lixeira na linha da organização. Só é possível com a organização vazia: com projetos dentro, o botão fica desabilitado com o aviso “Não é possível excluir organizações com projetos ativos”. Mova ou exclua os projetos antes.

​

Projetos

​

Criar

As quatro formas (modelo de nicho, em branco, importar JSON e duplicar) e o passo de assinatura estão em Criar a conta e o primeiro projeto. O que vale saber aqui:

• Todo projeto nasce desligado e pendente de pagamento. O agente só liga depois da assinatura. Quem já tem outro projeto pago pode clicar em Deixar para depois e assinar mais tarde em Assinatura.
• O arquivo JSON importado tem limite de 1 MB.
• Motor: todo projeto novo nasce no LangChain Agent, qualquer que seja a forma de criar. Projetos antigos que ainda estão no motor antigo devem ser migrados. Veja Migrar para o LangChain Agent.
• Quem cria entra em todos os departamentos do projeto novo, já recebendo leads. Os demais membros são adicionados depois, em Departamentos.

​

Editar (renomear e mover de organização)

Em Configurações → Projetos, o ícone de lápis do projeto abre Editar Projeto, com dois campos: Nome e Organização. Trocar a organização move o projeto, com tudo o que ele tem, para outra organização da mesma conta.

​

Copiar o ID

O ID aparece abaixo do nome do projeto. Clique nele para copiar (“ID copiado!”). É o project_id que o MCP e a API usam.

​

Exportar o template

O template do projeto é um JSON com tudo: funil, tags, propriedades, automações, fluxos e agente.

• No motor antigo: página Agente → Exportar. A janela deixa escolher quais templates do WhatsApp entram no arquivo.
• No LangChain Agent: não há botão de exportar no painel. Leia o template pelo MCP (get_template) ou pela API de template.

​

Duplicar

Novo Projeto → Duplicar projeto e escolha um projeto da mesma conta. A cópia:

• leva o funil, as tags, as propriedades, as automações, os fluxos e o agente;
• leva todos os templates do WhatsApp, que entram como pendentes de sincronização (nada é enviado à Meta até alguém sincronizar);
• mantém a chave do modelo e os headers das tools, porque a origem é da mesma conta;
• nasce no LangChain Agent, como todo projeto novo.

A cópia não leva a conexão do WhatsApp, os leads, as conversas nem os membros dos departamentos.

​

Trocar a conexão de projeto

O admin pode passar a conexão oficial e a assinatura de um projeto para outro da mesma conta, em WhatsApp → Trocar projeto. O projeto de origem fica desligado e sem assinatura. O passo a passo está em WhatsApp oficial e coexistência.

​

Excluir

Em Configurações → Projetos, a lixeira na linha do projeto. Só o admin exclui. A exclusão é recusada quando: Um projeto pendente (nunca assinado) pode ser excluído direto.

​

Como funciona por trás

• Excluir apaga o projeto inteiro, em cascata: leads, conversas, colunas, tags, propriedades, automações, fluxos, departamentos, chaves de API e o agente. Não há lixeira nem como desfazer. A janela de confirmação diz “Remover projeto da organização”, mas o efeito é a exclusão.
• Excluir não mexe na assinatura. A cobrança só para se a assinatura for cancelada em Assinatura.
• Quem vê qual projeto fica gravado no acesso de cada usuário, por organização e projeto. O admin vê todos. Veja Montar a equipe.

​

Pelo MCP

O MCP não cria, duplica, move nem exclui projetos. Ele lista os projetos que a conexão de IA alcança (list_projects) e lê e escreve o template de um projeto. O bloco meta do template guarda o nome e a descrição do projeto. Trocar meta.name numa escrita renomeia o projeto; a partir daí, o MCP exige o nome novo no par project_id + project_name.

​

Armadilhas

• Excluir um projeto com pagamento vencido não cancela a assinatura. O botão de excluir libera para assinatura que não está ativa, mas a cobrança continua até alguém cancelar em Assinatura. Cancele antes de excluir.
• Mover o projeto de organização pode tirar o acesso de quem o via. O acesso de cada usuário é gravado por organização. Depois de mover, confira em Configurações → Gerenciar Acessos se a equipe do cliente final continua vendo o projeto.
• Projeto novo não aparece sozinho para a equipe. O acesso de quem não é admin lista os projetos um a um, mesmo dentro da organização que a pessoa já vê. Depois de criar um projeto, inclua-o no acesso de cada pessoa em Gerenciar Acessos.
• O JSON exportado tem segredos. Chaves, URLs e headers vão preenchidos.
• Templates do WhatsApp duplicados não chegam aprovados. Eles entram pendentes e precisam ser sincronizados no projeto novo. Veja Templates do WhatsApp.
• Projeto duplicado nasce sem conexão. Conecte o WhatsApp (ou use Trocar projeto) e assine o plano antes de ligar o agente.

​

Perguntas frequentes

​

Vídeo

​

Para saber mais

• Agência, cliente final e projeto
• Criar a conta e o primeiro projeto
• Sobrescrever x atualizar um projeto por template
• Assinatura e limites (referência)
• Referência do template (JSON)
• Termos para buscar: “multi-tenant”, “exclusão em cascata”, “template de projeto Zatten”.