memberkit.markdown

Memberkit API

hey, não esqueça de enviar sua api_key em todas as chamadas de requisição. Em alguns endpoints, limitamos para 50 registros máximos retornados. A paginação pode ser feita pelo parâmetro page.

O endereço de origem é https://memberkit.com.br para todos endpoints abaixo.

• GET /api/v1/courses

  Lista todos os cursos cadastrados.

• GET /api/v1/courses/:id

  Retorna dados básicos do curso, lista de módulos e respectivas aulas.

• GET /api/v1/courses/:course_id/lessons/:id

  Retorna conteúdo da aula, meta dados do vídeo e materiais complementares.

• GET /api/v1/membership_levels

  Lista todas as assinaturas ativas na área de membros.

• GET /api/v1/classrooms

  Lista todas as turmas ativas na área de membros.

• GET /api/v1/classrooms/:id

  Retorna dados sobre uma turma específica.

• GET /api/v1/rankings

  Lista os membros e respectivas pontuações acumuladas no ranking.

  Parâmetros

  Parâmetro	Descrição
  classroom_id	Filtragem por turma.

• GET /api/v1/users

  Lista todos os membros cadastrados na plataforma.

• GET /api/v1/users/:email

  Retorna dados básicos do membro, lista de cursos matriculados, assinaturas e nível de acesso ilimitado.

• PUT /api/v1/users/:email

  Atualiza dados básicos do membro. Os parâmetros permitidos são: full_name, email, bio, unlimited e blocked.

• GET /api/v1/users/:email/rankings

  Lista as pontuações de um membro específico.

• DELETE /api/v1/users/:email

  Remove membro cadastrado.

• POST /api/v1/users

  Cadastra ou atualiza membro.

  Parâmetros

  Importante: Há três níveis de acesso na Memberkit: matrículas individuais, acesso ilimitado ou assinatura. Ao enviar sua requisição, use apenas uma modalidade de inscrição usando o parâmetro classroom_ids, unlimited ou membership_level_id.

  Parâmetro	Descrição
  full_name	Nome completo do aluno
  email	Endereço de email do aluno
  status	Use inactive, pending, active, ou expired.
  blocked	Bloqueio global de acesso na área de membros, sendo true ou false
  classroom_ids	IDs de turmas separado por vírgula
  unlimited	Acesso ilimitado, sendo true ou false
  membership_level_id	Código de assinatura
  expires_at	Data de expiração da matricula (ex: 13/12/2020)

• POST /api/v1/scores

  Adiciona uma nova pontuação.

  Parâmetros

  Parâmetro	Descrição
  user_email	Email do aluno
  reason	Motivo da pontuação (ex: Postagem no instagram)
  value	Quantidade de pontos adicionados
  course_id	ID do curso

• DELETE /api/v1/scores

  Desfaz pontuação.

  Parâmetros

  Parâmetro	Descrição
  user_email	Endereço de email do aluno
  reason	Texto exato da pontuação
  course_id	ID do curso

• POST /api/v1/tokens

  Gera um novo token de autenticação com duração de 1 hora.

  Parâmetros

  Parâmetro	Descrição
  email	Endereço de email do membro

@rainerborene boa tarde! O @rodrigoscdc citou sobre os percentuais de progresso do aluno dentro do curso, 25%, 50% ,100%... Consigo configurar isso via API? Porque aquelas TAG Inteligentes lotam o meu autorresponder, uma TAG por aula concluída é complicado. Obrigado!

@lucasfalalima Sim. Use o evento "Progresso concluído" e faça uma automatização de inserção de tags na sua ferramenta de e-mail marketing via Zapier ou Integromat. Não é algo trivial de ser feito, mas é possível usando os webhooks (última integração em nosso painel).

@lucasfalalima e @bekarebeka eu resolvi isso criando algumas automações com o n8n, onde ele buscava todos os dias ou a cada 2 ou 3 dias a última data de login e ai executava alguma ação, tipo taguear para comunicação.

Ok @rainerborene, obrigado pela resposta. Existe alguma expectativa desse recurso ser lançado nos eventos de Webhook? Sem precisar bypassar pela Integromat e afins.

@rodrigoscdc excelente alternativa meu caro! Obrigado por compartilhar.

@rainerborene,

O item abaixo foi liberado?

@andreladocruz Será possível cadastrar metadados anexados ao cadastro do usuário, como CPF e número de telefone. Acredito que na sexta-feira estará no ar.

@andreladocruz Feature liberada hoje, Andrézão! Na rota POST /api/v1/users pode especificar os atributos cpf_cnpj, phone_local_code e phone_number. Enquanto na rota PATCH /api/v1/users/:email deve especificá-los dentro do objeto metadata com as mesmas chaves anteriores.

Show @rainerborene !!!!!!!! =) =) só para ter certeza.... phone_local_code = código do país, correto?

@andreladocruz O phone_local_code seria o código de área do telefone. As plataformas de pagamento, normalmente, não enviam o código do país nos webhooks enviados. Mas se for realmente necessário, pode colocá-lo neste mesmo campo junto com o código de área.

@rainerborene, posso colocar o país no local_code e o telefone com o código de área no phone_number? porque senão temos que criar uma "inteligência artificial" (ifs) do lado de cá para ver se o telefone é do brasil (55) e "mover" o código de área para o local_code na integração de vocês...

@andreladocruz Fica ao seu critério. Não há um formato estrito ou validação destes dois campos. Então cabe ao cliente da Memberkit e a plataforma integrada, por exemplo, Notificações Inteligentes, lidar com a leitura e formatação dos números.

