Ir para o conteúdo principal
— Referência

Gatilhos do Shopify Flow e seus campos

O Alva Courses envia 12 gatilhos ao Shopify Flow. Esta referência mostra quando cada um é disparado e todos os campos que ele leva, para que você possa montar condições e preencher as etapas de ação com os dados certos.

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 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 posted

Um aluno publicou um comentário ou uma resposta em uma aula de um curso do Alva.

Campo Tipo O que contém
Cliente Cliente do Shopify O aluno que publicou o comentário, 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
Comment ID Texto O ID do comentário no Alva
Comment text Texto O comentário, cortado em 2.000 caracteres
Is reply Verdadeiro ou falso Se o comentário responde a outro comentário

É 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 posted no lugar deste.

Course instructor reply posted

Você respondeu ao comentário de um aluno em uma aula de um curso do Alva. O cliente é o aluno a quem você respondeu.

Campo Tipo O que contém
Cliente Cliente do Shopify O aluno cujo comentário recebeu resposta, 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
Reply text Texto Sua resposta, cortada em 2.000 caracteres
Comment ID Texto O ID da sua resposta no Alva

É 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 submitted

Um aluno enviou o trabalho do curso para avaliação em um curso do Alva.

Campo Tipo O que contém
Cliente Cliente do Shopify O aluno que fez o envio, 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)
Submission number Número Qual envio é este, começando em 1

É disparado cada vez que um aluno envia um trabalho para avaliação, inclusive um reenvio depois que você pediu uma revisão.

Course coursework evaluated

Você avaliou o trabalho de um aluno em um curso do Alva, como aprovado ou como pedido de revisão.

Campo Tipo O que contém
Cliente Cliente do Shopify O aluno cujo trabalho foi avaliado, 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)
Outcome Texto pass ou revise
Grade Texto A nota em letra. Vazio quando nenhuma foi atribuída
Final score Número A pontuação. 0 quando nenhuma foi atribuída
Feedback visible to student Verdadeiro ou falso Se o aluno pode ver o seu feedback
Submission number Número Qual envio foi este, começando em 1

É 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 issued

Um certificado de curso do Alva foi enviado por e-mail a um aluno.

Campo Tipo O que contém
Cliente Cliente do Shopify O aluno que recebeu o certificado, 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)
Issued at Texto Quando o certificado foi enviado (ISO 8601)

É 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.

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?

Ainda com dúvidas? Envie um e-mail.

Última atualização em 2026-10-01