Shield Growth Studio

01 Introdução

O que o Shield Growth Studio faz e para quem ele foi feito.

O Shield Growth Studio é uma plataforma de gestão de Meta Ads voltada para agências e gestores de tráfego. Ela reúne três frentes que normalmente vivem espalhadas em ferramentas diferentes:

A plataforma é multi-organização: cada agência opera dentro da sua própria organização, com seus próprios membros, contas de anúncio e conexões de CRM — sem visibilidade cruzada entre organizações diferentes.

02 Conceitos-chave

Quatro termos que aparecem em toda a plataforma — vale entender a relação entre eles antes de operar.

03 Primeiros passos

Do acesso ao sistema até a primeira conta de anúncio conectada.

Onde acessar

O dashboard fica em app.shieldfunnels.com. A tela de entrada aceita dois métodos: e-mail e senha, ou magic link (um link de acesso enviado por e-mail, sem senha).

1. Entre com sua conta. Se já tem e-mail e senha (ou recebeu um convite), acesse app.shieldfunnels.com e faça login.
2. Defina sua organização. No primeiro acesso sem nenhuma organização vinculada, você cai automaticamente na tela de onboarding e define o nome — normalmente o nome da agência.
3. Conecte o token de Meta Ads. Em Settings → Token Meta Ads, cole o token de sistema (system user) da sua Business Manager. É esse token que autoriza a plataforma a ler campanhas e enviar criativos.
4. Vincule uma conta de anúncio. Ainda em Settings, em Ad Accounts, adicione a conta de anúncio Meta que você quer gerenciar.
5. Crie um projeto. Em Projetos → Novo Projeto, dê um nome e selecione a conta de anúncio vinculada — isso já habilita os pixels dessa conta no projeto.
6. Explore Insights e Criativos para esse projeto — os dados aparecem assim que a conta de anúncio tiver atividade.

04 Projetos e contas de anúncio

Criar ou editar um projeto

O formulário de projeto tem duas abas:

• Config — nome, status (ativo/pausado/finalizado), orçamento total e diário, CPA alvo, ROAS mínimo, conta de anúncio vinculada e pixel Meta.
• Campanhas — vincula campanhas Meta específicas ao projeto, para métricas filtradas por campanha.

Cor e identificação

Cada projeto recebe uma cor automática, derivada do nome — é só visual, para diferenciar projetos rapidamente na lista e nos gráficos.

05 Insights

Performance agregada da conta de anúncio do projeto atualmente selecionado.

O que a tela mostra

• KPIs principais — investimento, impressões, cliques, CTR, CPC, CPM, alcance, frequência e conversões, com o custo por conversão (CPA) calculado automaticamente.
• Pacing de orçamento — compara o quanto já foi gasto no período contra a projeção do orçamento diário configurado no projeto, com um indicador de "no ritmo", "abaixo do esperado" ou "acima do esperado".
• Gasto por dia — gráfico de série temporal do investimento diário no período selecionado.

Selecionando o período

O seletor de período no topo aceita atalhos comuns (hoje, últimos 7/14/28/30 dias, este mês, mês passado) e um intervalo personalizado.

06 Criativos

Biblioteca de imagens e vídeos de anúncio do projeto atual.

Organização

Criativos podem ser organizados em pastas (barra lateral esquerda da tela) e filtrados por status: pendente, em teste, validado ou reprovado.

Fluxo de um criativo

1. Envie a imagem ou vídeo para uma pasta.
2. Peça uma sugestão de nome por IA, ou renomeie manualmente.
3. Dispare a análise por IA — ela avalia a peça e devolve observações sobre o criativo.
4. Marque o status conforme o resultado em teste (validado/reprovado).
5. Envie o criativo direto para a biblioteca de anúncios do Meta, individualmente ou em lote.

Pré-visualização

Clicar em qualquer peça abre uma pré-visualização ampliada, com acesso rápido para deletar ou renomear sem sair da galeria.

07 Webhooks de entrada

Cada webhook é um endpoint público único que recebe leads de uma origem — formulário, landing page, ou plataforma de checkout.

Criar um webhook

Em Novo Webhook, defina:

• LabelNome de referência (ex.: "Kiwify — Produto X"), opcional.
• TipoFunil ou Produto — usado apenas para organização interna dos logs.
• IntegraçãoGenerico (qualquer origem que envie JSON próprio), Kiwify ou Elementor — cada um sabe interpretar o formato nativo dessa plataforma.

Ao salvar, a plataforma gera uma URL de webhook única (formato /api/webhooks/inbound/<id>) — é essa URL que você cola na configuração de webhook da origem (Kiwify, Elementor, ou o formulário próprio do seu formulário/landing).

Payload esperado (integração Genérico)

{
  "email": "lead@example.com",
  "name": "Nome do Lead (opcional)",
  "phone": "11999999999 (opcional)",
  "utm_source": "facebook (opcional)",
  "utm_medium": "cpc (opcional)",
  "utm_campaign": "nome_campanha (opcional)",
  "utm_content": "nome_ad (opcional)",
  "utm_term": "nome_adset (opcional)"
}

