1. Central de Ajuda | Pluga
  2. Usando a Pluga
  3. Tutoriais com o Pluga Webhooks [origem e destino dos dados]

Como integrar a Memberkit a outras ferramentas web via Pluga Webhooks

Avatar
Fátima Catarino

Integrar a Memberkit com outras ferramentas web (como Google Sheets, RD Station ou Pagar.me) via Pluga Webhooks é muito simples e você tem duas opções para fazer essas integrações! São elas:

Continue lendo o passo a passo a seguir para saber cada uma delas.

Como capturar informações da Memberkit e enviar para ferramentas já integradas na Pluga

Neste vídeo nós mostramos o passo a passo de como criar essa integração:

  1. Acesse a página de automatizações do Pluga Webhooks e escolha qual será a ferramenta que receberá os dados da Memberkit;

  2. Após escolher a automatização e clicar em "Fazer essa automatização", nomeie o Pluga Webhooks que será usado para integrar a sua conta da Memberkit. Depois clique em "Gerar URL de webhook" e copie a URL que foi gerada;

    memberkit_trigger_autenticac_a_o.gif

  3. Acesse sua área da Memberkit;

  4. Vá em "Integrações";

    mceclip0.png

  5. Na parte de integrações "Disponíveis", clique em "Webhooks";

    mceclip2.png

  6. Na tela de "Webhooks", você deve [1] colar a URL gerada na Pluga e [2] marcar o(s) evento(s) que deseja receber notificação. Por último, clique em "Salvar configuração";

    memberkit_trigger_webhook_-_mais_de_perto.gif

  7. Volte para sua automatização na Pluga, conecte a ferramenta de destino e clique em "Continuar";

    mceclip3.png

  8. Em "Modelo de envio dos dados para notificação", cole o JSON referente ao gatilho que você quer enviar para a sua ferramenta de destino. Separamos alguns exemplos que você pode usar e colar na Pluga.

    Evento: Avaliação feita

    
{
  "type": "rating.saved",
  "data": {
    "created_at": "2021-09-28T18:00:17.850-03:00",
    "id": 29226149,
    "lesson": {
      "course": {
        "category": null,
        "created_at": "2019-05-13T09:38:05.241-03:00",
        "description": ".",
        "id": 924,
        "image_url": null,
        "name": "Memberkit - Introdução",
        "page_checkout_url": "https://memberkit.com.br/",
        "position": 2,
        "updated_at": "2021-09-28T11:24:57.109-03:00"
      },
      "created_at": "2021-06-17T10:01:49.260-03:00",
      "id": 725396,
      "position": 8,
      "slug": "doce-rotina-prime",
      "title": "Doce Rotina - Prime",
      "updated_at": "2021-06-17T10:01:49.260-03:00"
    },
    "stars": 5,
    "updated_at": "2021-09-28T18:00:17.850-03:00",
    "user": {
      "created_at": "2018-12-11T17:05:47.887-02:00",
      "current_sign_in_at": "2021-09-28T17:41:21.641-03:00",
      "email": "demo@memberkit.com.br",
      "full_name": "Memberkit",
      "id": 54626,
      "profile_image_url": null,
      "sign_in_count": 1895,
      "updated_at": "2021-09-28T17:41:21.646-03:00"
    }
  }
}

    Evento: Matrícula criada

    
{
  "type":"enrollment.created",
  "data":{
    "id":37119733,
    "status":"active",
    "expire_date":null,
    "course_id":98446,
    "classroom_id":131786,
    "created_at":"2023-04-11T12:04:10.324-03:00",
    "updated_at":"2023-04-11T12:04:10.324-03:00",
    "user":{
      "id":17508993,
      "full_name":"Fatima",
      "email":"fatima.catarina@pluga.co",
      "sign_in_count":0,
      "current_sign_in_at":null,
      "profile_image_url":null,
      "created_at":"2023-04-11T12:04:10.320-03:00",
      "updated_at":"2023-04-11T12:04:10.320-03:00"
    }
  }
}

    Evento: comentário criado

    
{
  "type": "comment.created",
  "data": {
    "content": "Adorei a aula!",
    "created_at": "2021-09-28T18:03:54.336-03:00",
    "id": 5158348,
    "lesson": {
      "course": {
        "category": null,
        "created_at": "2019-05-13T09:38:05.241-03:00",
        "description": ".",
        "id": 924,
        "image_url": null,
        "name": "Memberkit - Introdução",
        "page_checkout_url": "https://memberkit.com.br/",
        "position": 2,
        "updated_at": "2021-09-28T11:24:57.109-03:00"
      },
      "created_at": "2021-06-17T10:00:15.191-03:00",
      "id": 725389,
      "position": 7,
      "slug": "doce-rotina-on-demand",
      "title": "Doce Rotina - On Demand",
      "updated_at": "2021-08-17T15:13:52.758-03:00"
    },
    "status": "approved",
    "updated_at": "2021-09-28T18:03:54.336-03:00",
    "user": {
      "created_at": "2018-12-11T17:05:47.887-02:00",
      "current_sign_in_at": "2021-09-28T17:41:21.641-03:00",
      "email": "demo@memberkit.com.br",
      "full_name": "Memberkit",
      "id": 54626,
      "profile_image_url": null,
      "sign_in_count": 1895,
      "updated_at": "2021-09-28T17:41:21.646-03:00"
    }
  }
}

    Evento: login enviado 

    
{
  "type": "login.sent",
  "data": {
    "created_at": "2018-04-26T13:17:26.928-03:00",
    "current_sign_in_at": "2021-01-17T16:26:59.493-03:00",
    "email": "rainerborene@gmail.com",
    "full_name": "Rainer Borene",
    "id": 4753,
    "password": "dx3R8yDb",
    "phone_local_code": null,
    "phone_number": null,
    "sign_in_count": 45,
    "updated_at": "2021-09-24T15:48:34.447-03:00"
  }
}

    Evento: login feito

    
{
  "type": "user.signed_in",
  "data": {
    "created_at": "2017-11-16T14:35:11.406-02:00",
    "current_sign_in_at": "2021-09-27T10:39:38.738-03:00",
    "email": "marcia@personalmamaebebe.com",
    "full_name": "Márcia Madeira",
    "id": 1,
    "sign_in_count": 242,
    "updated_at": "2021-09-27T10:39:38.743-03:00"
  }
}


    Evento: progresso atualizado

    
{
  "type": "lesson_status.saved",
  "data": {
    "completed_at": "2021-09-24T15:51:33.007-03:00",
    "course": {
      "category": null,
      "created_at": "2017-11-16T14:36:34.934-02:00",
      "description": "Aprenda como cuidar do seu bebê desde a gravidez.",
      "id": 1,
      "image_url": "https://assets.memberkit.com.br/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCdz09IiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--40b493291e48474143187495fd12641a5f25bf5e/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaDdDRG9MWm05eWJXRjBTU0lJYW5CbkJqb0dSVlE2RW5KbGMybDZaVjkwYjE5bWFYUmJCMmtDc0FGcEFkZzZESEYxWVd4cGRIbHBhUT09IiwiZXhwIjpudWxsLCJwdXIiOiJ2YXJpYXRpb24ifX0=--51588d2d048abb5916461419fed84360f88580be/bebe.jpg",
      "name": "Cuidados com Bebê",
      "page_checkout_url": "",
      "position": 1,
      "updated_at": "2018-12-17T18:25:22.196-02:00"
    },
    "created_at": "2021-09-24T15:51:33.004-03:00",
    "id": 89979983,
    "lesson": {
      "created_at": "2017-11-16T14:42:03.350-02:00",
      "id": 10,
      "position": 9,
      "slug": "cuidados-adicionais",
      "title": "Cuidados Adicionais",
      "updated_at": "2017-12-01T20:25:31.320-02:00"
    },
    "progress": 22,
    "updated_at": "2021-09-24T15:51:33.007-03:00",
    "user": {
      "created_at": "2017-11-16T14:35:11.406-02:00",
      "current_sign_in_at": "2021-09-24T15:33:43.024-03:00",
      "email": "marcia@personalmamaebebe.com",
      "full_name": "Márcia Madeira",
      "id": 1,
      "profile_image_url": null,
      "sign_in_count": 241,
      "updated_at": "2021-09-24T15:33:43.044-03:00"
    }
  }
}

  9. Depois de inserir o JSON, clique em "Continuar";

  10. Agora você está na etapa do mapeamento [ou personalização]. É nesta etapa que você vai definir quais informações serão enviadas pela Memberkit para sua ferramenta de destino. Para isso, basta clicar em "+ Inserir infos do Pluga Webhooks", como mostra a imagem abaixo: 

    mceclip0.png

  11. Prontinho! Agora é só clicar em "Finalizar automatização" e deixar os robôs da Pluga trabalharem para você. 😎

 

