O que este fluxo de trabalho faz
Este fluxo de trabalho grava uma linha de planilha para cada tentativa de quiz avaliada no Alva Courses. Cada linha registra quando ela aconteceu, o e-mail do aluno, o curso, a aula e o quiz, se ele foi aprovado, reprovado ou ficou sem tempo, a pontuação dele em comparação com a pontuação mínima e qual tentativa foi.
Um quiz conta como avaliado quando o Alva Courses o corrige. Quizzes com respostas que você revisa manualmente são informados quando você termina de revisá-los, e uma nova correção posterior que transforme uma aprovação em reprovação, ou o contrário, adiciona uma nova linha. Todos os campos estão listados em Gatilhos do Shopify Flow e seus campos.
Crie o fluxo de trabalho
1. Prepare a planilha
Crie uma planilha no Google Sheets e renomeie a primeira aba como Quiz results. Na linha 1, adicione estes cabeçalhos: Data, E-mail, Curso, Aula, Quiz, Resultado, Pontuação, Pontuação mínima, Tentativa, Revisado manualmente e URL da aula.
2. Crie um fluxo de trabalho com o gatilho Course quiz graded
No admin do Shopify, abra Apps e depois Flow, e clique em Criar fluxo de trabalho. Clique em Selecionar um gatilho, encontre Alva Courses e escolha Course quiz graded.
3. Adicione a ação Add row to spreadsheet
Adicione uma ação depois do gatilho e escolha Add row to spreadsheet do Google Sheets. Se o Flow pedir para instalar ou conectar o Google Sheets, siga as instruções e faça login com a conta do Google que pode editar a planilha.
4. Aponte para a sua planilha
Em Spreadsheet URL, cole o endereço da planilha copiado do navegador. Em Tab name, informe Quiz results, escrito exatamente como o nome da aba.
5. Preencha a linha
Row contents (comma separated) recebe um valor por coluna, com uma vírgula entre eles. Comece com {{ "now" | date: "%Y-%m-%d %H:%M" }} para a data e, depois, use Adicionar uma variável para inserir, nesta ordem: o e-mail do cliente, Course title, Lesson title, Quiz title, Result, Score, Passing score, Attempt number, Manually reviewed e Lesson URL.
6. Dê um nome ao fluxo de trabalho e ative-o
Dê ao fluxo de trabalho o nome Registrar resultados de quizzes no Google Sheets e clique em Ativar fluxo de trabalho. O Alva Courses só envia Course quiz graded ao Flow enquanto um fluxo de trabalho ativado o usa, então tentativas avaliadas antes desta etapa não são adicionadas.
Evite que vírgulas dividam um título
Uma vírgula dentro de um valor inicia uma nova coluna, então um curso chamado “Aquarela, nível 1” empurraria todos os valores seguintes uma coluna para a direita. A solução é o filtro replace do Liquid, que troca cada vírgula por um espaço antes de a linha ser gravada.
Depois de inserir um título com Adicionar uma variável, adicione o filtro dentro das chaves: {{ courseTitle }} vira {{ courseTitle | replace: ",", " " }}. Faça o mesmo com Lesson title e Quiz title. Resultados, pontuações e links de aula nunca contêm vírgulas.
Por que as respostas não estão na linha
Course quiz graded também leva Answers: cada pergunta, a resposta do aluno e se ela estava certa. Esse campo fica de fora da linha porque pode ter milhares de caracteres e é cheio de vírgulas. Para ler as respostas de um aluno, envie-as por e-mail para você, como em Receber um e-mail quando um aluno for reprovado em um quiz.
Teste o fluxo de trabalho
Faça login na sua vitrine como um cliente de teste e faça um quiz duas vezes: uma respondendo bem e outra respondendo mal. Duas linhas devem aparecer na aba Quiz results, uma com o resultado passed e outra com failed.
Nenhuma linha? Procure um erro do Google Sheets nas execuções recentes do fluxo de trabalho no Shopify Flow, como um nome de aba digitado errado. Depois, abra Configurações → Integrações → Shopify Flow no Alva Courses e procure Course quiz graded em Atividade do Flow → Gatilhos enviados.
Registre um curso ou só as reprovações
Adicione uma condição entre o gatilho e a ação para restringir o registro. Course ID igual ao ID do Flow de um curso mantém só esse curso; o Alva Courses lista todos os IDs do Flow em Configurações → Integrações → Shopify Flow, em IDs de cursos para o Flow. Passed igual a falso mantém só as tentativas reprovadas e com tempo esgotado.
Para agir sobre um resultado em vez de só registrá-lo, adicione uma das ações do próprio Alva Courses. Extend or set course access, por exemplo, pode dar a um aluno reprovado em um quiz final mais tempo para refazê-lo; veja Ações do Shopify Flow.
Veja também
Isso foi útil?
Última atualização em 2026-10-01