Registro no curso
register_customer_on_course(tariff_id, email, email_notification, period, reregistration)
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, os e-mails do cliente não serão recebidos!
Como posso conceder acesso ao curso através do Web App do Telegram?
Para isso, especifique a função no Bloco Calculadora
access_course_from_webapp(text, button_label)
Ao usar a função, o aluno faz login no Telegram e obtém acesso ao curso. Para continuar o treinamento, o aluno não precisa inserir 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 APENAS para trabalhar com um bot do Telegram.
A captura de tela abaixo mostra um exemplo de uso da função.
Na primeira etapa, registramos o cliente no curso, 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/taxas 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 através 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)
| Parâmetros obrigatórios | Parâmetros opcionais |
|---|---|
| ! 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 seu registro 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 para a validade do plano de preços. Os formatos de data suportados são: %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, **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á escrita 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 - Plano de preços 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)
| Parâmetros obrigatórios | Parâmetros opcionais |
|---|---|
| ! 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á inscrito 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)
| Parâmetros da Função | Descrição |
|---|---|
| o endereço de e-mail do cliente. |
Você pode especificar uma variável em uma função ou valores de parâmetros. Para especificar uma variável, escreva seu nome, sem aspas e marcas de sintaxe, grades e chaves. Para especificar um valor específico, insira 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 pela função e parâmetro entre parênteses.
Após a execução bem-sucedida da função, a resposta será escrita 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:
| Parâmetro obrigatório | Parâmetro opcional |
|---|---|
| ! 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á inscrito e há um limite de tempo no acesso: Tem acesso até 2023-09-28 22:00:00
- o aluno está inscrito, não há restrições: Tem acesso sem limite de tempo
- o aluno não está inscrito: 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)
| Parâmetros | Descrição |
|---|---|
| ! 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() e access_course_from_webapp()
Para verificar se um aluno participou ou não do webinar, especifique a função no Bloco Calculadora customer_was_on_translation(translation_guid, email, after_start_time)
| Parâmetros obrigatórios | Parâmetro opcional |
|---|---|
| ! 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 - a hora de início da transmissão no formato: '2023-04-18 13:30:00'. |
| ! email - Endereço de e-mail do aluno |
Preste atenção! O nome da variável pode ser qualquer nome que seja conveniente e compreensível para você. Em caso de erro na escrita dos parâmetros da função, uma mensagem será escrita na variável: wrong translation_guid
Neste caso, recomendamos verificar os parâmetros da função e testá-los novamente. Para obter o valor do tempo de permanência no webinar de uma variável na Calculadora, você pode usar a função de trabalhar com arrays e dicionários. link/link arrays e 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?
Existem 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 através de um bot. Para emitir corretamente certificados de conclusão do curso com nome 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 o aluno inseriu durante o registro no curso, ou o nome do aluno de sua conta pessoal.