Tudo para a conta avisar antes do cliente.
O passo a passo de cada tarefa, com vídeo curto nas aulas de implantação. Travou em algo? A resposta está em “Deu problema?”, dentro da aula.
Implantação, em ordem
uns 9 minutos no total22 aulas, cada uma de até 3 minutos.
Criar a conta da agência
Quem cria a conta vira o dono da agência no painel.
- Abra a página de cadastro e preencha seu nome, o nome da agência, seu e-mail e uma senha com pelo menos 10 caracteres.
- Clique em Criar conta. Você entra direto no painel, sem e-mail de confirmação.
- O resto do time não cria conta por aqui: você convida cada pessoa depois, em Time.
Deu problema?
Meu colega criou outra conta e caiu numa agência vazia
Cada cadastro cria uma agência nova. Peça para ele entrar pelo link de convite que você gera em Time: assim ele entra na sua agência.
Esqueci a senha
Na tela de entrar, toque em “Esqueci a senha” e informe seu e-mail. O link chega em até 2 minutos e vale por 2 horas. Se não chegar (olhe o spam), fale com o suporte: ele gera o link e te manda pelo WhatsApp.
Conectar a Meta
Liga as contas de anúncio da agência com um token do usuário do sistema, que não expira.
- No Gerenciador de Negócios da Meta, abra Configurações do negócio → Usuários → Usuários do sistema.
- Crie um usuário do sistema com papel Administrador, ou use um que já existe.
- Em Atribuir ativos, dê a ele as contas de anúncio que a agência opera, com controle total.
- Clique em Gerar novo token, escolha o app e marque ads_read, ads_management e business_management. Para subir anúncios pelo AdSync, marque também pages_show_list, pages_read_engagement, pages_manage_ads e instagram_basic (a aula “Token e permissões da Meta” explica cada uma).
- Dê também ao usuário do sistema acesso às páginas e aos pixels dos clientes, em Atribuir ativos.
- No AdSync, abra Conexões, cole o token inteiro e clique em Conectar com token. As contas aparecem na hora.
Deu problema?
Apareceu “A Meta diz que esse token é inválido ou expirou”
O token foi copiado pela metade ou já expirou. Gere um novo e copie tudo, do começo ao fim. Token de usuário comum dura de 1 hora a 60 dias; o de usuário do sistema não expira.
Conectou, mas não apareceu nenhuma conta (ou faltou alguma)
O usuário do sistema só enxerga as contas atribuídas a ele. Volte em Atribuir ativos, adicione as contas e conecte o token de novo: as novas entram sem duplicar.
Apareceu “Reconecte a Meta para subir anúncios (falta: …)”
O token foi gerado sem as permissões de página. Gere um token novo marcando todas as permissões da lista e cole em Conexões. Detalhes na aula “Token e permissões da Meta”.
A conexão aparece como Expirada
O token perdeu a validade ou o acesso foi retirado na Meta. Gere um novo token e cole em Conexões. Enquanto isso, as contas dessa conexão não respondem e a Sentinela avisa.
Conectar o Google Ads
Opcional. Liga as contas do Google Ads para consulta, Sentinela e subida de campanha.
- Em Conexões, clique em Conectar o Google Ads.
- Entre com o usuário do Google que acessa as contas ou a MCC da agência e autorize.
- As contas aparecem em Contas, junto com as da Meta. Ative as que entram no plano. Elas servem para perguntar, entram na Sentinela e recebem campanha nova pela conversa (aulas “Subir campanha no Google” e “Permissões do Google”).
Deu problema?
O botão do Google Ads não aparece
Ele aparece quando o app do Google está configurado no servidor. Se não estiver, fale com o suporte.
Subir campanha no Google dá erro de permissão
Quem conectou precisa ter no Google Ads acesso de edição à conta (padrão ou administrador; só leitura não serve). Dê o acesso, reconecte o Google em Conexões e tente de novo. Mais na aula “Permissões do Google”.
Não vejo as contas que ficam dentro da MCC
Entre com um usuário que tenha acesso à MCC, não só a uma conta. As contas filhas entram automaticamente.
Escolher as contas e o teto de custo
Quais contas o AdSync vê e vigia, e a partir de quanto o custo por resultado vira alerta.
- Abra Contas e clique em Ativar nas contas que entram no plano. O limite do seu plano aparece no topo da página.
- Em cada conta, preencha o teto de custo na moeda da conta (o símbolo aparece no campo) e clique em Salvar. Na Meta vale para o custo por resultado; no Google, para o custo por conversão. Exemplo: numa conta em reais, se um lead acima de R$ 30 é problema, coloque 30.
- O teto vale só para conversões (lead, compra, conversa, cadastro, agendamento). Campanha de vídeo, engajamento, tráfego ou alcance não é medida por ele: para essas, defina a meta do tipo em Contas → Ver resultado por tipo (aula “Resultado por tipo e metas de custo”).
- Sem teto e sem meta, a Sentinela continua vigiando status, pagamento, limite de gastos e anúncio reprovado. Só os alertas de custo ficam desligados.
Deu problema?
O botão Ativar está apagado
A agência chegou ao limite de contas do plano. Desligue uma conta que não precisa mais ou mude de plano.
O alerta de “gastou sem resultado” nunca dispara
Ele depende do teto (para conversões) ou da meta do tipo (para vídeo, engajamento, tráfego e alcance). A Sentinela avisa quando as campanhas de um tipo gastaram no dia o valor do limite sem nenhum resultado desse tipo. Defina o teto na conta ou a meta do tipo na página da conta.
Sentinela: o alarme antes do relatório
Confere as contas e avisa o que precisa de você antes de o cliente perceber.
- A Sentinela confere cada conta ativa: a da Meta a cada 30 minutos e a do Google Ads a cada 2 horas. Dono e administradores têm o botão Conferir agora, na Visão geral, que roda na hora.
- Ela avisa quando: a conta parou de entregar (pagamento recusado ou pendente, conta desativada, suspensa ou em análise); um anúncio ligado foi reprovado; o custo do dia de um tipo de resultado passou do teto (conversões) ou da meta do tipo (vídeo, lead de formulário, alcance...); as campanhas de um tipo gastaram o limite sem nenhum resultado desse tipo. Campanha de vídeo ou de alcance sem lead nunca vira “gastou sem conversão”. Só na Meta: o limite de gastos acabou ou dura menos de 2 dias. Só no Google: há campanha ligada e a conta ainda não gastou nada depois do meio-dia. Verba do mês e saldo têm aula própria.
- O primeiro aviso vai na hora para o WhatsApp de quem cuida da conta. Se o problema continuar, ela lembra a cada 24 horas. Resolveu? O alerta some na conferência seguinte.
Deu problema?
Não recebi o alerta no WhatsApp
Confira três coisas: o WhatsApp está ligado (aula “Ligar o WhatsApp”), o seu celular está liberado e você é dono, administrador ou tem a conta atribuída. O alerta aparece no painel mesmo assim.
Ainda aparece um problema que já resolvi
Ele some na próxima conferência, em até 30 minutos na Meta e até 2 horas no Google. Para tirar na hora, o dono ou um administrador clica em Conferir agora na Visão geral.
Ligar o WhatsApp
O time pergunta e opera as contas pelo WhatsApp, e recebe os alertas da Sentinela por lá.
- Abra WhatsApp no painel. Se aparecer o Número oficial ativo, o número já está pronto. Se não, conecte um número só da agência lendo o QR Code com o celular.
- Em Chave de IA da agência, escolha a IA que a agência já paga (Claude, ChatGPT ou Gemini), escolha o modelo, cole a chave e clique em Testar e salvar.
- Em Quem pode conversar, coloque o celular de cada pessoa e clique em Liberar. Número fora da lista é ignorado.
- No número oficial, cada pessoa ativa o próprio celular: manda, do WhatsApp dela, a mensagem ATIVAR com o código que aparece ao lado do número. Isso prova que o celular é mesmo dela.
Deu problema?
Mandei mensagem e ninguém respondeu
O celular precisa estar liberado (e, no número oficial, ativado com o código ATIVAR), a chave de IA cadastrada e a agência dentro do limite de consultas do mês do plano. Se faltar a chave, o próprio WhatsApp avisa.
A chave de IA foi recusada
Copie a chave inteira e confira se ela tem crédito e acesso ao modelo escolhido. Ao trocar de IA, cole a chave nova: a anterior é de outro provedor.
O número próprio da agência desconectou
Ele cai quando o mesmo número é aberto no WhatsApp Web ou em outro aparelho. Conecte de novo pelo QR Code e use um número só para isso.
Colocar no seu assistente de IA
Funciona com Claude, ChatGPT, Gemini, Copilot, Cursor e qualquer assistente que aceite conector.
- No painel, abra Assistente de IA e copie o endereço do conector. É o mesmo para qualquer assistente.
- Claude: Configurações → Conectores → Adicionar → Adicionar conector personalizado. Nome AdSync, cole o endereço, Continuar → Adicionar → Vincular.
- ChatGPT: menu Plugins → Adicionar → Adicionar servidor MCP personalizado. Nome AdSync, cole o endereço, deixe OAuth. No campo Ícone, envie o ícone do AdSync (baixe em Assistente de IA → Baixar o ícone): no ChatGPT, quem cria o conector é quem envia o ícone. Marque “Entendo e quero continuar” → Criar como plugin → Conectar AdSync.
- Cursor e VS Code: use o botão de instalação em um clique na mesma página. Gemini CLI, Claude Code e Codex: copie o comando pronto.
- O assistente abre a página do AdSync: entre com seu e-mail da agência e clique em Permitir acesso. A página Assistente de IA passa a mostrar Conectado.
Gravações reais, uma por assistente
ChatGPT: Plugins → Adicionar → Adicionar servidor MCP personalizado, com o nome e o endereço do AdSync.
Claude: Conectores → Adicionar conector personalizado → Vincular → Permitir acesso. As ferramentas do AdSync aparecem na hora.
Codex: o comando pronto abre a página do AdSync e o acesso fica conectado.
Deu problema?
Não acho a opção de conector no assistente
Conector personalizado só existe em plano pago do assistente (no ChatGPT, Plus, Pro, Business ou Enterprise). Se o botão Adicionar não aparecer, o plano não permite: use o WhatsApp.
Conectei, mas o assistente não usa o AdSync
Chame o AdSync na conversa. No ChatGPT, digite @AdSync antes da pergunta. No Claude, comece com “Use o AdSync:”; na primeira vez ele pede para permitir a ferramenta, toque em Permitir.
O conector aparece sem o ícone do AdSync
No ChatGPT, edite o conector e envie o ícone (Assistente de IA → Baixar o ícone). O Claude, o Cursor e o Gemini CLI ainda não mostram ícone de conector personalizado: lá aparece um ícone genérico, e funciona igual.
O assistente pediu para entrar de novo
O acesso renova sozinho enquanto você usa. Se ficar muito tempo parado ou alguém tirar o seu acesso na agência, ele pede login de novo: entre e permita.
Perguntar e mudar campanha com segurança
Nada muda sem você confirmar. Toda mudança fica registrada com o nome de quem fez.
- Pergunte como falaria com um colega: “qual cliente gastou ontem sem gerar resultado?”, “ranking de criativos da Clínica X nos últimos 7 dias”, “como está o custo por resultado da Loja Y hoje?”. O resultado sempre segue o tipo da campanha (vídeo em visualizações, lead de formulário em formulários, alcance em custo por mil) e vem separado por tipo, com o gasto sem resultado à parte. Anúncio reprovado a Sentinela já avisa sozinha.
- Para pausar, ativar ou mudar orçamento, peça direto: “pausa o conjunto Público amplo da Loja Y”. O AdSync mostra a prévia (conta, item, antes e depois) e espera a confirmação.
- No assistente de IA, confirme quando ele perguntar. No WhatsApp, responda SIM em até 10 minutos, ou NÃO para cancelar. O SIM vale para a prévia da última resposta: se você fizer outra pergunta ou pedido antes, a prévia é cancelada e é só pedir de novo.
- O orçamento muda no máximo 50% por alteração, para um erro de digitação não virar prejuízo. Pausar, ativar e mudar orçamento de campanha que já existe vale para a Meta; no Google, o AdSync consulta e sobe campanha nova (aula “Subir campanha no Google”).
- Em Histórico, o painel mostra cada mudança: quem, quando, em qual conta e por qual canal.
Deu problema?
Confirmei e a mudança não foi feita
A prévia vale 10 minutos. Depois disso, peça a alteração de novo para gerar uma prévia nova.
Não deixa dobrar o orçamento
Cada alteração muda no máximo 50% do valor atual. Para chegar lá, faça em etapas.
O gestor diz que não consegue pausar
Quem tem o papel Leitura só consulta. Mude o papel para Gestor em Time.
Chamar o time e dividir as contas
Cada gestor vê e opera só as contas dele.
- Em Time, coloque o e-mail da pessoa, escolha o papel e clique em Criar convite.
- Mande o link para a pessoa (vale 48 horas). Ela cria a senha e entra direto na sua agência.
- Papéis: Administrador vê e gerencia tudo; Gestor consulta e opera só as contas atribuídas; Leitura só consulta as contas atribuídas.
- Atribua as contas de cada gestor na mesma página. Sem conta atribuída, o gestor não vê nada.
Deu problema?
O convite expirou
Crie outro convite para o mesmo e-mail em Time. O vencido some sozinho, e o link novo vale mais 48 horas.
O gestor entrou, mas não vê nenhuma conta
Ele só vê as contas atribuídas a ele. Em Time, atribua as contas.
Esqueci a senha
Como criar uma senha nova e voltar para o painel.
- Na tela de entrar, toque em Esqueci a senha e informe o e-mail da sua conta. O link chega por e-mail e vale por 2 horas.
- Se o e-mail não chegar (olhe o spam), fale com o suporte: ele gera o link e te manda pelo WhatsApp.
- Abra o link, escreva a nova senha duas vezes (mínimo de 10 caracteres) e clique em Salvar a nova senha.
- Clique em Entrar com a nova senha. Por segurança, os outros aparelhos saem da conta e o assistente de IA pede para entrar de novo.
Deu problema?
O link diz que expirou ou já foi usado
Cada link funciona uma vez só e vence em 2 horas. Peça um link novo.
O assistente de IA parou de responder depois da troca
É esperado: trocar a senha desliga os acessos antigos. No assistente, conecte o AdSync de novo e clique em Permitir acesso.
Clientes e dossiê
Cada cliente tem os padrões de subida e um dossiê com o que a agência sabe dele. O assistente lê os dois antes de montar qualquer campanha.
- Abra Clientes. Cada conta que você ativa em Contas já ganha um cliente com o nome da conta. Se o mesmo cliente tem conta na Meta e no Google, abra um deles, use Ligar conta e, no outro, Juntar com outro cliente.
- Em Dados e padrões de subida, preencha o que se repete em toda campanha: página e Instagram, pixel e evento, WhatsApp de destino, site e UTM, formulário e orçamento diário padrão. Dono e administrador também definem o responsável, o teto por subida e a verba do mês. Quem opera só vê os clientes das contas que acessa.
- Pelo painel: em Dossiê, abra o cliente e preencha as seções (negócio, oferta e preço, público, região, tom, metas, restrições e aprendizados). A linha do tempo mostra notas, mensagens, áudios transcritos, recomendações, subidas e alterações. O Relatório da semana lista o que foi recomendado e feito, com filtro por nicho.
- Pelo Claude (ou outro assistente conectado): peça “anota no dossiê da Clínica X que o público é mulher de 30 a 50 anos” ou “o que a gente sabe da Clínica X?”. Para guardar uma decisão, peça “registra a recomendação de testar vídeo”.
- Pelo WhatsApp: encaminhe a mensagem do cliente para o AdSync e diga de quem é. Ela entra na linha do tempo do cliente com o texto exato que chegou. Se houver mais de um cliente possível, ele pergunta qual. Áudio encaminhado vira nota transcrita (precisa da chave de transcrição).
- O conteúdo do dossiê é informação, não ordem: o assistente não executa pedido que esteja dentro de uma nota ou de uma mensagem encaminhada, e, pelo assistente e pelo WhatsApp, nada sobe sem a prévia e o SIM.
Deu problema?
O assistente não achou o cliente
Ele só enxerga clientes ligados a uma conta que você acessa. Cliente sem conta ligada aparece só para dono e administrador. Em Clientes, ligue a conta ao cliente.
Não consigo mudar o teto por subida nem a verba do mês
Esses dois campos são de dono e administrador. O gestor preenche os padrões e o dossiê, mas não esses limites.
Encaminhei a mensagem e ela não apareceu no dossiê
O número precisa estar liberado em WhatsApp (e ativado, no número oficial). Se o cliente não ficou claro, o assistente pergunta de qual cliente é: responda com o nome. Quem tem papel de Leitura não grava no dossiê.
O áudio chegou sem transcrição
Falta a chave de transcrição. Cadastre em WhatsApp → Chave de transcrição (OpenAI ou Google). Áudio recebido antes disso fica registrado, mas sem o texto.
Mandar criativos: Drive, arquivo ou WhatsApp
Imagem e vídeo chegam ao cliente por um destes caminhos. O vídeo é transcrito para o assistente escrever a legenda pelo que a pessoa fala.
- Link do Drive: compartilhe o arquivo ou a pasta como “qualquer pessoa com o link” e cole o link na conversa com o assistente, dizendo o cliente. Na pasta, arquivo solto vira um anúncio, subpasta com 2 a 10 imagens vira carrossel (na ordem do nome) e subpasta chamada stories vira sequência de stories.
- Arquivo do computador: no Claude Code, Cursor, VS Code ou terminal, peça “manda estes arquivos para o cliente X”. O assistente envia cada arquivo e confere. Isso não funciona no ChatGPT nem no Claude na web, que não acessam arquivos do seu computador: ali use o Drive.
- WhatsApp: mande a imagem, o vídeo ou o documento para o número do AdSync e escreva “cliente Nome” na legenda (ou responda “cliente Nome” depois). Sem o cliente, o arquivo fica numa caixa de entrada por 2 dias. Para manter a qualidade, mande o vídeo como documento, porque o WhatsApp comprime vídeo enviado como vídeo.
- Também vale um link direto https de um arquivo público.
- Acompanhe em Clientes → Criativos: miniatura, origem, proporção, duração e situação de cada peça. Aceita JPEG e PNG (até 30 MB) e MP4 e MOV (até 1 GB; 100 MB por arquivo no número oficial do WhatsApp). O arquivo fica guardado por 30 dias.
- Transcrição: com a chave de transcrição cadastrada (WhatsApp → Chave de transcrição), o AdSync transcreve a fala do vídeo. O assistente usa o texto para escrever a legenda. Vídeo sem fala aparece como “sem fala”.
Deu problema?
O link do Drive deu erro
Se o aviso diz que o link está limitado à sua empresa, mude o compartilhamento para “qualquer pessoa com o link”. Link de pasta só funciona quando o servidor tem a chave do Google Drive; sem ela, mande o link de cada arquivo. Docs e Slides do Google são ignorados.
O arquivo foi recusado
O AdSync confere o conteúdo, não só a extensão: só entram JPEG, PNG, MP4 e MOV. GIF e WebP não servem. Exporte de novo em um desses formatos.
O vídeo do WhatsApp não chegou
No número oficial o limite é de 100 MB por arquivo, também como documento. Acima disso, mande pelo Drive. Dentro do limite, mandar como documento preserva a qualidade.
A transcrição não aparece
Sem chave de transcrição, o vídeo chega sem texto. Cadastre a chave em WhatsApp. Se o vídeo não tem fala, o AdSync avisa “vídeo sem fala”.
O criativo sumiu da lista
Criativos vencem 30 dias depois do recebimento, e a caixa de entrada do WhatsApp sem cliente é apagada em 2 dias. Mande de novo.
Subir campanha na Meta pela conversa
Você pede, o assistente monta e mostra a prévia. Só depois do seu SIM a campanha é criada, e por padrão pausada.
- Antes, deixe o cliente pronto: padrões preenchidos (página, Instagram, pixel e evento, destino, orçamento diário), criativos enviados e a Meta conectada com as permissões de página (aula “Token e permissões da Meta”).
- Peça como falaria com um colega: “sobe esses 3 vídeos para a Clínica X com o padrão” ou “sobe esse criativo no conjunto Público amplo”. Dá para criar campanha nova ou entrar numa campanha ou conjunto que já existe. Imagem, vídeo e carrossel; peça 9:16 para Stories e Reels.
- O assistente lê o cliente e o dossiê, escolhe o objetivo e o evento, define o público (aberto ou restrito) e confere tudo antes: permissões, página, Instagram, pixel, verba mínima, limite de texto e proporção das peças. O que bloqueia vem com o motivo; o que é só sugestão aparece como aviso.
- A prévia mostra campanha, conjunto, anúncios, público, orçamento, destino e as peças. No WhatsApp ela vem em texto, com um link do painel para ver as miniaturas. A prévia também mostra o orçamento diário somado da conta e a projeção contra a verba do mês. O teto por subida do cliente bloqueia.
- Responda SIM em até 10 minutos (no assistente de IA, confirme quando ele perguntar). A subida entra na fila e você recebe o número dela na hora. Acompanhe pedindo o status da subida, ou em Clientes → Subidas. Quem confirmou recebe um aviso no WhatsApp ao terminar.
- Por padrão, tudo nasce pausado. Revise no Gerenciador de Anúncios e ligue quando estiver pronto. A exceção é a agência ligar “Publicar ativo direto” em Subidas: aí a subida já começa a gastar ao terminar.
- Se algo falhar no meio, a subida retoma de onde parou e procura o que já foi criado antes de repetir. Se a Meta ou o Google não responderem, pode sobrar um item repetido: o aviso da subida pede para conferir duplicados. “Descartar subida” apaga só o que aquela subida criou, nunca a campanha onde ela entrou.
Deu problema?
A prévia diz “Reconecte a Meta” ou aponta permissão faltando
A conexão foi feita sem as permissões de página. Gere um novo token com todas elas (aula “Token e permissões da Meta”) ou reconecte pelo login, e peça a subida de novo.
Confirmei e nada foi criado
A prévia vale 10 minutos, e uma nova pergunta ou pedido na mesma conversa a cancela. Peça de novo para gerar outra prévia. Depois do SIM, a subida pode levar alguns minutos, mais ainda com vídeo: pergunte o status.
O pré-voo bloqueou a subida
Corrija o que ele pede. Bloqueiam: pixel que não recebeu nenhum evento em 7 dias ou que não está na conta, orçamento abaixo da verba mínima, passou do teto por subida, texto acima do limite e proporção errada. Destino que não respondeu e evento que ainda não chegou ao pixel aparecem como aviso, não como bloqueio: confira antes de ligar. Bloqueio não se contorna.
A campanha não está gastando
Ela nasce pausada de propósito, a menos que a agência tenha ligado “Publicar ativo direto” em Subidas. Ative no Gerenciador, ou peça para ativar pela conversa (com prévia e SIM).
Subir campanha no Google
Pesquisa, Performance Max, Display e Demand Gen pelo mesmo caminho da Meta: prévia, SIM e campanha pausada.
- Antes, confira três coisas: o Google Ads conectado, a conta ativa em Contas e, no cliente, o site, a moeda e o nome do negócio. Performance Max, Display e Demand Gen também pedem a logo do cliente (Clientes → Logo do cliente).
- Peça o tipo que combina com o objetivo. Pesquisa: quem já procura o que o cliente vende (palavras-chave, negativas, títulos e descrições). Performance Max: o Google distribui por todos os canais. Display: anúncio responsivo na rede de display. Demand Gen: YouTube, Discover e Gmail, com imagem ou vídeo.
- Para lance por conversão, a conta precisa ter uma conversão ativa e primária. O assistente confere. Sem ela, configure a conversão no Google Ads; só Pesquisa, Display e Demand Gen aceitam começar por cliques, e o Performance Max exige maximizar conversões.
- O pré-voo confere textos, proporções por tipo (o Performance Max, por exemplo, exige imagens 1,91:1 e 1:1, logo 1:1 e nome do negócio), orçamento, teto por subida do cliente e a cota do dia. A prévia mostra o que vai ser criado e o que falta.
- Responda SIM em até 10 minutos. A estrutura da campanha é criada de uma vez e, por padrão, nasce pausada (a exceção é o “Publicar ativo direto” da agência). Revise no Google Ads e ligue quando estiver pronta. Acompanhe pelo status da subida.
- Vídeo enviado ao AdSync sobe para o YouTube pelo Google Ads (não listado) para servir de anúncio, até 256 MB. Acima disso, informe o link do YouTube. Vídeo que já está no YouTube entra por link.
- Se o Google demorar e não responder, o AdSync procura a campanha pelo nome antes de tentar de novo, para não criar duas. Se a cota diária do projeto acabar, a subida espera e retoma sozinha.
Deu problema?
A prévia diz que falta imagem, logo ou nome do negócio
Cada tipo exige um mínimo de peças. Mande o que falta (a prévia diz a proporção) ou escolha outro tipo. Não há recorte automático: a imagem entra na proporção que tem.
O lance por conversão foi bloqueado
A conta não tem conversão ativa e primária. Configure no Google Ads. Só Pesquisa, Display e Demand Gen aceitam pedir a campanha por cliques; o Performance Max exige maximizar conversões.
Dá erro de permissão do Google
Quem conectou o Google precisa ter acesso de edição à conta no Google Ads. Veja a aula “Permissões do Google”.
A subida ficou esperando
A cota de operações do Google é do projeto inteiro, e a subida respeita um limite diário. A cota vale numa janela móvel de 24 horas: assim que operações antigas saem da janela, ela retoma sozinha. A tela Status mostra o consumo e a que horas volta a ter folga.
Já existe campanha com esse nome
O Google não aceita nome repetido. Escolha outro nome e peça de novo.
As mesmas peças na Meta e no Google
Uma ação monta as duas subidas, com uma prévia só. Cada plataforma segue o próprio andamento.
- Peça algo como “sobe esses criativos da Clínica X na Meta e no Google”. O assistente usa a ação das duas plataformas: monta cada parte com o pré-voo dela e devolve uma prévia só.
- A prévia mostra, por peça, onde ela serve na Meta e em cada tipo de campanha do Google, e o que falta no tipo escolhido (no Performance Max, por exemplo, imagem 1,91:1 e 1:1, logo e nome do negócio). Não há recorte automático.
- Um SIM enfileira as duas subidas. Cada uma ganha seu número e, por padrão, nasce pausada.
- Se um lado falhar, o outro não é desfeito. O aviso diz o motivo e a situação da outra parte. Em Subidas, abra o par: dá para tentar de novo só na Meta ou só no Google, descartar uma plataforma ou o par inteiro. Pelo assistente, peça “tenta de novo só no Google”.
Deu problema?
Uma plataforma subiu e a outra falhou
É esperado: elas são independentes. Corrija o motivo (o aviso diz qual) e peça para tentar de novo só no lado que falhou.
A peça serve na Meta mas não no Google
A proporção decide. A prévia lista onde cada peça entra. Mande uma versão na proporção que falta ou escolha outro tipo de campanha.
Quero desfazer só uma das duas
Em Subidas, abra o par e use Descartar só uma plataforma. Só é apagado o que aquela subida criou.
Resultado por tipo e metas de custo
Cada campanha é medida pelo que ela promete: view de vídeo, lead de formulário, conversa, compra ou alcance. A conta fecha por tipo, e você define a meta de custo de cada um.
- O AdSync lê como a Meta otimiza cada conjunto de anúncios (visualização de vídeo, formulário, conversa no WhatsApp, compra no site, alcance...) e mede a campanha por isso. No Google Ads, o tipo vem do canal e do lance da campanha (conversão, visualização de vídeo, impressões ou clique).
- Em Contas, clique em Ver resultado por tipo na conta e escolha o período. Você vê o gasto total e, por tipo, o gasto, a quantidade, o custo médio e a meta. A conta fecha: o gasto total é a soma dos tipos mais o gasto sem resultado. Campanha que gastou e não teve resultado do seu tipo aparece à parte, fora da média.
- Nunca se soma tipo diferente: 40.000 visualizações de vídeo e 52 leads ficam em linhas separadas, cada um com o seu custo. Alcance e impressões saem em custo por mil. O mesmo texto vem no assistente de IA e no WhatsApp: “Conta X: R$ 1.200 gastos. Vídeo: 40.000 a R$ 0,03; Lead (formulário): 52 a R$ 11,50; Compra: 8 a R$ 62”.
- Meta de custo por tipo: na mesma página, preencha o custo que você aceita pagar em cada tipo (por exemplo, R$ 0,05 por visualização de vídeo, R$ 15 por lead de formulário, R$ 80 por compra) e clique em Salvar metas. Pelo assistente de IA ou pelo WhatsApp, peça “define a meta de lead de formulário da Clínica X em 15”: o AdSync mostra a prévia e só grava com o seu SIM.
- A Sentinela passa a avisar quando o custo de hoje de um tipo passa da meta dele, e quando as campanhas de um tipo gastaram o valor da meta sem nenhum resultado. Tipo sem meta não gera alerta novo, e campanha de vídeo ou de alcance nunca é tratada como “gastou sem conversão”.
Deu problema?
Aparece “Outro (tipo não reconhecido)”
A Meta usa uma meta de otimização que o AdSync ainda não classifica, ou o conjunto é de conversão do site sem evento definido. O gasto aparece, sem resultado e sem alerta, para não inventar um número. Confira a campanha no Gerenciador de Anúncios.
A campanha aparece como “misto”
Ela tem conjuntos com metas diferentes (por exemplo, um de vídeo e um de lead). Peça o desempenho por conjunto: o total da conta por tipo continua certo.
Não consigo salvar a meta
Meta é de dono e administrador. Use ponto ou vírgula (0,05 ou 15,50) e um valor maior que zero; deixe em branco para tirar a meta. Pelo WhatsApp, responda SIM em até 10 minutos.
O custo de alcance parece alto
Alcance e impressões usam custo por mil (CPM), não por pessoa. A meta desses tipos também é por mil.
Sentinela completo: grupo, verba, saldo e resumo
Alerta no grupo do cliente, aviso antes de a verba do mês estourar, saldo pré-pago e um resumo diário no WhatsApp.
- Grupo do WhatsApp: em Clientes, abra o cliente e escolha o grupo na seção de alertas. É um grupo interno do time, porque o alerta cita pagamento e dados da conta. Só funciona com número próprio da agência (não com o número oficial). O responsável continua recebendo no privado. Mensagem escrita no grupo é ignorada, e o SIM no grupo não confirma nada.
- Verba do mês: em Clientes → Verba do mês, informe o total do cliente ou um valor por plataforma. A conta é o gasto do mês mais a média diária dos últimos 7 dias vezes os dias que faltam. A Meta e o Google entram na soma.
- Os avisos saem em 110% (“vai estourar no dia X”), em 80% (“vai sobrar tanto”) e quando a verba acaba. Cada faixa avisa uma vez por mês. Antes do dia 7 a projeção é pouco confiável, então o “vai sobrar” espera.
- Saldo pré-pago (Meta): a Sentinela avisa com 5 dias, com 2 dias e quando o saldo zera, uma vez por recarga. O valor é lido do texto que a Meta mostra, e se não der para ler com certeza o aviso fica desligado naquela conta. Ela aparece em Status.
- Resumo diário: em WhatsApp → Resumo diário, ligue, escolha a hora (Brasília) e se conta “ontem” ou “hoje até agora”. Chega uma mensagem por dia com gasto, resultado por tipo (visualizações de vídeo, leads, compras...) e alertas abertos de cada cliente. O gasto e o resultado vêm só das contas da Meta. Os alertas abertos das contas aparecem, inclusive os do Google; o aviso de verba do mês que depende do Google chega pelo alerta normal e pode não entrar no resumo. Cada pessoa recebe só os clientes que vê.
- Google: a Sentinela vigia conta suspensa ou com pagamento pendente, campanha ligada sem gasto, custo por conversão acima do teto e anúncio reprovado, a cada 2 horas por conta.
Deu problema?
O grupo não aparece na lista
Ele só lista os grupos do número próprio da agência, e o número precisa estar conectado. Comunidade não recebe mensagem e fica de fora. Grupo em que só administrador escreve aparece com aviso.
A verba do mês aparece como incompleta
Só vale quando todas as contas daquele escopo foram lidas. O motivo aparece na tela do cliente: conta sem leitura, moeda diferente da do cliente ou cliente sem conta da plataforma.
O aviso de saldo não chega
Confira em Status. Se a conta pré-paga aparece como saldo não lido, o texto da Meta não pôde ser interpretado com segurança: confira o saldo no Gerenciador de Anúncios e fale com o suporte.
O resumo diário não chegou no número oficial
Fora da janela de 24 horas, o número oficial só envia o modelo de mensagem aprovado (resumo_diario). Se o modelo não foi criado e aprovado na Meta, o resumo não sai por esse número.
Trocar a senha pelo WhatsApp
Ligue o seu WhatsApp uma vez e, se esquecer a senha, o link de nova senha chega nele.
- Abra Minha conta. Em WhatsApp de recuperação de senha, o painel mostra um código.
- Clique em Abrir no WhatsApp e envie a mensagem com o código, do seu próprio celular, para o número de suporte. É assim que o AdSync comprova que o número é seu: ele nunca manda mensagem para um número que alguém digitou.
- A página passa a mostrar o número ligado. Para trocar de número, repita o processo no celular novo. Para tirar, use Tirar o número.
- Se esquecer a senha, toque em Esqueci a senha e informe o e-mail. O link chega nesse WhatsApp (e no e-mail, quando a agência tem envio de e-mail) e vale por 2 horas, uma vez só. A resposta na tela é a mesma com ou sem conta cadastrada.
- Depois da troca, os outros aparelhos e os conectores do assistente de IA saem da conta, e você recebe um aviso. Conecte o assistente de novo e clique em Permitir acesso.
Deu problema?
Não aparece a opção de ligar o WhatsApp
A recuperação pelo WhatsApp ainda não está ligada neste servidor. Use o e-mail ou fale com o suporte, que gera o link.
O código não foi aceito
O código vence e vale para um número só. Gere outro na mesma tela e envie de novo, do celular que você quer ligar. Há um limite de tentativas por hora.
Pedi o link e não chegou no WhatsApp
Só recebe quem comprovou o número antes de esquecer a senha. Quem não ligou usa o e-mail ou o suporte. Existe um limite de pedidos por dia: espere e tente de novo.
Tela de status das integrações
Uma tela mostra o que está funcionando, quando foi conferido e o que fazer quando algo falha.
- Abra Status. Cada linha é uma integração: Meta, Google Ads, chave de IA do agente, chave de transcrição, WhatsApp, saldo pré-pago, verba do mês dos clientes, Sentinela no Google, resumo diário e cota do Google Ads.
- O selo mostra a situação: Ok, Atenção, Com problema ou Não ligado (o que é opcional aparece assim, sem alarme).
- A coluna O que fazer leva direto à tela que resolve, como reconectar a Meta ou ler o QR Code de novo. Esses botões são do dono e dos administradores; os outros veem quem precisa agir.
- Dono e administrador podem clicar em Conferir agora. Ele testa a Meta, o Google, as chaves de IA e o número próprio de WhatsApp da agência. O número oficial aparece como ativo pela configuração do servidor; para conferir de verdade, mande uma mensagem para ele. Vale até 3 vezes a cada 10 minutos.
Deu problema?
Conferir agora diz que já usei o limite
São 3 conferências a cada 10 minutos por agência. Espere um pouco e tente de novo.
Aparece Atenção no saldo pré-pago ou na verba do mês
A linha diz qual conta ou cliente está sem leitura. Abra o cliente para ver o motivo (conta sem leitura, moeda diferente, sem conta da plataforma).
A cota do Google aparece alta
A cota é do projeto do Google Cloud inteiro, somando todas as agências. Quando chega perto do limite diário, a subida espera e a Sentinela pula uma rodada. Veja a aula “Permissões do Google”.
Aprovação do cliente pelo webhook
Quando o sistema da agência avisa que um criativo foi aprovado, o AdSync prepara a subida e espera o seu SIM, em até 48 horas.
- Em Webhook, clique em Gerar segredo. Guarde o segredo e o identificador: o segredo aparece uma vez, e gerar outro invalida o anterior na hora. Quem integra o sistema da agência recebe os dois.
- No mesmo lugar, informe os hosts de onde vêm os links dos criativos (o Google Drive já vale), relacione o id do cliente no seu sistema com o cliente do AdSync e ligue o webhook.
- O sistema da agência envia um POST em /api/webhooks/aprovacao. Cada envio leva a data e uma assinatura HMAC calculada com o segredo, aceita até 5 minutos para mais ou para menos. Reenviar o mesmo id de evento não duplica nada. Quem integra recebe o contrato do webhook (OpenAPI) e exemplos de código.
- O AdSync traz os criativos pelo caminho seguro, monta a subida com os padrões do cliente e confere o pré-voo. Nada é criado ainda.
- O responsável pelo cliente recebe no WhatsApp a prévia, o link do painel e um código. Responda SIM e o código (por exemplo, SIM 482913) ou confirme em Aprovações. A prévia vale 48 horas, e um alerta da Sentinela não a cancela.
- No número oficial, fora da janela de 24 horas, o aviso vai por um modelo de mensagem só com o link do painel: a confirmação continua no painel ou por texto depois que a pessoa responder.
- “Ativo direto” pelo webhook só funciona com Publicar ativo direto ligado em Subidas e teto por subida preenchido no cliente. Mesmo assim o responsável é avisado, e qualquer condição que falte volta para a confirmação.
Deu problema?
O webhook responde 401
O identificador, a data ou a assinatura não batem. Assine o corpo exatamente como é enviado, junte a data e um ponto antes do corpo, e confira o relógio do servidor (limite de 5 minutos).
O webhook responde 422
O cliente não está mapeado, o host do link não está liberado, ou o cliente não tem conta da plataforma pedida. Em Webhook, os últimos eventos mostram o motivo.
O SIM com código não confirmou
O código vale uma vez, só para o número liberado da agência e só para quem opera as contas da prévia. Depois de 48 horas a aprovação vence e o responsável é avisado. Aprovações mostra o que ainda está aberto.
Ninguém foi avisado no WhatsApp
O responsável precisa ter número liberado. Sem responsável, avisam quem opera as contas. A prévia continua em Aprovações.
Token e permissões da Meta
Como gerar o token certo, o que cada permissão faz e quando reconectar.
- Gerar o token: no Gerenciador de Negócios, Configurações do negócio → Usuários → Usuários do sistema. Escolha o usuário do sistema, dê a ele as contas de anúncio, as páginas e os pixels dos clientes, clique em Gerar novo token, escolha o app e marque as permissões abaixo. Cole o token em Conexões. O token de usuário do sistema não expira.
- Para consultar e mudar campanhas: ads_read, ads_management e business_management.
- Para subir anúncios: pages_show_list (lista as páginas), pages_read_engagement (lê a página) e pages_manage_ads (permite anunciar pela página). Sem as três, o AdSync não sobe.
- instagram_basic é opcional: deixa escolher o Instagram pelo nome. Sem ela, o assistente avisa que não conseguiu listar o Instagram.
- Pelo botão de login com a Meta, as mesmas permissões são pedidas na tela de autorização. Aceite todas.
- Quando reconectar: quando a conexão aparecer como Expirada, quando Conexões avisar “Reconecte para subir anúncios (falta: …)”, ou quando você trocar de app. Gere um token novo com a lista completa e cole de novo: as contas não duplicam.
Deu problema?
Conexões diz “falta: pages_manage_ads”
O token foi gerado sem essa permissão. Gere outro marcando todas e cole em Conexões. Ao conectar, o AdSync lê as permissões na Meta e o aviso some.
A página ou o pixel do cliente não aparece para escolher
O usuário do sistema precisa ter acesso à página e ao pixel, em Atribuir ativos, além da conta de anúncio. Atribua e peça de novo.
A Meta recusou por permissão ao subir
A mensagem manda reconectar quando falta permissão nova. Gere o token com a lista completa. Se a lista estava completa, confira se o usuário do sistema ainda tem acesso à conta, à página e ao pixel.
Usei um token de usuário comum e parou
Token de usuário comum expira de 1 hora a 60 dias. Use o do usuário do sistema.
Permissões do Google
Que acesso o usuário precisa ter, o nível de acesso do projeto à API e como a cota funciona.
- Usuário: conecte o Google com um usuário que tenha, no Google Ads, acesso de edição às contas (padrão ou administrador). Só leitura permite consultar, não subir. Para as contas de uma MCC, o usuário precisa de acesso à MCC.
- O AdSync pede uma única autorização do Google (acesso ao Google Ads). Não há developer token para cadastrar: desde 09/09/2026 o Google não usa mais.
- Nível de acesso à API: ele é do projeto do Google Cloud dono do aplicativo, em Google Ads API → Overview, e vale para todas as agências da plataforma. Os níveis são Explorer, Basic e Standard. Quem opera a plataforma pede o Basic quando o volume crescer; a agência não faz isso.
- Cota: a cota diária de operações é do projeto inteiro (Explorer 2.880, Basic 15.000). O AdSync conta cada operação e corta antes do limite: a subida usa até 100%, as consultas de quem pergunta até 85% e a Sentinela até 70%. Passou, a subida espera e retoma sozinha quando operações antigas saem da janela de 24 horas; a tela Status mostra a que horas.
- A tela Status mostra o consumo da cota e quando o Google ainda não liberou o acesso do projeto.
Deu problema?
Aparece que o projeto não tem acesso de produção
O nível de acesso do projeto do Google Cloud ainda não foi liberado. É com quem opera a plataforma: ele pede o nível em Google Cloud Console → Google Ads API → Overview.
Erro de permissão ao subir campanha
Quem conectou perdeu o acesso à conta ou tem acesso só de leitura. Ajuste o acesso no Google Ads, reconecte o Google em Conexões e tente de novo.
Os alertas do Google estão demorando
A Sentinela lê cada conta do Google a cada 2 horas para economizar a cota. Conferir agora lê na hora.
A conexão do Google parou depois de trocar o aplicativo
Conexões feitas com o aplicativo antigo deixam de renovar. Reconecte o Google em Conexões.
Não resolveu?
Conte em qual aula travou e o que apareceu na tela. Um print ajuda a responder mais rápido.
Fale com quem te vendeu o AdSync.