Como o Alva Courses funciona com o Shopify Flow
Um fluxo de trabalho do Shopify Flow é formado por um gatilho, condições opcionais e uma ou mais ações. Todo gatilho do Alva Courses leva o aluno como cliente do Shopify, além do ID, do título e do link do curso, para que qualquer ação do Flow possa usá-los: adicionar uma tag de cliente, enviar um e-mail interno, atualizar o Klaviyo ou uma planilha do Google Sheets. As ações do Alva funcionam no sentido inverso e permitem que um fluxo de trabalho matricule um cliente, altere o acesso dele ou consulte o progresso dele.
O Alva Courses só envia um gatilho ao Flow enquanto um fluxo de trabalho ativado o usa, então os gatilhos que você não usa não custam nada e não enviam nada.
Encontre os IDs e os identificadores de URL dos cursos
Toda ação do Alva tem um campo Course ID or URL handle, e todo gatilho inclui Course ID para que uma condição possa selecionar um único curso. No Alva Courses, abra Configurações → Integrações → Shopify Flow: a tabela IDs de cursos para o Flow lista o ID do Flow e o identificador de URL de cada curso, com botões para copiar.
O mesmo ID do Flow aparece na aba Configurações de cada curso, abaixo da URL do curso. O identificador de URL é a parte do link do curso que vem depois de /apps/alva/courses/. Se você alterar a URL de um curso mais tarde, os fluxos de trabalho que usam o identificador antigo continuam funcionando.
Crie seu primeiro fluxo de trabalho
1. Abra o Shopify Flow
No Alva Courses, abra Configurações → Integrações → Shopify Flow e clique em Abrir o Shopify Flow, ou abra o Flow em Apps no admin do Shopify. Clique em Criar fluxo de trabalho.
2. Escolha um gatilho do Alva
Clique em Selecionar um gatilho, escolha Alva Courses e selecione o evento que deve iniciar o fluxo de trabalho, como Course completed. A referência de gatilhos mostra o que cada um envia.
3. Limite a um curso (opcional)
Todo gatilho do Alva é disparado para todos os seus cursos. Para agir em um único curso, adicione uma Condição em que Course ID seja igual ao ID do Flow desse curso.
4. Adicione uma ação
Adicione qualquer ação do Flow, como Adicionar tags de cliente ou Enviar e-mail interno, ou uma ação do Alva Courses, como Enroll customer in course. Em uma ação do Alva, cole o ID do Flow ou o identificador de URL do curso em Course ID or URL handle. A referência de ações explica cada uma.
5. Ative e confira
Ative o fluxo de trabalho. De volta ao Alva Courses, o gatilho dele aparece como Em uso, e Atividade do Flow lista cada gatilho que o Alva envia e cada ação que ele executa, com o respectivo status.
Todos os gatilhos
O Alva Courses envia 12 gatilhos. Cada um inclui o aluno e o curso, e os eventos de aula também incluem a aula. A referência de gatilhos lista todos os campos que cada gatilho leva.
| Gatilho | Quando é disparado |
|---|---|
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. |
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. |
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. |
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. |
Course lesson comment posted |
Um aluno publicou um comentário ou uma resposta em uma aula de um curso do Alva. |
Course coursework submitted |
Um aluno enviou o trabalho do curso para avaliação em um curso do Alva. |
Course coursework evaluated |
Você avaliou o trabalho de um aluno em um curso do Alva, como aprovado ou como pedido de revisão. |
Course certificate issued |
Um certificado de curso do Alva foi enviado por e-mail a um aluno. |
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. |
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. |
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. |
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. |
Todas as ações
O Alva Courses adiciona 7 ações. Cada uma precisa de um cliente, então use-as depois de um gatilho que forneça um. A referência de ações cobre os campos, as regras e as mensagens que o Flow mostra quando uma etapa é executada.
| Ação | O que faz |
|---|---|
Enroll customer in course |
Dá a um cliente acesso a um curso do Alva. |
Revoke course access |
Remove o acesso de um cliente a um curso do Alva. O progresso, as tentativas de quiz e os trabalhos dele são mantidos. |
Extend or set course access |
Altera quando o acesso de um cliente a um curso do Alva expira. Preencha exatamente uma das três opções. |
Resend course access email |
Envia por e-mail a um cliente o link de um curso do Alva em que ele está matriculado. |
Send course certificate |
Envia por e-mail a um cliente o certificado de um curso do Alva que ele concluiu. Não faz nada se o certificado já tiver sido enviado. |
Reset course progress |
Redefine o progresso de um cliente em um curso do Alva. Isso exclui permanentemente as aulas concluídas, as tentativas de quiz e as avaliações de trabalhos dele. |
Get course progress |
Consulta o progresso de um cliente em um curso do Alva, para usar em etapas posteriores. |
O que saber antes de depender de um fluxo de trabalho
O Alva Courses só envia um gatilho quando algo realmente muda, e alguns eventos se comportam de um jeito que vale a pena levar em conta no planejamento.
- Um gatilho por mudança real. Reabrir uma aula concluída, repetir uma solicitação ou matricular alguém que já está matriculado não envia nada.
- Cursos com avaliação. Em um curso que exige avaliação,
Course completedé disparado quando você aprova o trabalho do aluno, não quando ele termina a última aula. - Conclusão repetida.
Course lesson completedsó é disparado de novo se o progresso de um aluno tiver sido redefinido e ele concluir a aula outra vez; nesse caso,Repeat completioné verdadeiro. Adicione uma condição para que ele seja falso se quiser recompensar cada aula uma única vez. - Sem ordem garantida. Dois gatilhos do mesmo momento, como a última aula e a conclusão do curso, podem chegar ao Flow em qualquer ordem. Não monte um fluxo de trabalho que dependa de um deles chegar primeiro.
- Raramente, duas vezes. Se um servidor reiniciar exatamente no momento errado, o Flow pode receber o mesmo gatilho duas vezes. Prefira etapas que não causam problemas se forem repetidas, como adicionar uma tag.
- Lembretes de expiração.
Course access expiring sooné disparado 14, 7, 3 e 1 dia antes do fim do acesso. O Alva Courses verifica a cada hora e envia apenas o mais próximo dos marcos já atingidos, então um aluno matriculado com 5 dias restantes recebe o lembrete de 7 dias, nunca o de 14 e o de 7 ao mesmo tempo. - Nem toda mudança é um evento. Remover uma tag de membro não dispara
Course access removed, porque o acesso por tag é verificado quando o aluno abre o curso. Excluir um curso, desinstalar o Alva Courses e solicitações de exclusão de dados de clientes não disparam nada. - Fluxos de trabalho novos começam do zero. O Alva Courses começa a enviar um gatilho cerca de um minuto depois que você ativa um fluxo de trabalho que o usa. Eventos anteriores não são enviados depois, e
Course access expiredignora prazos que passaram há mais de 48 horas. - Automações de marketing. Todo gatilho do Alva inclui o aluno como cliente, então o Shopify também oferece os gatilhos do Alva quando você cria automações de marketing no Shopify Messaging, antigo Shopify Email. E-mails de marketing só chegam a clientes que aceitaram receber marketing por e-mail.
- Nomes em inglês. O Shopify Flow mostra os nomes de gatilhos, ações e campos do Alva apenas em inglês, seja qual for o idioma do seu admin.
Restaurar o acesso que um fluxo de trabalho revogou
Revoke course access mantém o progresso, as tentativas de quiz e os trabalhos do aluno, para que o acesso possa ser devolvido. No Alva Courses, abra Membros e selecione o aluno. O curso mostra Revogado pelo Shopify Flow com um botão Restaurar acesso; confirme, e o aluno poderá abrir o curso de novo com o progresso intacto.
A automação nunca desfaz uma revogação: Enroll customer in course recusa um aluno revogado. O acesso removido após um reembolso não tem o botão Restaurar acesso, porque uma nova compra o restaura. Se o fluxo de trabalho que revogou o acesso for executado de novo, ele poderá revogá-lo outra vez.
Verifique se um fluxo de trabalho está funcionando
No Alva Courses, Configurações → Integrações → Shopify Flow marca como Em uso cada gatilho que um fluxo de trabalho ativado usa. Atividade do Flow lista os 25 gatilhos mais recentes que o Alva enviou e as 25 ações mais recentes que ele executou, com o status e qualquer erro. No Shopify Flow, as execuções recentes de cada fluxo de trabalho mostram a mensagem que o Alva Courses retornou para cada etapa de ação.
Perguntas frequentes
Não. O Alva Courses inclui os gatilhos e as ações do Shopify Flow nos dois planos, Unlimited e Unlimited Pro, sem custo extra, e o próprio Shopify Flow é um app gratuito da Shopify. Os apps que você conecta dentro de um fluxo de trabalho, como um app de fidelidade ou de e-mail marketing, mantêm os próprios preços.
Sim. Todo gatilho do Alva Courses é disparado para todos os seus cursos e inclui um campo Course ID. Adicione uma condição em que Course ID seja igual ao ID do Flow do curso, que você pode copiar em Configurações → Integrações → Shopify Flow no Alva Courses ou na aba Configurações do curso.
Não. O Alva Courses só envia um gatilho para eventos que acontecem enquanto um fluxo de trabalho ativado o usa, a partir de cerca de um minuto depois da ativação. Matrículas, conclusões e resultados de quiz anteriores não são reenviados ao Shopify Flow.
Ele é mantido. A ação Revoke course access mantém as aulas concluídas, as tentativas de quiz e os trabalhos. Restaure o acesso na página do aluno em Membros no Alva Courses, e ele continua de onde parou. Só a ação Reset course progress exclui o progresso.
No Alva Courses, abra Configurações → Integrações → Shopify Flow. Um gatilho usado por um fluxo de trabalho ativado aparece como Em uso, e Atividade do Flow lista os gatilhos mais recentes que o Alva enviou e as ações que ele executou, com qualquer erro. No Shopify Flow, as execuções recentes de cada fluxo de trabalho mostram a mensagem que o Alva Courses retornou para cada etapa de ação.
Veja também
Isso foi útil?
Última atualização em 2026-10-01