MyOwnConference
Serviço online que permite realizar webinars interativos, seminários e videoconferências
Como configurar a conexão
Primeiro, você precisa obter a chave da API. Você pode encontrá-la na Perfil seção na sua conta pessoal no MyOwnConference
Depois de copiar a chave, abra Configurações -> Constantes do projeto no Salebot e cole-a na variável myownconference_api_key:
Cada função retorna um dicionário que tem um parâmetro status; seu valor pode ser 0 ou 1.
Se status=1, então a solicitação no MyOwnConference foi realizada com sucesso e o parâmetro resultado conterá o resultado da solicitação, como:
{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}
ou a solicitação foi realizada com sucesso, mas nada foi encontrado:
{'status': '1', 'result': []}
Se status=0, então há um problema e a descrição ficará em error, como:
{"status":"0","error":"Webinar with alias "wenk-gjkc-teqp-nteh" not active"} {'status': '0', 'error': 'Missing required variables - email'}
Como pesquisar webinars
A função myownconference_find_webinars(date, status) é usado para pesquisar webinars, onde
date - a data no formato dd.mm.aaaa - para escolher webinars de uma data específica status - valor 1 - webinars ativos ou futuros, 0 - encerrados
myownconference_find_webinars() - retorna o array de todos os webinars encontrados
A função retorna um dicionário deste tipo:
Se tiver sucesso (exemplo):
{'status': '1', 'result': [{'name': 'Super web', 'alias': 'csml-sjgf-cnjp-clkw', 'start': '2022-02-12 00:00:00'}]}
Se não tiver sucesso (exemplo):
{"status":"0","error":"Format not supported or date is not valid. Params must be yyyy-mm-dd"}
Como verificar se um usuário está presente em um webinar ativo
A função myownconference_is_online_user(webinar_id, email), em que:
webinar_id - o id do webinar ou, em outras palavras, o valor “alias” da solicitação ao pesquisar o webinar email - o endereço de e-mail do usuário; se não for compartilhado, então será usado o e-mail da variável email, se houver
O resultado se a função for bem-sucedida:
{"status":"1","result":true} - o usuário está presente neste momento no webinar {"status":"1","result":false} - o usuário não está presente
O resultado se houver um erro na solicitação:
{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}
Como obter dados do histórico do usuário
A função myownconference_history_user(webinar_id, email), onde
webinar_id - o id do webinar ou, em outras palavras, o valor “alias” da solicitação ao pesquisar o webinar email - o endereço de e-mail do usuário; se não for compartilhado, então será usado o e-mail da variável email, se houver
O resultado se for bem-sucedido:
No parâmetro result haverá um array com os dados do usuário
{'status': '1', 'result': ['John Smith', '[email protected]', 'ua', '12:02:45', '12:12:15', 'G', '28%']} {"status":"1","result":false} - o usuário não foi encontrado
Em caso de falha:
{'status': '0', 'error': 'Missing required variables - email'} - o e-mail não foi compartilhado e não foi encontrado na variável email
Um exemplo da solicitação e da obtenção do nome do usuário:
Como verificar se um usuário está na lista de todos os participantes
A função myownconference_is_our_user(email), em que:
email - o endereço de e-mail do usuário; se não for compartilhado, então será usado o e-mail da variável email, se houver
O resultado se for bem-sucedido:
{"status":"1","result":true} - o usuário está no seu banco de dados {"status":"1","result":false} - não existe tal usuário no seu banco de dados
Se não tiver sucesso:
{'status': '0', 'error': 'Missing required variables - email'} - o e-mail não foi compartilhado e não foi encontrado na variável email
Como criar um participante
Esta função adiciona um participante de webinar à lista de todos os usuários. Após a criação bem-sucedida, esse usuário pode ser registrado em um webinar (mais sobre isso abaixo)
A função myownconference_add_user(email), em que:
email - o endereço de e-mail do usuário; se não for compartilhado, então será usado o e-mail da variável email, se houver
O resultado se for bem-sucedido:
{"status":"1","result":true} - o usuário foi adicionado à sua lista de todos os participantes
Se não tiver sucesso:
{'status': '0', 'error': 'Missing required variables - email'} - o e-mail não foi compartilhado e não foi encontrado na variável email.
Como registrar um participante em um webinar
É obrigatório pedir ao cliente o e-mail para que o cadastro aconteça. Todo o resto é opcional.
A função myownconference_add_user_to_webinar(webinar_id, email), onde
webinar_id - o id do webinar ou, em outras palavras, o valor “alias” da solicitação ao pesquisar o webinar email - o endereço de e-mail do usuário; se não for compartilhado, então será usado o e-mail da variável email, se houver
O resultado se for bem-sucedido:
{"status":"1","result":true} - o usuário foi registrado no webinar
Se não tiver sucesso:
{"status":"0","error":"Webinar with alias "serg-dhpq-mznf-fwcb" not active"}
Atualizado