Ações do Shopify Flow

Como as ações do Alva se comportam

Toda ação do Alva Courses procura o curso apenas na sua própria loja, pelo ID do Flow ou pelo identificador de URL, incluindo um identificador que o curso tinha antes de você alterar a URL dele. Quando uma etapa não consegue fazer o seu trabalho, ela falha com uma mensagem que diz o motivo e o que mudar, e o Flow não tenta de novo. Quando o Alva Courses tem um problema temporário, o Flow tenta a etapa de novo automaticamente por até 36 horas.

Uma etapa que não encontra nada a fazer é concluída com sucesso e informa isso, como ao matricular alguém que já está matriculado. Se o Flow entregar a mesma execução duas vezes, o Alva Courses a reconhece e não repete o trabalho. A única exceção é rara: se o Alva não conseguiu registrar uma execução concluída e o Flow nunca recebeu a resposta, Extend access by this many days ou Resend course access email podem ser aplicados duas vezes.

Mensagens que mais de uma ação pode mostrar:

No course with ID or handle '…' in this store. O campo Course não corresponde a nenhum curso desta loja. Copie o ID ou o identificador de novo em Configurações → Integrações → Shopify Flow.
Enter a course ID or URL handle in the Course field. Find them in Alva Courses → Settings → Integrations → Shopify Flow. O campo Course está vazio, ou uma variável usada nele ficou vazia.
This action needs a customer. Use it after a trigger or step that provides one. O fluxo de trabalho não tem um cliente neste ponto.
This customer isn't enrolled in "…". Use Enroll customer in course first. A ação precisa de uma matrícula existente.
Alva Courses hit a temporary error. Shopify Flow will retry this action automatically. Não há nada a fazer: o Flow tenta de novo.
Too many Alva Courses actions are running for this store at once. Shopify Flow will retry. Um fluxo de trabalho iniciou muitas execuções ao mesmo tempo; o Flow as distribui ao longo do tempo.
Already processed O Flow enviou uma execução que já tinha terminado, então nada foi feito duas vezes.

Ações de matrícula e acesso

Estas ações concedem, retiram e ajustam o acesso aos cursos. Combine-as com gatilhos do Shopify, como a adição de uma tag de cliente ou o pagamento de um pedido, para gerenciar programas de membros, turmas e promoções sem mexer em cada aluno manualmente.

`Enroll customer in course`

Dá a um cliente acesso a um curso do Alva.

Campo	Tipo	Obrigatório	Observações
Cliente	Cliente do Shopify	Obrigatório	Preenchido pelo Flow a partir do gatilho, ou de uma etapa anterior que forneça um cliente.
`Course ID or URL handle`	Texto	Obrigatório	Encontre-o em Alva Courses → Configurações → Integrações → Shopify Flow.
`Access length in days`	Número inteiro	Opcional	Deixe em branco para usar a configuração de acesso do próprio curso.
`Send the course access email`	Caixa de seleção	Opcional	—

Matricula o cliente no curso e o adiciona como membro no Alva Courses se ele for novo; ele já precisa ser cliente da sua loja Shopify. Deixe Access length in days em branco para usar a configuração de acesso do próprio curso, ou informe de 1 a 36.500 dias. Cursos gratuitos sempre têm acesso ilimitado. A nova matrícula dispara Course enrollment created com Enrollment source definido como flow.

Marque Send the course access email para enviar o link ao aluno por e-mail. Se o e-mail não puder ser enviado, a matrícula continua valendo e a mensagem da etapa informa que o e-mail não foi enviado. Um aluno cujo acesso foi revogado nunca é matriculado de novo pela automação.

Enrolled in "…". Concluído. A mensagem também informa se o e-mail de acesso ao curso foi enviado.
Already enrolled in "…". Nada mudou. Se o acesso dele tiver acabado, a mensagem informa isso; use Extend or set course access para estendê-lo.
This customer's access to "…" was revoked by a Flow action. Restore it from the customer's member page in Alva Courses. Veja restaurar o acesso que um fluxo de trabalho revogou.
This customer's access to "…" was revoked after a refund; automation won't restore it. Um curso reembolsado volta com uma nova compra.
No Shopify customer with ID … in this store. O cliente foi excluído, ou o ID veio de outra loja.
Access length in days must be between 1 and 36,500 days. Deixe o campo em branco para usar a configuração do próprio curso.

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

Campo	Tipo	Obrigatório	Observações
Cliente	Cliente do Shopify	Obrigatório	Preenchido pelo Flow a partir do gatilho, ou de uma etapa anterior que forneça um cliente.
`Course ID or URL handle`	Texto	Obrigatório	Encontre-o em Alva Courses → Configurações → Integrações → Shopify Flow.