Apenas email é obrigatório — sem ele, o lead não é processado.

Assinatura HMAC (opcional)

Cada webhook tem um secret próprio. Se a origem enviar o header X-Webhook-Signature: sha256=<hash>, a plataforma valida a assinatura antes de processar — recomendado para origens que suportam isso, como camada extra de segurança contra chamadas forjadas ao endpoint público.

Testar antes de ir ao ar

O botão Testar Webhook envia um payload de exemplo real contra o próprio endpoint e mostra a resposta — use antes de configurar a origem de verdade, para confirmar que o lead é processado como esperado.

08 Conexões de CRM

Toda organização pode conectar quantas conexões de CRM precisar — não é preciso usar uma ferramenta específica.

Uma lista só, qualquer CRM

Em Settings → Integrações → Conexões de CRM, todas as conexões aparecem juntas na mesma lista — ChatFunnel não tem tratamento especial nem vem pré-configurado. Cada linha mostra o nome, o tipo (ChatFunnel ou Webhook) e se está ativa.

Adicionar uma conexão

Clicar em Adicionar conexão abre um seletor com as duas modalidades disponíveis:

• ChatFunnelPede a API key da conta. A plataforma valida a chave antes de salvar — permissões necessárias: SEARCH_CONTACT, CREATE_CONTACT, MANAGE_ACCOUNT, MANAGE_KANBAN.
• Outro CRM (webhook)Pede um nome de referência, a URL do webhook de entrada do CRM de destino e, opcionalmente, um header Authorization. Os dados do lead são encaminhados via POST para essa URL.

09 Ações pós-webhook

É aqui que você define o que acontece automaticamente quando um lead novo chega por este webhook.

O botão Adicionar só aparece quando existe pelo menos uma conexão de CRM ativa na organização (ChatFunnel conectado, ou uma conexão genérica cadastrada). Cada webhook pode ter várias ações, executadas em ordem.

Variáveis de template

Nos campos de texto livre (como o comentário do card de CRM), use variáveis entre chaves duplas para inserir dados do lead automaticamente:

{{name}}  {{email}}  {{phone}}
{{utm_source}}  {{utm_medium}}  {{utm_campaign}}  {{utm_content}}  {{utm_term}}
{{sale_value}}  {{payment_method}}  {{offer_number}}

Ativar e desativar sem perder a configuração

Cada ação tem um interruptor independente — desativar uma ação preserva toda a configuração para reativar depois, sem precisar reconfigurar do zero.

10 Configurações da organização

Geral

Nome da organização e slug (o slug não pode ser alterado depois de criado).

Token Meta Ads

O token de sistema (system user) da Business Manager — é ele que autoriza toda leitura de campanhas e todo envio de criativos para o Meta.

Ad Accounts

Lista das contas de anúncio vinculadas à organização — cada uma pode ser usada por um ou mais projetos.

11 Membros e permissões

Convidar alguém

Em Convidar membro, informe o e-mail e o papel (owner, admin, member ou viewer).

• Se o e-mail ainda não tem conta, a pessoa recebe um e-mail com um link de acesso.
• Se o e-mail já tem conta (em outra organização, por exemplo), ela é adicionada diretamente — nenhum e-mail é enviado, porque a conta já existe.

Papéis

12 Logs e diagnóstico

Todo webhook recebido e toda ação executada geram um registro — mesmo quando algo dá errado.

A aba de Logs mostra, por evento: status (sucesso/erro), duração, e-mail do lead, se era um lead novo ou já existente, e o payload completo recebido. Use-a como primeira parada ao investigar por que um lead não apareceu no CRM esperado.

13 O que vem a seguir

Recursos em desenvolvimento — sujeitos a mudança, sem data comprometida.

Alguns recursos futuros vão nascer com o selo Beta e poderão ser ativados individualmente por organização, em uma seção própria de Settings — nenhum recurso novo é ligado automaticamente para todo mundo.

• CRM mínimo integrado — pipeline de vendas configurável, histórico de eventos do lead e registro de vendas, com atribuição de receita direta às campanhas.
• Google Ads como segundo canal de aquisição, ao lado do Meta.
• Conversões offline — enviar de volta para Meta/Google o valor de vendas fechadas, fechando o ciclo de otimização de campanha.

14 Glossário

• CPACusto por aquisição — investimento dividido pelo número de conversões.
• ROASRetorno sobre investimento em anúncios — receita gerada dividida pelo investimento.
• PacingRitmo de consumo do orçamento ao longo do período, comparado à projeção esperada.
• UTMParâmetro de rastreamento na URL que identifica a origem, mídia e campanha de um clique.
• HMACAssinatura criptográfica usada para confirmar que um payload de webhook realmente veio da origem esperada.
• PixelCódigo de rastreamento do Meta instalado no site do cliente final, usado para medir conversões dos anúncios.