Funções da calculadora para cursos
Inscrição para o curso
register_customer_on_course(tariff_id, email, email_notification, period, reregistration)
! tariff_id
parâmetro obrigatório, o ID do plano de preços. Você pode copiá-lo na linha do navegador nas configurações do plano de preços.
parâmetro obrigatório, o endereço de e-mail do cliente. Você pode especificar um valor específico ou uma variável na qual o e-mail do cliente está registrado.
email_notification
parâmetro opcional, envia ao aluno uma mensagem de e-mail sobre sua inscrição no curso, se estiver ativado.
period
parâmetro opcional, limite de tempo para a validade do plano de preços. Os formatos de data suportados são os seguintes: %d.%m.%Y %H:%M ou %d.%m.%Y Exemplo:
period = '15.08.2023 11:00'
reregistration
parâmetro opcional, com valores True ou False. Este parâmetro é opcional e é especificado se você precisar matricular os alunos novamente no mesmo curso e plano de preços.
purchase_price
parâmetro opcional. Permite especificar o custo do curso se o cliente pagou pelo acesso a ele por meio de um bot. Se você não o especificar, será usado o custo do plano de preços especificado. Isso será útil se o cliente pagar pelo acesso ao curso por meio do bot por um preço diferente do custo do plano de preços especificado.
Exemplo: register_customer_on_course(123, email, 1, "", True)
Para que os clientes recebam e-mails, passe 1 para o parâmetro email_notification.
Se você não enviar 1, então os e-mails do cliente não serão recebidos!
Como posso conceder acesso ao curso por meio do Telegram Web App?
Para isso, especifique a função no Bloco Calculadora
access_course_from_webapp(text, button_label)
Durante o uso da função, o aluno faz login no Telegram e obtém acesso ao curso. Para continuar o treinamento, o aluno não precisa digitar nome de usuário e senha, pois a autorização já foi concluída.
Parâmetros da função:
text - é o texto da mensagem que o cliente receberá. O parâmetro pode ser especificado em uma variável, escrevendo-o no campo da Calculadora antes de acessar a função, ou especificado na própria função entre aspas.
button_label - é o texto no botão do Web App. Você pode especificar o parâmetro em uma variável ou na própria função. No segundo caso, o parâmetro é escrito entre aspas.
É relevante SOMENTE para trabalhar com um bot do Telegram.
A captura de tela abaixo mostra um exemplo de uso da função.
Na primeira etapa, matriculamos o cliente no curso e depois usamos a função access_course_com_webapp para fornecer acesso ao produto online.
O resultado da execução da função:
Este botão abre uma página com os cursos/planos que o aluno possui.
Se o cliente não estiver associado à conta do aluno, a função retorna 'cliente não vinculado ao cliente'.
Para criar essa conexão, basta se inscrever em um curso por meio de um bot.
Como conceder acesso ao curso via bot
register_customer_on_course()
Para isso, especifique a função no Bloco Calculadora
register_customer_on_course(tariff_id, email, email_notification, period)
! tariff_id - o ID do plano de preços. Você pode copiá-lo na linha do navegador nas configurações do plano de preços.
email_notification - Este parâmetro envia ao aluno uma mensagem de e-mail sobre sua inscrição no curso, se estiver ativado.
! email - o endereço de e-mail do cliente. Você pode especificar um valor específico ou uma variável na qual o e-mail do cliente está registrado.
period - limite de tempo de validade do plano de preços. Os formatos de data suportados são os seguintes: %d.%m.%Y %H:%M ou %d.%m.%Y Exemplo:
period = '15.08.2023 11:00'
Para que os clientes recebam e-mails, você deve passar 1 no parâmetro email_notification.
Se você não enviar 1, então os e-mails do cliente não serão recebidos!
Atribua uma função à variável.
Após a execução, uma das respostas será gravada na variável:
customer is already on tariff - se houver um plano de preços ou o acesso estiver fechado manualmente
wrong_tariff_id - id inválido especificado
tariff_added - O plano de preços foi adicionado ao aluno
Exemplo:
Como verificar a disponibilidade de acesso ao curso
has_customer_tariff(tariff_id)
Para isso, especifique a função no Bloco Calculadora has_customer_tariff(tariff_id, email)
! tariff_id - o ID do plano de preços. Você pode copiá-lo na linha do navegador nas configurações do plano de preços ou na seção Planos de preços.
email - parâmetro opcional. Passe este parâmetro para verificar se o cliente está matriculado no curso com o endereço de e-mail especificado.
Após a execução, a função retorna True ou False.
Possíveis respostas da função em caso de erros:
wrong tariff_id - valor inválido passado tariff_id
customer not found - o usuário não está registrado como aluno.
Como registrar um cliente na plataforma SEM conceder acesso ao curso
register_customer(email)
Para isso, especifique a função no Bloco Calculadora register_customer(email)
o endereço de e-mail do cliente.
Você pode especificar uma variável em uma função ou valores de parâmetro. Para especificar uma variável, escreva o nome dela, sem aspas e sem caracteres de sintaxe, grades e chaves. Para especificar um valor específico, informe o endereço de e-mail do cliente entre aspas.
Recomenda-se atribuir uma variável à função, para que você possa ver o resultado da função e trabalhar com ele. Exemplo na captura de tela abaixo: o nome da variável é definido antes do sinal de igual, seguido da função e do parâmetro entre parênteses.
Após a execução bem-sucedida da função, a resposta será gravada na variável: customer created
Como verificar o acesso ao curso e os limites de tempo?
Para isso, especifique a função no Bloco Calculadora has_customer_tariff_with_date(tariff_id, email), para verificar a disponibilidade de acesso ao curso por e-mail (retorna uma resposta detalhada sobre a disponibilidade de acesso e restrições de tempo).
Parâmetros da função:
! tariff_id - o ID do plano de preços. Você pode copiá-lo na linha do navegador nas configurações do plano de preços ou na seção Planos de preços.
email - parâmetro opcional.
A resposta será:
o aluno está matriculado e há um limite de tempo de acesso: Tem acesso até 2023-09-28 22:00:00
o aluno está matriculado, não há restrições: Tem acesso sem limite de tempo
o aluno não está matriculado: Sem acesso a esta tarifa
Possíveis respostas da função em caso de erros:
wrong tariff_id - valor inválido passado tariff_id
customer not found -o usuário não está registrado como aluno.
Como remover o acesso ao curso de um aluno via bot
del_customer_from_course(course_id, email)
Para isso, especifique a função no Bloco Calculadora del_customer_from_course(course_id, email)
! tariff_id
ID do plano de preços
endereço de e-mail do cliente
Como verificar se um aluno participou de um webinar
customer_was_on_translation()
O acesso ao curso precisa ser concedido no bot.
Existe uma função para isso register_customer_on_course() и access_course_from_webapp()
Para verificar se um aluno participou do webinar ou não, especifique a função no Bloco Calculadora customer_was_on_translation(translation_guid, email, after_start_time)
! translation_guid - o ID da transmissão. Copie o valor do campo
O nome está no link das configurações da transmissão
after_start_time - o horário de início da transmissão no formato: '2023-04-18 13:30:00'.
! email - endereço de e-mail do aluno
Atenção! O nome da variável pode ser qualquer nome que seja conveniente e compreensível para você. Em caso de erro ao escrever os parâmetros da função, será gravada na variável a mensagem: wrong translation_guid
Nesse caso, recomendamos verificar os parâmetros da função e testá-los novamente. Para obter o valor do tempo de permanência no webinar a partir de uma variável na Calculadora, você pode usar a função de trabalho com arrays e dicionários. ссылка/ссылка arrays и dicionários.
Exemplo de configurações no Bloco Calculadora:
time_spent1 = answer2[0]['time_spent']
Como encontrar o nome do aluno vinculado a um bot?
Há casos em que os alunos podem estar vinculados ao chat online da conta pessoal do aluno, bem como aqueles que estão vinculados a um mensageiro e escrevem para seus supervisores por meio de um bot. Para emitir corretamente certificados nomeados de conclusão do curso no bot e não procurar o nome do aluno na lista, existe uma função:
get_customer_name() - retorna o nome do aluno associado ao cliente.
Uma função sem parâmetros.
Retorna o nome do aluno que ele inseriu durante o cadastro no curso, ou o nome do aluno da sua conta pessoal.
Atualizado