@rainerborene .... SENSACIONAL!!!! vamos colocar na lista de melhorias do lado de cá. Obrigado!!!!!

@rainerborene cpf e telefone são atributos exclusivos da API? pq não vi esses campos para inserir manualmente no cadastro dos usuários

@rainerborene , lembra de atualizar a documentação depois:

@lucianoks O problema foi devido a uma atualização feita hoje (dia 26) às 8h. Mas já foi depurado e corrigido. Obrigado pelo feedback.

@kimtiago Esses campos são metadados e não são visíveis na plataforma por enquanto. Mas já demos o start na implementação de campos customizados (sem previsão de finalização). Os dados em questão: cpf e telefone são capturados da plataforma de pagamento automaticamente. Até então esses dados não eram editáveis.

Existe a possibilidade de "clonar" uma área de membros inteira? A ideia é replicar várias áreas da memberkit para empresas terem acesso ao conteúdo.

@rainerborene como eu desativo usuários na plataforma? Tentei os alterar o status dos membros para Expirado e Desativado em suas respectivas assinaturas, mas isso não tem efeito na contagem de assinantes. Ou seja, como vejo quantos são os usuários ativos e pelos quais eu pago dentro da plataforma?

Acabei de ver que a contagem só diminui quando excluimos os membros. Eu esperava que não fossem contabilizados clientes que não tivessem acesso a nenhum curso, como se fosse uma deleção lógica, até para poder trabalhar na recuperação desse aluno posteriormente e ele voltar com a própria conta que já tinha. Pode clarificar como funciona @rainerborene ?

@renzon O status desativado ou expirado nas assinaturas ou matriculas não influenciam na contagem do aluno. Até porque podem existir mais conteúdos matriculados no perfil do aluno. Para desconsiderá-lo da contagem, você pode removê-lo da sua área de membros.

@rainerborene, é possível adicionar o campo password na hora de incluir o aluno através do POST api/v1/users?

Pergunto, pois trabalhamos com cursos gratuitos e milhares de alunos são leigos, que inclusive jamais acessar uma video aula na vida. Porém a conversão é baixa por conta de o e-mail com a senha cair muito na caixa de spam deles. A ideia seria que a senha de cada um pudesse ser o CNPJ da empresa, isso facilitaria a nossa comunicação com os milhares de alunos.

@FlipQuadros Dentro da página Configurações, você pode definir uma senha padrão para novas contas.

@FlipQuadros Dentro da página Configurações, você pode definir uma senha padrão para novas contas.

Atualmente utilizamos essa alternativa, porém a empresa tem recebido muitos relatos de vazamento de senha e acesso por terceiros à conta dos alunos. O que acabou se tornando uma alternativa insegura na nossa realidade.

Se fizer sentido para o plano de negócios da empresa, será algo que melhorará nossa relação com toda nossa carteira de alunos, do qual estamos para atingir os 50 mil, e imagino que a relação de outras empresas que são hoje também suas parceiras.

Desde já, muito obrigado. Mantenho o canal aberto e à disposição para a troca de informações.

@FlipQuadros Acabamos de implementar o parâmetro password na rota POST /api/v1/users. Para todas as novas contas de usuários, será possível definir uma senha personalizada. Ressalto que é válido apenas para novas contas de membros (ou seja, sem operação de atualização de contas existentes por enquanto).

@FlipQuadros Acabamos de implementar o parâmetro password na rota POST /api/v1/users. Para todas as novas contas de usuários, será possível definir uma senha personalizada. Ressalto que é válido apenas para novas contas de membros (ou seja, sem operação de atualização de contas existentes por enquanto).

Rainer, minha senha padrão para novos alunos não funciona mais… o que aconteceu?

@lucasfalalima Entre em contato no suporte@memberkit.com.br e mande os dados da sua área de membros e o endereço de email do aluno.

Boa tarde, Por favor, a minha área de membros foi desativada pois o cartão recusou a compra, porém agora não consigo acessar a plataforma para colocar outra forma de pagamento. Qual a alternativa? attm Em ter., 26 de jul. de 2022 às 13:40, Rainer Borene < ***@***.***> escreveu:

…

***@***.**** commented on this gist. ------------------------------ @lucasfalalima <https://github.com/lucasfalalima> Entre em contato no ***@***.*** e mande os dados da sua área de membros e o endereço de email do aluno. — Reply to this email directly, view it on GitHub <https://gist.github.com/26bc6b66bbc5dd4f78a1141df31ef718#gistcomment-4245381>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AV4PURU47A4AZWRUBGMGPMDVWAIHVANCNFSM42R7GOWQ> . You are receiving this because you were mentioned.Message ID: ***@***.***>

Ainda não consegui realizar o pagamento! Se alguémn puder me ajudar...

@PedroPimentelOficial este canal é pra tirar duvidas ou propor sugestões a respeito da API da Memberkit, para suporte você deve enviar um email para suporte@memberkit.com.br

Na página de escolha de vídeos seria muito bom poder colocar uma url do YOUTUBE e ele achar o vídeo pelo código. Estou tentando achar um vídeo que acabei de fazer upload e ele não está aparecendo como opção, e estou copiando o título do próprio YT. Já cliquei em atualizar para ele puxas os dados via API e nada. Também ajudaria se no campo de busca pudesse se colocar o id do YT. Para quem é dev, é bem mais fácil colocar o id que ficar filtrando por título.

Olá. Conseguimos atualizar via API se uma determinada aula foi concluída ou não? Irei precisar desta funcionalidade pois estou exibindo em meu site os cursos e aulas, e preciso fazer este update dinamicamente.