Remove o acesso do cliente sem excluir nada: as aulas concluídas, as tentativas de quiz e os trabalhos são mantidos. O Alva Courses também remove do cliente as tags de progresso do curso, se você as usa, e dispara Course access removed com Reason revoked by flow. Para devolver o acesso, use Restaurar acesso na página do aluno em Membros; veja restaurar o acesso que um fluxo de trabalho revogou.

Access to "…" revoked. Progress and coursework are kept; restore access from the customer's member page in Alva Courses. Concluído.
This customer isn't enrolled in "…"; nothing to revoke. A etapa é concluída sem alterar nada.
Access to "…" was already revoked. A etapa é concluída sem alterar nada.

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

Campo	Tipo	Obrigatório	Observações
Cliente	Cliente do Shopify	Obrigatório	Preenchido pelo Flow a partir do gatilho, ou de uma etapa anterior que forneça um cliente.
`Course ID or URL handle`	Texto	Obrigatório	Encontre-o em Alva Courses → Configurações → Integrações → Shopify Flow.
`Extend access by this many days`	Número inteiro	Opcional	Somado à data de expiração atual, ou a hoje se o acesso já tiver expirado.
`Set the expiry date`	Texto	Opcional	YYYY-MM-DD, no fuso horário da sua loja. O acesso termina no fim desse dia.
`Give unlimited access`	Caixa de seleção	Opcional	—

Altera quando o acesso do cliente termina. Preencha exatamente uma opção. Extend access by this many days adiciona de 1 a 36.500 dias à data de expiração atual, ou a hoje se o acesso já tiver acabado. Set the expiry date encerra o acesso no fim desse dia, no fuso horário da sua loja. Give unlimited access remove a data de término.

Esta ação nunca devolve um acesso revogado. Ela também recusa uma data de expiração que o Alva Courses não aplicaria: em cursos gratuitos e em acessos que vêm de uma tag de membro. Estender um acesso ilimitado o mantém ilimitado.

Access to "…" now ends at …. Concluído. O novo término é mostrado em UTC.
Fill in exactly one option: Extend access by this many days, Set the expiry date, or Give unlimited access. Nenhuma opção foi preenchida, ou mais de uma.
Set the expiry date as YYYY-MM-DD, such as 2026-12-31 (got '…'). Digite a data exatamente nesse formato, ou verifique se a variável que você usou a produz nesse formato.
Changing the expiry date wouldn't restore access, so nothing was changed. O acesso do aluno foi revogado; a mensagem começa com o motivo.
This customer's access to "…" comes from a membership tag, which never expires. Remove the tag to end access instead.
"…" is a free course, and free courses have no access limit, so there's no expiry date to set. Nothing was changed.
Access to "…" is already unlimited; nothing to extend. A etapa é concluída sem alterar nada.

Ações de e-mail

Estas ações enviam os e-mails do próprio Alva Courses, usando os seus modelos e o seu domínio de envio. Use-as para reenviar um link de curso perdido ou para enviar um certificado quando você quiser, em vez de no instante em que um curso é concluído.

`Resend course access email`

Envia por e-mail a um cliente o link de um curso do Alva em que ele está matriculado.

Campo	Tipo	Obrigatório	Observações
Cliente	Cliente do Shopify	Obrigatório	Preenchido pelo Flow a partir do gatilho, ou de uma etapa anterior que forneça um cliente.
`Course ID or URL handle`	Texto	Obrigatório	Encontre-o em Alva Courses → Configurações → Integrações → Shopify Flow.

Envia ao cliente, por e-mail, o link de um curso em que ele está matriculado, usando o seu modelo de e-mail de acesso ao curso. Para proteger os alunos de um fluxo de trabalho que entra em loop, o Alva Courses o envia no máximo 3 vezes por cliente, por curso, em qualquer período de uma hora. As execuções seguintes esperam, e o Flow tenta de novo quando o limite da hora permitir.

Course access email for "…" sent. Concluído.
The course access email for "…" was already sent 3 times to this customer in the last hour. Shopify Flow will retry later. A etapa espera e tenta de novo sozinha.
Course emails are turned off for this store. Turn them on in Alva Courses → Settings → Emails, then run the workflow again.
This customer has no email address in Alva Courses, so no email was sent.
The course access email couldn't be sent. Check that the course access email template is turned on in Alva Courses and the customer's email address is valid.

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

