Snapshots #

Visão geral #

Snapshots permitem que você empacote seus melhores agentes de IA — juntamente com tudo o que eles sabem e todas as ferramentas que utilizam — em um modelo reutilizável, e instale esse modelo em qualquer uma de suas subcontas com um clique.

Perfeccione sua configuração uma vez em sua própria conta, capture-a como um snapshot e cada novo cliente começará a partir dessa configuração comprovada em vez de uma página em branco. Você também pode compartilhar um snapshot com um link, para que qualquer pessoa com uma conta possa instalá-lo.

Um snapshot inclui, por agente:

• A configuração completa do agente — instruções, playbook, personalidade, comportamento e configurações de resposta, horas ativas.
• Conhecimento (opcional): as FAQs e fontes da base de conhecimento do agente, incluindo arquivos enviados.
• Ferramentas (opcional): as funções personalizadas do agente e servidores MCP conectados.
• Biblioteca de mídia (opcional): as imagens, vídeos e documentos que o agente pode enviar, com suas instruções de envio.

Os snapshots são congelados no momento da captura. Se você continuar editando o agente depois, o snapshot não muda — capture um novo quando quiser um modelo atualizado.

Contas de agência no novo espaço de trabalho de Agentes. Os Snapshots existem para distribuir configurações de agentes de uma agência para suas subcontas, portanto, a página aparece assim que sua conta de agência estiver operando no novo espaço de trabalho de Agentes (as contas são movidas automaticamente — você não precisa fazer nada). As subcontas também podem receber um snapshot assim que estiverem no espaço de trabalho de Agentes; o seletor de aplicação mostra quais estão prontas. Qualquer cliente novo que você criar assim que sua agência estiver no espaço de trabalho começará lá automaticamente, então ele estará pronto para receber um snapshot imediatamente — sem espera e sem nada para ativar.

Onde encontrar Snapshots #

Clique em Snapshots na barra lateral principal — ela fica logo abaixo de Subcontas, perto da parte inferior do menu.

Capturando um Snapshot #

1. Abra Snapshots e clique em Novo snapshot.
2. Dê a ele um nome reconhecível — por exemplo, “Kit inicial para imobiliárias”.
3. Marque os agentes a serem incluídos. Você pode agrupar vários agentes em um único snapshot.
4. Escolha o que será incluído:
   • Incluir conhecimento — FAQs e fontes da base de conhecimento (com seus arquivos).
   • Incluir ferramentas — funções personalizadas e servidores MCP.
   • Incluir biblioteca de mídia — as imagens, vídeos e documentos que o agente pode enviar.

5. Clique em Capturar snapshot. A captura pode levar algum tempo quando muito conhecimento é incluído.

O novo snapshot aparece na lista com um resumo do que está dentro:

Aplicando um Snapshot #

1. Clique em Aplicar em um snapshot.
2. Marque as contas nas quais deseja instalar — qualquer uma de suas subcontas ou sua própria conta de agência (o que lhe dá uma cópia nova de tudo).

3. Clique em Aplicar em N contas.

Uma nova cópia de cada agente no snapshot — além de seu conhecimento e ferramentas — é criada na conta de destino. Aplicar o mesmo snapshot duas vezes cria uma segunda cópia; nada é sobrescrito.

Agentes instalados iniciam pausados #

Os agentes chegam na conta de destino desativados, propositalmente: algumas coisas são específicas da conta e precisam ser configuradas no destino antes que o agente entre em operação:

• Canais — conecte os próprios canais de WhatsApp / Instagram / outros da conta de destino e aponte-os para o novo agente.
• Calendário e agendamentos — se o agente original agendava compromissos, reconecte um calendário na conta de destino e reative os agendamentos.
• Integrações conectadas que usam OAuth (por exemplo, um servidor MCP que você autorizou com um botão “Conectar”) — por segurança, essas conexões nunca são copiadas, portanto, a conta de destino autoriza as suas próprias. Ferramentas que usam uma chave de API simples continuam funcionando imediatamente.

Assim que os canais estiverem conectados, alterne o agente para ativo na página Agentes de IA da conta de destino.

Aplicando a vários clientes de uma vez #

A lista Instalar em permite que você marque quantas contas desejar. Use Selecionar todas as subcontas para aplicar o modelo a toda a sua base de clientes de uma só vez e, em seguida, clique em Aplicar em N contas. Cada conta é processada por vez e a janela mostra o resultado por conta — instalado, ignorado ou falha com o motivo — para que uma conta que não pôde ser configurada nunca interrompa as outras.

Ignorar contas que já possuem este snapshot está ativado por padrão: uma conta que já recebeu este snapshot exato é ignorada em vez de receber uma segunda cópia. Desative se você quiser deliberadamente outra cópia. Cópias instaladas antes de setembro de 2026 não são reconhecidas por esta verificação, portanto, contas que receberam modelos antes dessa data são tratadas como novas.

Instalando um Snapshot em cada novo cliente automaticamente #

Se você sempre inicia clientes a partir da mesma configuração, não precisa aplicar o snapshot manualmente todas as vezes. Marque um snapshot como seu padrão e cada nova conta de cliente que você criar já virá com ele instalado.

1. Abra Snapshots.
2. Clique na estrela na coluna Novos clientes no snapshot desejado.

