{
  "id": "admin-google",
  "titulo": "Google Agenda (Admin)",
  "tela": "/admin/google",
  "resumo": "Onde quem instalou o sistema cadastra, uma vez só, o aplicativo do Google que deixa cada pessoa da equipe ligar a própria agenda do Google à Agenda do CRM.",
  "licoes": [
    {
      "id": "conhecendo-a-tela",
      "titulo": "Conhecendo a tela do Google Agenda",
      "objetivo": "Saber para que serve o cadastro do Google desta instalação e o que é cada parte da tela.",
      "papel": "admin",
      "busca": [
        "google agenda",
        "google calendar",
        "sincronizar agenda com o google",
        "credenciais do google",
        "endereço de retorno",
        "conectar google",
        "admin"
      ],
      "passos": [
        {
          "id": "p1",
          "titulo": "Onde fica a tela",
          "texto": "No Admin, o item \"Google Agenda\" do menu abre o cadastro do aplicativo do Google desta instalação. Com ele cadastrado, cada pessoa da equipe consegue ligar a própria agenda do Google à Agenda do sistema. O cadastro vale para todas as empresas deste servidor e é feito uma vez só. Depois, cada pessoa conecta a conta dela, sozinha.",
          "rota": "/admin/google",
          "antes": [],
          "destaques": [
            {
              "alvo": {
                "role": "link",
                "nome": "Google Agenda",
                "exato": true
              },
              "rotulo": "Google Agenda no menu do Admin",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "role": "heading",
                "nome": "Google Agenda desta instalação",
                "exato": true
              },
              "rotulo": "Vale para a instalação inteira",
              "tipo": "caixa"
            }
          ],
          "dica": "A faixa amarela \"Sem SMTP configurado\", no alto, é um aviso geral do Admin: o envio de e-mails ainda não está configurado. O item \"E-mail\" do menu leva ao ajuste."
        },
        {
          "id": "p2",
          "titulo": "O endereço de retorno",
          "texto": "\"Endereço de retorno\" é o endereço para onde o Google devolve a pessoa depois que ela autoriza a agenda. Ele já vem pronto e não dá para editar: só copiar. Cole exatamente isto em \"URIs de redirecionamento autorizados\", na tela de credenciais do Google Cloud. O Google compara letra por letra; se algo for diferente, ele recusa a conexão.",
          "dica": "Na sua instalação, o endereço começa com o seu domínio. Na foto aparece o desta demonstração (127.0.0.1).",
          "antes": [],
          "destaques": [
            {
              "alvo": {
                "testid": "google-redirect"
              },
              "rotulo": "Copie e cole no Google Cloud",
              "tipo": "caixa"
            }
          ]
        },
        {
          "id": "p3",
          "titulo": "As duas informações do Google",
          "texto": "\"ID do cliente\" e \"Chave secreta do cliente\" são as duas informações que o Google Cloud mostra quando você cria o aplicativo. Copie cada valor para o campo correspondente. O texto clarinho que aparece nos campos vazios é só um exemplo do formato. A chave é guardada cifrada e nunca mais aparece nesta tela, nem para você.",
          "antes": [],
          "destaques": [
            {
              "alvo": {
                "testid": "google-client-id"
              },
              "rotulo": "ID do cliente",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "testid": "google-client-secret"
              },
              "rotulo": "Chave secreta do cliente",
              "tipo": "caixa"
            }
          ]
        },
        {
          "id": "p4",
          "titulo": "O aviso e a situação",
          "texto": "O quadro de aviso, logo acima do \"Salvar\", explica: se você trocar uma credencial que já está em uso, quem já conectou a agenda pode precisar conectar de novo, porque as autorizações antigas foram dadas ao aplicativo anterior. Ninguém perde compromisso por isso. Na mesma linha do \"Salvar\", à esquerda, \"Nunca configurado por aqui.\" diz que ninguém salvou nada nesta tela ainda. Depois do primeiro \"Salvar\", ali aparece \"Última alteração em\" com a data e a hora.",
          "antes": [],
          "destaques": [
            {
              "alvo": {
                "css": "p:has(> strong:text-is('Ao trocar uma credencial já em uso:'))"
              },
              "rotulo": "Trocar derruba as conexões",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "texto": "Nunca configurado por aqui.",
                "exato": true
              },
              "rotulo": "Situação do cadastro",
              "tipo": "caixa"
            }
          ]
        },
        {
          "id": "p5",
          "titulo": "Também se chega pela Agenda",
          "texto": "Enquanto o aplicativo do Google não está cadastrado, a tela Agenda mostra o quadro \"Sincronizar com o Google ainda não está disponível\". A Agenda funciona normalmente; só não troca compromissos com o Google. Quem administra a instalação vê ali o link \"Cadastrar as credenciais do Google\", que traz direto para a tela do Admin. As outras pessoas da equipe veem só o aviso, sem o link. O quadro também lembra de registrar o endereço de retorno no Google, o mesmo do passo 2.",
          "rota": "/app/agenda",
          "antes": [
            {
              "acao": "aguardar",
              "alvo": {
                "testid": "google-nao-configurado"
              }
            }
          ],
          "destaques": [
            {
              "alvo": {
                "texto": "Sincronizar com o Google ainda não está disponível",
                "exato": true
              },
              "rotulo": "Aviso na Agenda",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "testid": "ir-configurar-google"
              },
              "rotulo": "Leva para o Admin",
              "tipo": "seta"
            }
          ],
          "clicar": {
            "testid": "ir-configurar-google"
          }
        }
      ]
    },
    {
      "id": "cadastrar",
      "titulo": "Cadastrar o aplicativo do Google",
      "objetivo": "Preencher o ID e a chave do Google, saber quando o \"Salvar\" acende e o que muda depois de salvar.",
      "papel": "admin",
      "busca": [
        "cadastrar credenciais do google",
        "id do cliente google",
        "chave secreta google",
        "chave secreta do Google",
        "salvar google agenda",
        "botão salvar apagado"
      ],
      "passos": [
        {
          "id": "p1",
          "titulo": "Cole o ID do cliente",
          "texto": "Copie o ID do cliente no Google Cloud e cole no campo \"ID do cliente\". O botão \"Salvar\" continua apagado: no primeiro cadastro, o ID e a chave são obrigatórios juntos.",
          "rota": "/admin/google",
          "antes": [
            {
              "acao": "fill",
              "alvo": {
                "testid": "google-client-id"
              },
              "valor": "CLIENT_ID_DE_DEMONSTRACAO"
            }
          ],
          "destaques": [
            {
              "alvo": {
                "testid": "google-client-id"
              },
              "rotulo": "ID colado",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "testid": "google-salvar"
              },
              "rotulo": "Ainda apagado",
              "tipo": "seta"
            }
          ],
          "dica": "Os valores preenchidos nesta lição são marcadores de demonstração. Use o ID e a chave secreta da sua própria conta do Google; estes exemplos não conectam uma agenda."
        },
        {
          "id": "p2",
          "titulo": "Cole a chave e salve",
          "texto": "Agora cole a chave secreta. O campo mostra bolinhas no lugar das letras. Com as duas informações, o \"Salvar\" acende: clique nele para gravar. Depois de salvar, o campo da chave fica vazio e mostra \"(já cadastrada)\", e aparece a data da última alteração. Na Agenda, cada pessoa pode conectar a própria conta pelo botão \"Conectar Google\".",
          "dica": "Salvar não testa as informações com o Google: a prova é alguém clicar em \"Conectar Google\" na Agenda. Antes disso, confira duas coisas no Google Cloud. Primeiro, se a \"Google Calendar API\" está ligada (APIs e serviços › Biblioteca), senão a conexão é recusada. Segundo, a página \"Público-alvo\" do Google Auth Platform: o aplicativo nasce \"Em teste\", e nesse estado só entram as contas listadas em \"Usuários de teste\". Qualquer outra conta vê \"Acesso bloqueado: o app não concluiu o processo de verificação do Google\", com \"Erro 403: access_denied\". Para resolver, adicione ali o e-mail de cada pessoa da equipe que vai conectar a agenda, ou clique em \"Publicar app\". Publicar é o mais indicado: em teste, o Google derruba a conexão a cada 7 dias. Depois de publicado, sem a verificação do Google, quem conecta vê o aviso \"O Google não verificou este app\" e segue por \"Avançado\". Para corrigir só o ID depois, deixe a chave em branco: ela continua a que já estava. Quem tem acesso somente leitura ao Admin recebe o aviso \"Seu acesso à administração da plataforma é somente leitura.\" e nada é gravado.",
          "antes": [
            {
              "acao": "fill",
              "alvo": {
                "testid": "google-client-id"
              },
              "valor": "CLIENT_ID_DE_DEMONSTRACAO"
            },
            {
              "acao": "fill",
              "alvo": {
                "testid": "google-client-secret"
              },
              "valor": "SEGREDO_DE_DEMONSTRACAO"
            }
          ],
          "destaques": [
            {
              "alvo": {
                "testid": "google-client-secret"
              },
              "rotulo": "Chave colada (escondida)",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "testid": "google-salvar"
              },
              "rotulo": "Agora acende: clique para gravar",
              "tipo": "seta"
            }
          ]
        },
        {
          "id": "p3",
          "titulo": "Quando a chave vem colada errado",
          "texto": "Um erro comum é copiar a chave junto com o resto da linha do arquivo do Google, com aspas e vírgula no fim. Aqui, o marcador de demonstração foi colado desse jeito. A tela percebe na hora: aparece o aviso para copiar só o valor da chave, e o \"Salvar\" volta a ficar apagado. Tire as aspas e a vírgula para corrigir.",
          "antes": [
            {
              "acao": "fill",
              "alvo": {
                "testid": "google-client-id"
              },
              "valor": "CLIENT_ID_DE_DEMONSTRACAO"
            },
            {
              "acao": "fill",
              "alvo": {
                "testid": "google-client-secret"
              },
              "valor": "\"SEGREDO_DE_DEMONSTRACAO\","
            }
          ],
          "destaques": [
            {
              "alvo": {
                "testid": "google-secret-formato-ruim"
              },
              "rotulo": "Sobrou coisa depois da chave",
              "tipo": "caixa"
            },
            {
              "alvo": {
                "testid": "google-salvar"
              },
              "rotulo": "Apagado até corrigir",
              "tipo": "seta"
            }
          ]
        }
      ]
    }
  ]
}