Campo	Tipo	Obrigatório	Observações
Cliente	Cliente do Shopify	Obrigatório	Preenchido pelo Flow a partir do gatilho, ou de uma etapa anterior que forneça um cliente.
`Course ID or URL handle`	Texto	Obrigatório	Encontre-o em Alva Courses → Configurações → Integrações → Shopify Flow.

Envia ao cliente, por e-mail, o certificado de um curso que ele concluiu. Se o certificado já tiver sido enviado, automaticamente ou por uma execução anterior, a etapa é concluída sem enviá-lo de novo. Um certificado enviado por esta ação dispara Course certificate issued. Alunos cujo acesso foi revogado não recebem certificado.

Certificate for "…" sent. Concluído.
Already sent on …. A etapa é concluída; nada é enviado duas vezes.
This customer hasn't completed "…" yet, so no certificate was sent.
Certificates are turned off for "…". Turn them on in the course settings in Alva Courses.
"…" requires a passing evaluation before a certificate is issued, and this customer doesn't have one yet.
Certificate emails are turned off for this store. Turn them on in Alva Courses → Certificates, then run the workflow again.
No certificate design is set up for this store. Set one up in Alva Courses → Certificates, then run the workflow again.
This customer has no valid email address in Alva Courses, so no certificate was sent.

Ações de progresso

Estas ações leem ou apagam o progresso de um aluno. Get course progress é a base para lembretes e relatórios; Reset course progress serve para refazer cursos e renovar certificações, e não pode ser desfeita.

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

Campo	Tipo	Obrigatório	Observações
Cliente	Cliente do Shopify	Obrigatório	Preenchido pelo Flow a partir do gatilho, ou de uma etapa anterior que forneça um cliente.
`Course ID or URL handle`	Texto	Obrigatório	Encontre-o em Alva Courses → Configurações → Integrações → Shopify Flow.
`I understand this permanently deletes progress`	Caixa de seleção	Obrigatório	Precisa estar marcada; caso contrário, a ação não faz nada e informa um erro.

O aluno recomeça o curso do início. O acesso, a compra, a matrícula, as anotações de reflexão e os comentários dele são mantidos. A etapa não faz nada a menos que I understand this permanently deletes progress esteja marcada. Cada redefinição aparece no cartão Redefinições de progresso da página de membro do aluno, como feita pela equipe da loja.

Como a redefinição apaga a conclusão, terminar o curso de novo dispara Course completed outra vez e envia um novo certificado, se o curso conceder um. Cada aula concluída de novo dispara Course lesson completed com Repeat completion definido como verdadeiro.

Progress in "…" reset. Completed lessons, quiz attempts and evaluations were deleted; access is unchanged. Concluído.
Tick “I understand this permanently deletes progress” in this step to reset progress. Nothing was changed.

`Get course progress`

Consulta o progresso de um cliente em um curso do Alva, para usar em etapas posteriores.

Campo	Tipo	Obrigatório	Observações
Cliente	Cliente do Shopify	Obrigatório	Preenchido pelo Flow a partir do gatilho, ou de uma etapa anterior que forneça um cliente.
`Course ID or URL handle`	Texto	Obrigatório	Encontre-o em Alva Courses → Configurações → Integrações → Shopify Flow.

Ela retorna estes valores, que as etapas seguintes do mesmo fluxo de trabalho podem usar:

Valor	Tipo	Significado
`enrolled`	Verdadeiro ou falso	Se o cliente está matriculado e não foi revogado
`percentComplete`	Número	Porcentagem das aulas publicadas que foram concluídas
`completed`	Verdadeiro ou falso	Se o curso foi concluído
`lessonsCompleted`	Número inteiro	Aulas concluídas
`accessExpiresAt`	Texto	Expiração do acesso, em ISO 8601; vazio quando ilimitado

Consulta o progresso do cliente sem alterar nada, para que uma condição posterior possa se ramificar com base nele: por exemplo, espere 7 dias após a matrícula e envie um e-mail aos alunos cujo percentComplete esteja abaixo de 10. Veja incentivar alunos que ainda não começaram um curso.

Um cliente que não está matriculado retorna enrolled falso e zeros, assim como um cliente que o Alva Courses ainda não conhece. Um aluno cujo acesso foi revogado retorna enrolled falso com o progresso que tinha. percentComplete e lessonsCompleted contam só as aulas publicadas no curso, não os rascunhos.

Enrolled; 40% of "…" complete. Concluído; os valores estão prontos para as etapas seguintes.
Access revoked; 40% of "…" complete. Concluído; enrolled é falso.
Not enrolled in "…". Concluído; enrolled é falso e os números são 0.

Veja também

Shopify Flow

Isso foi útil?

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

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