A linha marcada com estrela exibe um selo Padrão. Apenas um snapshot pode ser o padrão — marcar outro fará com que a definição seja transferida. Clique na estrela novamente para desativá-la, e as novas contas voltarão a ser criadas vazias.

Isso se aplica a todas as formas de criação de uma conta de cliente:

• Você a cria manualmente na página Subcontas.
• Sua integração a cria através da API.
• Um cliente compra através do seu próprio link de checkout e a conta dele é criada automaticamente.

Este último ponto é o objetivo do recurso: um cliente pode pagar em seu site e chegar ao seu painel personalizado com seu agente, base de conhecimento, ferramentas e mídia já presentes, sem que você precise fazer nada.

Algumas coisas que vale a pena saber:

• Agentes instalados ainda iniciam pausados, exatamente como ocorre com uma aplicação manual — você conecta os canais do cliente primeiro e, em seguida, ativa o agente.
• A instalação ocorre logo após a criação da conta. Se ela não puder ser concluída por qualquer motivo, a conta do cliente ainda será criada e estará utilizável — ela apenas chegará vazia, e você poderá aplicar o snapshot manualmente.
• Excluir o snapshot marcado como padrão remove a definição automaticamente.

Compartilhando um Snapshot com um Link #

Você pode entregar um snapshot a qualquer pessoa com uma conta na plataforma — uma agência parceira, um cliente que gerencia sua própria conta ou a comunidade — sem que eles precisem ser uma de suas subcontas. Nada específico da conta é transferido com ele, e você pode interromper o compartilhamento a qualquer momento.

1. Clique em Compartilhar em um snapshot.
2. Escolha quem pode instalá-lo:
   • Qualquer pessoa com o link.
   • Apenas membros do Champions Circle — o link só funciona para contas que são membros da comunidade.
3. Clique em Criar link e copie-o.

Antes de enviar o link, leia a lista de verificação Antes de compartilhar na mesma janela. Ela lista:

• Campos de preenchimento que serão solicitados ao instalador (veja abaixo).
• Funções personalizadas para revisar — o endereço da web de cada função é mostrado, pois aponta para seus sistemas. Quaisquer valores de cabeçalho que a função envia (chaves de API, tokens) são limpos na cópia instalada; os nomes dos cabeçalhos permanecem para que o instalador saiba o que preencher. O instalador vê a mesma lista e é instruído a revisar essas funções antes de ativar o agente.
• Servidores MCP que precisam de suas chaves novamente — chaves de API para seus servidores MCP conectados nunca são incluídas em uma instalação compartilhada. Elas chegam desativadas na conta do instalador, e o instalador insere sua própria chave.

A linha mostra quantas vezes o snapshot foi instalado. Novo link fornece um link novo e faz com que o antigo pare de funcionar; Parar compartilhamento desativa o link completamente. Ambos deixam todas as cópias que já foram instaladas intactas.

Campos de preenchimento #

Escreva {{company_name}}, {{support_email}}, {{website}}, {{booking_link}} ou qualquer outro {{word}} nas instruções, FAQs ou descrições de mídia do agente e isso se tornará um campo que o instalador preenche antes de instalar. Os valores do instalador substituem os campos em todo o texto; seu snapshot original permanece inalterado.

{{first_name}} e {{personal_context}} são as variáveis de mensagem próprias da IA, portanto, elas são deixadas como estão e nunca transformadas em um campo de preenchimento.

Instalando um Snapshot que alguém compartilhou com você #

Abra o link que lhe foi enviado enquanto estiver conectado (ou faça login quando solicitado — você retornará à página de instalação depois). Você verá o nome do snapshot, quem o compartilhou, os agentes que ele contém e o que há dentro, então:

1. Preencha quaisquer campos que o autor deixou para você, como o nome da sua empresa ou site. Todos eles são opcionais.
2. Escolha onde instalar — sua própria conta ou uma de suas subcontas, caso você gerencie uma agência.
3. Clique em Instalar.

Os agentes são copiados para a conta que você escolheu e iniciam pausados, exatamente como um snapshot aplicado a partir da página de Snapshots. Antes de ativá-los:

• Conecte seus próprios canais e aponte-os para os novos agentes.
• Revise quaisquer funções personalizadas listadas na tela de confirmação — elas chamam os endereços da web do autor.
• Insira sua própria chave em qualquer servidor MCP listado lá e, em seguida, ative-o.
• Reconecte um calendário se o agente agendar compromissos.

A instalação conta para o limite de agentes da sua conta, assim como qualquer outro agente que você criar.

Gerenciando Snapshots #

• Renomear — o ícone de lápis em uma linha.
• Excluir — remove o snapshot e seus arquivos armazenados. As contas às quais você o aplicou não são afetadas: tudo o que foi instalado permanece instalado.

O que não está incluído #

• Conexões de canal e números de telefone (sempre específicos da conta).
• Calendários e conexões de agendamento.
• Logins OAuth para integrações conectadas.
• Contatos, chats e histórico de conversas — snapshots carregam sua configuração, nunca dados de clientes.
• Modelos de mensagem do WhatsApp (estes são aprovados por conta e devem ser recriados no destino).
• Chaves de API de servidores MCP e valores de cabeçalho de funções personalizadas, quando um snapshot é instalado a partir de um link de compartilhamento (dentro da sua própria agência, eles são copiados).

Relacionado #

• Gerenciando Subcontas de Clientes
• Agentes de IA