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 | O prazo de acesso do aluno (ISO 8601). Vazio significa sem prazo |
É 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 atingiu o prazo de acesso. Use-os para encerrar o acesso no prazo, enviar ofertas de reconquista ou 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.
A menos que o suporte do Alva tenha ativado a aplicação de prazos na sua loja (ela fica desligada por padrão), um prazo não encerra o acesso sozinho. Course access expiring soon e Course access expired são disparados na data armazenada para o aluno de qualquer forma, mas, com a aplicação desligada, o aluno ainda consegue abrir o curso depois que ela passa. Para encerrar o acesso na data, adicione Revoke course access a um fluxo de trabalho com Course access expired; Lembrar os alunos antes de um prazo do curso mostra como.
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
Faltam 14, 7, 3 ou 1 dia para o prazo de acesso de um aluno a um curso do Alva. 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 prazo de acesso está próximo, 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 | O prazo de acesso (ISO 8601), antes de qualquer período de tolerância |
Days until expiry |
Número | 14, 7, 3 ou 1 |
Access enforced |
Verdadeiro ou falso | Se você aplica os prazos de acesso. Quando é verdadeiro, o aluno é bloqueado depois do prazo mais qualquer período de tolerância. Quando é falso, ele mantém o acesso |
É disparado no máximo uma vez para cada um dos marcos de 14, 7, 3 e 1 dia antes do prazo do aluno, 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. Access enforced indica se o aluno será bloqueado assim que o prazo e qualquer período de tolerância passarem, então uma condição nele faz o lembrete corresponder ao que realmente vai acontecer.
Course access expired
O prazo de acesso de um aluno a um curso do Alva, mais qualquer período de tolerância, já passou. Access enforced indica se ele agora está bloqueado.
| Campo | Tipo | O que contém |
|---|---|---|
| Cliente | Cliente do Shopify | O aluno cujo prazo de acesso passou, 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 | O prazo de acesso que passou (ISO 8601), sem qualquer período de tolerância |
Access enforced |
Verdadeiro ou falso | Se você aplica os prazos de acesso. Quando é verdadeiro, o aluno agora está bloqueado. Quando é falso, ele mantém o acesso até que seja revogado |
É disparado assim que passa a data de expiração mais qualquer período de tolerância, quer o Alva Courses bloqueie alunos com acesso expirado, quer não; Access enforced indica qual é o caso. Quando é falso, o aluno ainda consegue abrir o curso até que um fluxo de trabalho execute Revoke course access ou você o remova. 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-13
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 contact form submittedUm aluno enviou uma mensagem por um formulário de contato em uma aula de um curso Alva.
Course IDCourse titleCourse URLLesson IDLesson titleLesson URLMessage IDMessage subjectMessage textIdentity verifiedÉ acionado uma vez quando uma nova mensagem de contato é salva, independentemente do sucesso do e-mail de notificação. Tentar novamente o mesmo envio ou reenviar uma notificação não cria outro evento. Use-o para criar um chamado de suporte, avisar sua equipe ou registrar uma mensagem no Google Sheets.
Os títulos e o texto vêm da mensagem salva. Os links ficam vazios se o curso ou a aula não existir mais. A mensagem completa permanece em Alva Courses → Mensagens; apenas os primeiros 2.000 caracteres são enviados ao Flow. Esses campos contêm correspondência privada dos alunos: escolha os destinos do fluxo de trabalho levando isso em conta.
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. O e-mail do certificado começa desativado, então este gatilho só é disparado depois que você marcar Habilitar e-mail na página Certificados (Configurações → Configurações de e-mail → Editar modelo de certificado).