Como enviar informações de uma ferramenta já integrada para a Memberkit

Neste artigo, vamos usar como exemplo duas ações:

Para ter acesso à lista completa de requisições, é só clicar aqui. 

Criando ou atualizando um membro na Memberkit

  1. Acesse a página de automatizações do Pluga Webhooks e escolha qual será a ferramenta que enviará os dados para a Memberkit;

  2. Após escolher a automatização e clicar em "Fazer essa automatização", conecte sua ferramenta de origem;

  3. Na ferramenta de destino, representada pelo Pluga Webhooks, insira um nome em “Nome” (exemplo: “Memberkit”) e, em “URL”, você deve preencher da seguinte forma:

    https://memberkit.com.br + a requisição que deseja fazer + a chave secreta da sua conta

    A requisição para criar ou atualizar um membro é esta aqui: /api/v1/users

    Para buscar sua chave secreta, acesse "Configurações" em sua conta da Memberkit e depois "Código":

    mceclip5.png

    mceclip6.png

    Então, a URL vai ficar assim:

    https://memberkit.com.br/api/v1/users?api_key=chavesecretadasuaconta

    Veja no exemplo abaixo:

    mceclip7.png

    mceclip8.png

    Clique em "Conectar";

  4. Pronto! Agora é só clicar em "Continuar" e seguir para a próxima etapa;

    mceclip3.png

  5. A etapa seguinte é a do mapeamento [ou personalização]. É nela que você vai definir quais informações da sua ferramenta de origem serão enviadas para a Memberkit.

    Para criar ou atualizar um membro, você pode enviar as seguintes informações:

    mceclip9.png

    O critério de unicidade para saber se um aluno já foi cadastrado ou não é o e-mail. Ou seja, é um dado obrigatório de ser informado. 

    Em “Chave” no mapeamento, coloque o nome do dado que deseja enviar para a Memberkit, seguindo o modelo da tabela acima. E, em “Valor”, você pode inserir uma informação da ferramenta de origem, como também escrever uma informação. 

    Confira no gif:

    memberkit_action_mapeamento_email.gif

  6. Prontinho! Agora é só clicar em "Finalizar automatização" e deixar os robôs da Pluga trabalharem para você. 😎

