{
  "id": "meta-ads-conexao",
  "titulo": "Meta Ads (conexão)",
  "tela": "/app/settings/meta-ads",
  "resumo": "A página onde o administrador liga, troca ou desliga a conta de anúncios do Facebook e do Instagram, para o sistema poder ler os resultados das campanhas.",
  "licoes": [
    {
      "id": "conhecendo-a-tela",
      "titulo": "Conhecendo a página de conexão",
      "objetivo": "Achar a página de conexão do Meta Ads em Configurações e entender o que ela pede antes de a conta ser ligada.",
      "papel": "admin",
      "busca": [
        "conectar meta ads",
        "ligar conta de anúncios facebook",
        "configurar anúncios instagram",
        "onde fica meta ads configurações",
        "token de acesso meta",
        "ads_read"
      ],
      "passos": [
        {
          "id": "p1",
          "titulo": "Onde fica",
          "texto": "Abra \"Configurações\", no rodapé do menu. A página fica na seção \"Sua empresa\", no cartão \"Meta Ads\". Não confunda com o cartão \"Conversões\": ele serve para outra coisa e pede um token diferente. Só o administrador da empresa vê este cartão. Clique nele.",
          "rota": "/app/settings",
          "destaques": [
            {
              "alvo": {
                "css": "a[href='/app/settings/meta-ads']"
              },
              "rotulo": "Conexão com a conta de anúncios",
              "tipo": "seta"
            }
          ],
          "clicar": {
            "css": "a[href='/app/settings/meta-ads']"
          },
          "antes": []
        },
        {
          "id": "p2",
          "titulo": "Uma ligação só para ler",
          "texto": "A frase do alto avisa que a ligação é só de leitura: o sistema lê o desempenho das campanhas e mostra em \"Análise\", na tela Meta Ads, mas nada é criado, pausado ou alterado na sua conta de anúncios. O quadro azul diz o que você precisa trazer: um token de acesso, uma senha especial que o Facebook gera para o sistema ler os seus anúncios. O token é gerado no site Meta for Developers, dentro de um aplicativo da sua conta de desenvolvedor da Meta. Na hora de gerar, marque a permissão \"ads_read\" (é ela que deixa o sistema ler os anúncios). Se quem cuida dos seus anúncios é outra pessoa ou agência, peça o token a ela.",
          "dica": "O token fica guardado de forma protegida e nunca é mostrado de volta, nem para você.",
          "antes": [
            {
              "acao": "click",
              "alvo": {
                "css": "a[href='/app/settings/meta-ads']"
              }
            },
            {
              "acao": "aguardar",
              "alvo": {
                "rotulo": "Token de acesso",
                "exato": true
              }
            }
          ],
          "destaques": [
            {
              "alvo": {
                "texto": "É uma conexão só de leitura"
              },
              "rotulo": "Nada muda na sua conta",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "texto": "O token precisa da permissão ads_read"
              },
              "rotulo": "O que você precisa trazer",
              "tipo": "caixa"
            }
          ]
        },
        {
          "id": "p3",
          "titulo": "Os dois campos",
          "texto": "O campo \"Token de acesso\" recebe o token que você gerou. O \"EAA…\" cinza é só um exemplo de como ele começa: o campo está vazio. O mesmo vale para o \"act_123456789012345\" cinza do campo de baixo. O campo \"Conta padrão (opcional)\" diz qual conta de anúncios a tela de Meta Ads abre primeiro. Enquanto não houver um token colado no campo, o botão \"Salvar\" fica apagado e aparece \"Cole o token para poder salvar.\". Se você colou e o aviso continua, o token veio cortado: copie-o de novo, inteiro.",
          "destaques": [
            {
              "alvo": {
                "rotulo": "Token de acesso",
                "exato": true
              },
              "rotulo": "Cole o token aqui",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "rotulo": "Conta padrão (opcional)",
                "exato": true
              },
              "rotulo": "Opcional: a conta que abre primeiro",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "role": "button",
                "nome": "Salvar",
                "exato": true
              },
              "rotulo": "Apagado até colar o token",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "texto": "Cole o token para poder salvar.",
                "exato": true
              },
              "rotulo": "Por que não dá para salvar",
              "tipo": "caixa"
            }
          ],
          "antes": []
        }
      ]
    },
    {
      "id": "ligar-a-conta",
      "titulo": "Ligando a conta de anúncios",
      "objetivo": "Colar o token, escolher a conta padrão, salvar e reconhecer a página com a conta já ligada.",
      "papel": "admin",
      "busca": [
        "como colar o token do facebook",
        "salvar conexão meta ads",
        "conta padrão act",
        "ligar anúncios ao sistema",
        "conexão salva meta"
      ],
      "passos": [
        {
          "id": "p1",
          "titulo": "Cole o token",
          "texto": "Cole o token no campo \"Token de acesso\". Ele aparece como pontinhos, para ninguém ler por cima do seu ombro. Com o token colado, o botão \"Salvar\" acende. Na primeira vez, o token é obrigatório. O \"act_123…\" cinza no campo de baixo ainda é só um exemplo: a conta padrão fica para o próximo passo.",
          "rota": "/app/settings/meta-ads",
          "antes": [
            {
              "acao": "aguardar",
              "alvo": {
                "rotulo": "Token de acesso",
                "exato": true
              }
            },
            {
              "acao": "fill",
              "alvo": {
                "rotulo": "Token de acesso",
                "exato": true
              },
              "valor": "EAAGexemploTokenDaClinicaBemViver2026"
            }
          ],
          "destaques": [
            {
              "alvo": {
                "rotulo": "Token de acesso",
                "exato": true
              },
              "rotulo": "Token colado",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "role": "button",
                "nome": "Salvar",
                "exato": true
              },
              "rotulo": "Agora dá para salvar",
              "tipo": "seta"
            }
          ]
        },
        {
          "id": "p2",
          "titulo": "Escolha a conta que abre primeiro",
          "texto": "Se você tem mais de uma conta de anúncios, escreva em \"Conta padrão (opcional)\" a que deve abrir primeiro: \"act_\" seguido dos números da conta, que aparecem no Gerenciador de Anúncios. Se deixar em branco, a tela de Meta Ads abre a primeira conta ativa que o token alcançar.",
          "antes": [
            {
              "acao": "fill",
              "alvo": {
                "rotulo": "Conta padrão (opcional)",
                "exato": true
              },
              "valor": "act_284019573310482"
            }
          ],
          "destaques": [
            {
              "alvo": {
                "rotulo": "Conta padrão (opcional)",
                "exato": true
              },
              "rotulo": "act_ e os números da conta",
              "tipo": "caixa"
            }
          ],
          "clicar": {
            "role": "button",
            "nome": "Salvar",
            "exato": true
          }
        },
        {
          "id": "p3",
          "titulo": "Conexão salva",
          "texto": "Clique em \"Salvar\". Por alguns segundos aparece o aviso \"Conexão salva.\" no canto de baixo da tela. O campo do token fica vazio de novo, agora com \"Guardado — preencha só para trocar\", e logo abaixo aparece \"Já existe um token guardado.\": o token foi guardado, mas nunca é mostrado de volta. O sistema não testa o token na hora de salvar. Se ele estiver vencido ou sem a permissão \"ads_read\", o aviso aparece na tela de Meta Ads, dizendo o que fazer.",
          "antes": [
            {
              "acao": "click",
              "alvo": {
                "role": "button",
                "nome": "Salvar",
                "exato": true
              }
            },
            {
              "acao": "aguardar",
              "alvo": {
                "role": "button",
                "nome": "Desconectar",
                "exato": true
              }
            }
          ],
          "destaques": [
            {
              "alvo": {
                "rotulo": "Token de acesso",
                "exato": true
              },
              "rotulo": "Token guardado",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "texto": "Já existe um token guardado."
              },
              "rotulo": "Em branco: mantém o token",
              "tipo": "caixa"
            }
          ]
        },
        {
          "id": "p4",
          "titulo": "A página com a conta ligada",
          "texto": "Com a conta ligada, o \"Salvar\" funciona mesmo com o campo do token em branco, e surge o botão \"Desconectar\", que apaga o token guardado. A frase no fim da página lembra que, para trocar só a conta padrão, basta deixar o token em branco.",
          "destaques": [
            {
              "alvo": {
                "role": "button",
                "nome": "Salvar",
                "exato": true
              },
              "rotulo": "Salva mesmo em branco",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "role": "button",
                "nome": "Desconectar",
                "exato": true
              },
              "rotulo": "Desligar a conta",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "texto": "Para trocar apenas a conta padrão"
              },
              "rotulo": "Trocar só a conta",
              "tipo": "caixa"
            }
          ],
          "antes": []
        }
      ]
    },
    {
      "id": "trocar-ou-desconectar",
      "titulo": "Trocando a conta ou desligando",
      "objetivo": "Trocar a conta padrão sem colar o token de novo, entender o aviso de formato errado e desligar a conta de anúncios.",
      "papel": "admin",
      "busca": [
        "trocar conta de anúncios meta",
        "trocar token facebook ads",
        "desconectar meta ads",
        "desligar conta de anúncios",
        "token vencido meta"
      ],
      "passos": [
        {
          "id": "p1",
          "titulo": "Com a conta já ligada",
          "texto": "Aqui a conta da clínica já está ligada, com a conta padrão \"act_284019573310482\". Para trocar só a conta padrão, deixe o campo do token em branco: o token guardado é mantido. Para trocar o token, por exemplo quando ele vence, cole o novo no mesmo campo e salve.",
          "rota": "/app/settings/meta-ads",
          "antes": [
            {
              "acao": "aguardar",
              "alvo": {
                "rotulo": "Token de acesso",
                "exato": true
              }
            },
            {
              "acao": "fill",
              "alvo": {
                "rotulo": "Token de acesso",
                "exato": true
              },
              "valor": "EAAGexemploTokenDaClinicaBemViver2026"
            },
            {
              "acao": "fill",
              "alvo": {
                "rotulo": "Conta padrão (opcional)",
                "exato": true
              },
              "valor": "act_284019573310482"
            },
            {
              "acao": "click",
              "alvo": {
                "role": "button",
                "nome": "Salvar",
                "exato": true
              }
            },
            {
              "acao": "aguardar",
              "alvo": {
                "role": "button",
                "nome": "Desconectar",
                "exato": true
              }
            }
          ],
          "destaques": [
            {
              "alvo": {
                "rotulo": "Token de acesso",
                "exato": true
              },
              "rotulo": "Em branco: mantém o token",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "rotulo": "Conta padrão (opcional)",
                "exato": true
              },
              "rotulo": "Conta padrão atual",
              "tipo": "caixa"
            }
          ]
        },
        {
          "id": "p2",
          "titulo": "Cuidado com o formato",
          "texto": "A conta padrão precisa ter \"act_\" na frente dos números. Se você escrever só os números, como aqui, e clicar em \"Salvar\", aparece por alguns segundos o aviso \"Confira os campos: algum valor não está no formato esperado.\" no canto de baixo da tela, e nada é gravado. A conta que estava salva continua valendo.",
          "antes": [
            {
              "acao": "fill",
              "alvo": {
                "rotulo": "Conta padrão (opcional)",
                "exato": true
              },
              "valor": "559203817746120"
            }
          ],
          "destaques": [
            {
              "alvo": {
                "rotulo": "Conta padrão (opcional)",
                "exato": true
              },
              "rotulo": "Faltou o act_",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "role": "button",
                "nome": "Salvar",
                "exato": true
              },
              "rotulo": "Assim, não grava",
              "tipo": "seta"
            }
          ]
        },
        {
          "id": "p3",
          "titulo": "Trocando a conta padrão",
          "texto": "Com \"act_\" na frente, clique em \"Salvar\": a nova conta padrão é gravada e aparece por alguns segundos o aviso \"Conexão salva.\". O token guardado não muda. Da próxima vez, a tela de Meta Ads já abre nesta conta.",
          "antes": [
            {
              "acao": "fill",
              "alvo": {
                "rotulo": "Conta padrão (opcional)",
                "exato": true
              },
              "valor": "act_559203817746120"
            }
          ],
          "destaques": [
            {
              "alvo": {
                "rotulo": "Conta padrão (opcional)",
                "exato": true
              },
              "rotulo": "Nova conta padrão",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "role": "button",
                "nome": "Salvar",
                "exato": true
              },
              "rotulo": "Grava a troca",
              "tipo": "seta"
            }
          ],
          "clicar": {
            "role": "button",
            "nome": "Salvar",
            "exato": true
          }
        },
        {
          "id": "p4",
          "titulo": "O botão Desconectar",
          "texto": "\"Desconectar\" apaga na hora, sem pedir confirmação, o token guardado e a conta padrão escolhida. Nada muda na sua conta de anúncios, e nenhum número de campanha se perde: o sistema não guarda esses números, só os lê da Meta quando você abre a tela. Depois disso, a tela de Meta Ads volta a pedir uma conexão. Atenção: o sistema nunca devolve o token. Para ligar de novo, você vai precisar dele; se não o guardou, gere outro no Meta for Developers.",
          "antes": [
            {
              "acao": "click",
              "alvo": {
                "role": "button",
                "nome": "Salvar",
                "exato": true
              }
            },
            {
              "acao": "esperar",
              "ms": 5500
            }
          ],
          "destaques": [
            {
              "alvo": {
                "css": "form div.flex.items-center.gap-3"
              },
              "rotulo": "\"Desconectar\", ao lado do \"Salvar\"",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "texto": "Desconectar apaga o token guardado."
              },
              "rotulo": "O que acontece",
              "tipo": "caixa"
            }
          ],
          "clicar": {
            "role": "button",
            "nome": "Desconectar",
            "exato": true
          }
        },
        {
          "id": "p5",
          "titulo": "Conta desligada",
          "texto": "Aparece por alguns segundos o aviso \"Conta desconectada.\" e a página volta ao começo: campos vazios (o \"EAA…\" e o \"act_123…\" cinzas são só exemplos), \"Salvar\" apagado e \"Cole o token para poder salvar.\". Para ligar de novo, cole um token e salve: o mesmo que você guardou, ou um novo gerado no Meta for Developers.",
          "antes": [
            {
              "acao": "click",
              "alvo": {
                "role": "button",
                "nome": "Desconectar",
                "exato": true
              }
            },
            {
              "acao": "aguardar",
              "alvo": {
                "texto": "Cole o token para poder salvar.",
                "exato": true
              }
            }
          ],
          "destaques": [
            {
              "alvo": {
                "rotulo": "Token de acesso",
                "exato": true
              },
              "rotulo": "Token apagado",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "rotulo": "Conta padrão (opcional)",
                "exato": true
              },
              "rotulo": "Vazia: o cinza é só exemplo",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "role": "button",
                "nome": "Salvar",
                "exato": true
              },
              "rotulo": "Salvar apagado",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "texto": "Cole o token para poder salvar.",
                "exato": true
              },
              "rotulo": "De volta ao começo",
              "tipo": "caixa"
            }
          ]
        }
      ]
    }
  ]
}