Como configurar o WebinarGeek

Para obter o token, vá para as configurações da conta no WebinarGeek. Você pode encontrá-lo no canto superior direito da tela e, após pressionar a palavra Conta, o menu suspenso se abre, onde você precisa escolher a primeira opção:

Em seguida, escolha API no menu à esquerda

Depois disso, a página com a API será aberta

Se você não recebeu a chave, entre em contato com o suporte ao cliente e solicite uma.

Após obter o token, abra Configurações -> Constantes do projeto e cole-o na variável webinargeek_token:

Como obter a lista de webinars através do chat-bot

Para obter a lista, basta chamar a função webinargeek_get_webinar_list():

Como resultado, haverá uma lista de webinars neste formato:

['{"id":1455034,"date":"11-05-2022 18:00","name":"Second webinar"}',
'{"id":1455046,"date":"11-05-2022 18:00","name":"My Webinar"}',
'{"id":1453081,"date":"04-05-2022 18:00","name":"My first webinar"}']

onde

id - é o id da transmissão (broadcast_id), o valor é essencial para todas as outras ações com este
data do webinar - a data e hora desta transmissão
nome - o nome do webinar

Se você compartilhar qualquer símbolo com a função (o melhor é colar '1'), a função mostrará apenas os webinars que ainda não terminaram, e se você não colar nada, ela também mostrará os que já terminaram.

Como se inscrever em um webinar através do chat-bot

Para a inscrição, você precisa da função webinargeek_get_webinar_list(broadcast_id, name, email), onde

broadcast_id - o id da transmissão para a qual você precisa inscrever o cliente
name - o nome do cliente que será exibido no chat
email - o endereço de e-mail para o qual o convite para o webinar com o link será enviado

Sem esses parâmetros, você não pode inscrever um cliente através do bot.

Exemplo:
url = webinargeek_add_subscriber(1455046, 'John Smith', '[email protected]')

Como resultado, esta variável conterá o link para o webinar através do qual o usuário não precisará se inscrever. Todos os dados do usuário são definidos nesta variável.

Além disso, após a execução da função, duas variáveis serão adicionadas ao cartão do cliente:

webinargeek_broadcast_id - o id da transmissão para a qual o usuário foi inscrito
webinargeek_email - o e-mail que foi especificado na inscrição

Essas variáveis serão úteis para verificar a presença do usuário no webinar.

Como verificar a presença no webinar através do chat-bot

Para verificar a presença, você precisará desta função webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email), onde

webinargeek_broadcast_id - o id da transmissão para a qual o usuário foi inscrito
webinargeek_email - o e-mail que foi especificado na inscrição
watch_minimum - (parâmetro opcional) a quantidade mínima de minutos pela qual a função identifica se a presença é contada ou não

watch = webinargeek_is_visitor(webinargeek_broadcast_id, webinargeek_email)

Uma resposta será colada na variável:

  • Se o webinar ainda não terminou, este texto vem como resposta: "Webinar not ended yet";
  • Se o cliente não assistiu ao webinar, então vem como resposta: "False";
  • Se o cliente assistiu ao webinar e o parâmetro watch_minimum não foi usado, então vem como resposta: "True";
    Se o parâmetro watch_minimum foi usado, a função verificará o tempo que o cliente assistiu e:
    • Se o cliente assistiu por um tempo menor do que o definido como mínimo, vem como resposta: "False";
    • Se o tempo que o cliente assistiu ao webinar for igual ou superior ao valor especificado, então vem como resposta: "True".

Como obter o broadcast_id pelo nome do webinar a partir de uma data e hora especificadas

Para obter o broadcast_id de um webinar específico, você precisa da função webinargeek_search_broadcast_id() com estes parâmetros:

webinar_list - aqui você precisa transferir a variável que contém o resultado da função webinargeek_get_webinar_list()
webinar_name - o nome do webinar cujo broadcast_id você precisa encontrar
webinar_date - a data da transmissão no formato dd.mm.yyyy. Você também pode usar curret_date
webinar_time - a hora da transmissão no formato hh:mm, onde hh = horas e mm = minutos

Exemplo:
webinar_list = webinargeek_get_webinar_list()
broadcast_id = webinargeek_search_broadcast_id(webinar_list, 'Second webinar', current_date-4, '18:00'

Aqui estamos tentando encontrar o id da transmissão que estava ocorrendo 4 dias antes da data atual às 18h e se chamava "Second webinar".

Se o webinar que corresponde aos parâmetros estava na lista, a função retorna o id do webinar encontrado para a variável broadcast_id.

Se tal webinar não foi encontrado, este texto é colado em seu lugar: "No webinar with these parameters".