Adicionando uma nova pontuação na Memberkit

  1. Acesse a página de automatizações do Pluga Webhooks e escolha qual será a ferramenta que enviará os dados para a Memberkit;

  2. Após escolher a automatização e clicar em "Fazer essa automatização", conecte sua ferramenta de origem;

  3. Na ferramenta de destino, representada pelo Pluga Webhooks, insira um nome em “Nome” (exemplo: “Memberkit”) e, em “URL”, você deve preencher da seguinte forma:

    https://memberkit.com.br + a requisição que deseja fazer + a chave secreta da sua conta

    A requisição para adicionar uma nova pontuação é esta aqui: /api/v1/scores

    Para buscar sua chave secreta, acesse "Configurações" em sua conta da Memberkit e depois "Código":

    mceclip5.png

    mceclip6.png

    Então, a URL vai ficar assim:

    https://memberkit.com.br/api/v1/users?api_key=chavesecretadasuaconta

    Veja no exemplo abaixo:

    mceclip10.png

    mceclip11.png

    Clique em "Conectar";

  4. Pronto! Agora é só clicar em "Continuar" e seguir para a próxima etapa;

    mceclip3.png

  5. A etapa seguinte é a do mapeamento [ou personalização]. É nela que você vai definir quais informações da sua ferramenta de origem serão enviadas para a Memberkit.

    Para adicionar uma nova pontuação, todas as informações abaixo devem ser informadas:

    mceclip12.png

    Em “Chave” no mapeamento, coloque o nome do dado que deseja enviar para a Memberkit seguindo o modelo da tabela acima. E, em “Valor”, você pode inserir uma informação da ferramenta de origem, como também escrever uma informação. 

    Confira no gif:

    memberkit_action_mapeamento_reason.gif

  6. Prontinho! Agora é só clicar em "Finalizar automatização" e deixar os robôs da Pluga trabalharem para você. 😎

 

Dúvidas?

Caso ainda tenha dúvidas, é só solicitar um atendimento que nosso time de suporte entrará em contato dentro de algumas horas ;)

Esse artigo foi útil?
Usuários que acharam isso útil: 0 de 0

Artigos nessa seção