Usar os campos dos gatilhos
Todo gatilho do Alva Courses começa com o aluno como cliente do Shopify, seguido de Course ID, Course title e Course URL. Os gatilhos de aula acrescentam Lesson ID, Lesson title e Lesson URL. Todos os campos são sempre enviados: um texto que não se aplica fica vazio, e um número que não se aplica é 0.
Em uma Condição, escolha o campo nos dados do gatilho. No texto de uma ação, insira-o com Adicionar uma variável. Ali, o Flow escreve o nome de cada campo em camelCase, então Course title vira {{ courseTitle }}. Use o seletor em vez de digitar os nomes, para que os campos com ID ou URL no nome saiam exatamente certos.
Os links de curso e de aula abrem a sua vitrine, onde o aluno faz login para ver o curso. Datas e horários são texto no formato ISO 8601 e em UTC, como 2026-10-01T09:30:00.000Z.
Gatilhos de matrícula e progresso
Estes gatilhos acompanham o aluno ao longo de um curso, da matrícula à conclusão. Use-os para adicionar tags ou agradecer aos alunos, sincronizar o progresso com uma ferramenta de e-mail ou receber um alerta quando um quiz vai mal. Cada um é disparado uma vez por mudança real, nunca por uma solicitação repetida.
Course enrollment created
Um cliente foi matriculado em um curso do Alva por compra, por você, ou por importação de CSV, tag de membro, inscrição gratuita feita pelo próprio aluno ou ação do Flow.
| Campo | Tipo | O que contém |
|---|---|---|
| Cliente | Cliente do Shopify | O aluno matriculado, com todos os campos de cliente do Shopify, como e-mail e tags |
Course ID |
Texto | O ID do curso no Alva |
Course title |
Texto | O título do curso |
Course URL |
URL | Link para o curso na vitrine (o aluno faz login para abri-lo) |
Enrollment source |
Texto | Como o aluno foi matriculado: purchase, manual, import, membership tag, free ou flow |
Order name |
Texto | O pedido que concedeu o acesso, como #1001. Vazio, a menos que o curso tenha sido comprado |
Access expires at |
Texto | Quando o acesso expira (ISO 8601). Vazio significa ilimitado |
É disparado uma vez, quando a matrícula é criada. Estender, renovar ou restaurar o acesso não o dispara de novo; remover um aluno e matriculá-lo outra vez, sim, porque isso é uma nova matrícula. Uma matrícula feita pela ação Enroll customer in course tem Enrollment source definido como flow.
Course lesson completed
Um aluno concluiu uma aula em um curso do Alva. É disparado de novo se ele concluir a aula outra vez depois que o progresso dele for redefinido; veja Repeat completion.
| Campo | Tipo | O que contém |
|---|---|---|
| Cliente | Cliente do Shopify | O aluno que concluiu a aula, com todos os campos de cliente do Shopify, como e-mail e tags |
Course ID |
Texto | O ID do curso no Alva |
Course title |
Texto | O título do curso |
Course URL |
URL | Link para o curso na vitrine (o aluno faz login para abri-lo) |
Lesson ID |
Texto | O ID da aula no Alva |
Lesson title |
Texto | O título da aula |
Lesson URL |
URL | Link para a aula na vitrine |
Lessons completed |
Número | Aulas que o aluno concluiu neste curso |
Total lessons |
Número | Aulas do curso |
Percent complete |
Número | Progresso no curso, de 0 a 100 |
Repeat completion |
Verdadeiro ou falso | Se o aluno já tinha concluído esta aula e o progresso dele foi redefinido desde então. Adicione uma condição sobre este campo para recompensar cada aula uma única vez |
É disparado na primeira vez que um aluno conclui uma aula. Concluí-la de novo não envia nada, a menos que o progresso dele tenha sido redefinido nesse meio-tempo: nesse caso, é disparado de novo com Repeat completion definido como verdadeiro. Para recompensar cada aula uma única vez, adicione uma condição em que Repeat completion seja falso.
Course completed
Um aluno concluiu um curso do Alva: todas as aulas, os quizzes obrigatórios e uma avaliação aprovada, quando o curso exige uma.
| Campo | Tipo | O que contém |
|---|---|---|
| Cliente | Cliente do Shopify | O aluno que concluiu o curso, com todos os campos de cliente do Shopify, como e-mail e tags |
Course ID |
Texto | O ID do curso no Alva |
Course title |
Texto | O título do curso |
Course URL |
URL | Link para o curso na vitrine (o aluno faz login para abri-lo) |
Completed at |
Texto | Quando o curso foi concluído (ISO 8601) |
Grade |
Texto | A nota em letra da avaliação. Vazio quando o curso não tem avaliação |
Final score |
Número | A pontuação da avaliação. 0 quando o curso não tem avaliação |
Evaluation required |
Verdadeiro ou falso | Se um instrutor precisou aprovar o trabalho do aluno |
É disparado na primeira vez que um aluno conclui o curso. Em um curso que exige avaliação, esse é o momento em que você aprova o trabalho dele, não quando ele termina a última aula. Se você redefinir o progresso dele, ou se a ação Reset course progress fizer isso, concluir o curso de novo o dispara outra vez; um aluno que redefine o próprio progresso não o dispara.
Course quiz graded
A tentativa de quiz de um aluno em um curso do Alva foi aprovada, reprovada ou expirou. Quizzes que precisam de revisão manual disparam depois que você os revisa.
| Campo | Tipo | O que contém |
|---|---|---|
| Cliente | Cliente do Shopify | O aluno que fez o quiz, com todos os campos de cliente do Shopify, como e-mail e tags |
Course ID |
Texto | O ID do curso no Alva |
Course title |
Texto | O título do curso |
Course URL |
URL | Link para o curso na vitrine (o aluno faz login para abri-lo) |
Lesson ID |
Texto | O ID da aula no Alva |
Lesson title |
Texto | O título da aula |
Lesson URL |
URL | Link para a aula na vitrine |
Quiz ID |
Texto | O ID do quiz no Alva |
Quiz title |
Texto | O título do quiz |
Result |
Texto | passed, failed ou expired |
Passed |
Verdadeiro ou falso | Se o aluno foi aprovado |
Score |
Número | A pontuação, em porcentagem |
Passing score |
Número | A porcentagem necessária para ser aprovado |
Attempt number |
Número | Qual tentativa foi esta, começando em 1 |
Manually reviewed |
Verdadeiro ou falso | Se você corrigiu alguma resposta manualmente |
Answers |
Texto | Uma linha por pergunta: a pergunta, a resposta do aluno e se ela estava correta |
É disparado quando uma tentativa é aprovada ou reprovada. Uma tentativa com tempo limite que se esgota dispara com Result expired assim que o Alva Courses percebe: quando o aluno envia, inicia o quiz de novo ou quando as respostas dele são salvas. Quizzes com respostas que você corrige manualmente disparam depois que você os revisa, e mudar uma nota de aprovado para reprovado, ou o contrário, dispara de novo com o novo resultado.
Answers tem uma linha por pergunta, com a resposta do aluno e se ela estava correta. Em quizzes muito longos, o campo pode ser encurtado para que o gatilho fique dentro do limite de tamanho do Shopify Flow.
Gatilhos de acesso
Estes gatilhos informam que um aluno perdeu o acesso ou está prestes a perdê-lo. Use-os para lembretes de renovação, ofertas de reconquista ou para organizar tags e listas. Os gatilhos de expiração vêm de uma verificação feita a cada hora, então chegam dentro dessa hora, e não no minuto exato.
Course access removed
Um aluno perdeu o acesso a um curso do Alva: teve a matrícula cancelada, foi reembolsado, foi excluído como membro ou teve o acesso revogado pelo Flow. Remover uma tag de membro não dispara este gatilho.
| Campo | Tipo | O que contém |
|---|---|---|
| Cliente | Cliente do Shopify | O aluno que perdeu o acesso, com todos os campos de cliente do Shopify, como e-mail e tags |
Course ID |
Texto | O ID do curso no Alva |
Course title |
Texto | O título do curso |
Course URL |
URL | Link para o curso na vitrine (o aluno faz login para abri-lo) |
Reason |
Texto | unenrolled, refunded, member deleted ou revoked by flow |
Reason é unenrolled quando você remove o aluno do curso, refunded após um reembolso, member deleted quando você exclui o membro (uma vez para cada curso que ele tinha) ou revoked by flow. Remover uma tag de membro, excluir um curso, desinstalar o Alva Courses e a exclusão de dados de clientes não o disparam, e o fim do acesso por expiração dispara Course access expired no lugar dele.
Course access expiring soon
O acesso de um aluno a um curso do Alva expira em 14, 7, 3 ou 1 dia. Adicione uma condição em Days until expiry para escolher quando agir.
| Campo | Tipo | O que contém |
|---|---|---|
| Cliente | Cliente do Shopify | O aluno cujo acesso está expirando, com todos os campos de cliente do Shopify, como e-mail e tags |
Course ID |
Texto | O ID do curso no Alva |
Course title |
Texto | O título do curso |
Course URL |
URL | Link para o curso na vitrine (o aluno faz login para abri-lo) |
Access expires at |
Texto | Quando o acesso expira (ISO 8601) |
Days until expiry |
Número | 14, 7, 3 ou 1 |
É disparado no máximo uma vez para cada um dos marcos de 14, 7, 3 e 1 dia antes do fim do acesso, e só para o mais próximo já atingido, então um aluno matriculado com 5 dias restantes recebe o de 7, nunca o de 14 e o de 7 ao mesmo tempo. Estender o acesso reinicia a contagem regressiva. Alunos revogados, acesso por tag de membro e cursos gratuitos ficam de fora.
Course access expired
O acesso de um aluno a um curso do Alva chegou à data de expiração, somada ao seu período de tolerância.
| Campo | Tipo | O que contém |
|---|---|---|
| Cliente | Cliente do Shopify | O aluno cujo acesso expirou, com todos os campos de cliente do Shopify, como e-mail e tags |
Course ID |
Texto | O ID do curso no Alva |
Course title |
Texto | O título do curso |
Course URL |
URL | Link para o curso na vitrine (o aluno faz login para abri-lo) |
Access expired at |
Texto | Quando o acesso expirou (ISO 8601) |
Access enforced |
Verdadeiro ou falso | Se o Alva bloqueia alunos com acesso expirado. Quando essa opção está desativada, o aluno ainda pode abrir o curso |
É disparado assim que passa a data de expiração mais qualquer período de tolerância, quer você bloqueie alunos com acesso expirado, quer não; Access enforced indica qual é o caso. Ele ignora prazos que passaram mais de 48 horas antes da verificação, então ativar um fluxo de trabalho nunca reenvia expirações antigas. Access expired at é a própria data de expiração, sem o período de tolerância.
Veja também
Isso foi útil?
Última atualização em 2026-10-01
Gatilhos de comentários, trabalhos e certificados
Estes gatilhos cobrem conversas e trabalhos avaliados: um aluno comenta, você responde, um aluno envia um trabalho, você o avalia e um certificado é enviado. Use-os para publicar comentários no Slack, enviar suas respostas por e-mail aos alunos ou manter um registro das notas.
Course lesson comment postedUm aluno publicou um comentário ou uma resposta em uma aula de um curso do Alva.
Course IDCourse titleCourse URLLesson IDLesson titleLesson URLComment IDComment textIs replyÉ disparado para comentários e respostas escritos por alunos, quer o Alva Courses envie e-mails para você sobre novos comentários, quer não. As suas próprias respostas disparam
Course instructor reply postedno lugar deste.Course instructor reply postedVocê respondeu ao comentário de um aluno em uma aula de um curso do Alva. O cliente é o aluno a quem você respondeu.
Course IDCourse titleCourse URLLesson IDLesson titleLesson URLReply textComment IDÉ disparado quando você responde a um comentário escrito por um aluno. O cliente é esse aluno, então o fluxo de trabalho pode enviar um e-mail para ele. O próprio Alva Courses não envia e-mails aos alunos sobre as suas respostas, e é para isso que serve este gatilho.
Course coursework submittedUm aluno enviou o trabalho do curso para avaliação em um curso do Alva.
Course IDCourse titleCourse URLSubmission numberÉ disparado cada vez que um aluno envia um trabalho para avaliação, inclusive um reenvio depois que você pediu uma revisão.
Course coursework evaluatedVocê avaliou o trabalho de um aluno em um curso do Alva, como aprovado ou como pedido de revisão.
Course IDCourse titleCourse URLOutcomeGradeFinal scoreFeedback visible to studentSubmission numberÉ disparado quando você aprova o trabalho ou pede uma revisão. Uma aprovação que conclui o curso também dispara
Course completed. O seu feedback escrito não é incluído, porque pode ser longo e pessoal.Course certificate issuedUm certificado de curso do Alva foi enviado por e-mail a um aluno.
Course IDCourse titleCourse URLIssued atÉ disparado quando o Alva Courses envia por e-mail o certificado de um aluno, incluindo um certificado enviado pela ação
Send course certificate. Reenviar um certificado pela página do membro não o dispara de novo, e um certificado que o aluno apenas baixa não dispara nada.