Como integrar a Cademí a outras ferramentas via Pluga Webhooks

Neste artigo vamos mostrar como integrar sua conta da Cademí com outras ferramentas como Manychat, Google Sheets, BotConversa e muito mais através do Pluga Webhooks!

Aqui nós vamos usar o BotConversa como ferramenta de destino dos dados para enviar informações da Cademí para o BotConversa. Mas, o processo para integrar outras ferramentas é bem parecido!

1. Primeiro clique em “Criar Automatização” e dê um nome a ela:
   
   
2. Depois escolha a ferramenta de origem dos dados, que nesse caso é o Pluga Webhooks, e o gatilho da sua automatização e clique em “Continuar”:
   
3. Agora você deve criar uma nova conexão para essa conta e nomeá-la. Então, clique em “Conectar nova conta”, dê um nome a ela e clique em “Confirmar”:
   
   
4. Agora, é o momento de configurar a URL da Pluga na Cademí. Essa é a URL da sua automatização e que vai receber as informações da Cademí. Então, copie a URL:
   
5. Acesse a sua conta da Cademí, clique na engrenagem e depois em “Webhook”:
   
6. Clique em “Novo webhook”, selecione o evento que vai funcionar como gatilho para que as informações sejam enviadas da Cademí para a Pluga e cole a URL da Pluga no campo “endpoint”. Depois clique em “Salvar”:
   
   
7. Pronto! Agora o webhook já está configurado na Cademí e você deve voltar a Pluga para continuar com a criação da automatização, clicando em “Continuar”:
   
8. Agora você deve indicar o nome da Cademí e informar o modelo de envio dos dados, que é basicamente o JSON dos campos enviados pela Cademí:
   
   
   

   Abaixo você encontra o JSON que deve ser utilizado em cada evento da Cademí:

   Certificado Emitido

   Esse evento é disparado toda vez que um aluno emite um certificado de um determinado Produto.

   {
     "event_id": "47190b41-f388-4975-ba48-44ad749748b7",
     "event_type": "certificado.emitido",
     "event": {
       "emissao": {
         "uid": "ABC123",
         "pdf": "http://membros.cademi.com.br/system/file/certificado/ABC123"
       },
       "usuario": {
         "id": 123,
         "nome": "Aluno Fantasia",
         "email": "[e-mail]",
         "doc": "123.123.123-12",
         "celular": "12312312330",
         "login_auto": "http://membros.cademi.com.br/auth/login?crstk=",
         "criado_em": "2022-02-10 11:38:50",
         "ultimo_acesso_em": "2022-02-10 11:43:13"
       },
       "produto": {
         "id": 231,
         "nome": "Conhecendo a Cademí",
         "vitrine": {
           "id": 10,
           "nome": "✨ Conheça"
         }
       }
     }
   }

   Entrega - Adicionada

   Esse evento é disparado toda vez que uma Entrega é adicionada a um determinado aluno.

   {
     "event_id": "6b4be100-064c-4473-bb64-4df335a858af",
     "event_type": "entrega.adicionada",
     "event": {
       "usuario": {
         "id": 123,
         "nome": "Aluno Fantasia",
         "email": "[e-mail]",
         "doc": "123.123.123-12",
         "celular": "12312312330",
         "login_auto": "http://membros.cademi.com.br/auth/login?crstk=",
         "criado_em": "2022-02-10 11:38:50",
         "ultimo_acesso_em": "2022-02-10 11:43:13"
       },
       "entrega": {
         "id": 685,
         "nome": "Assinatura Anual",
         "engine": "hotmart",
         "engine_id": "321"
       }
     }
   }

   Prova - Aprovado

   Esse evento é disparado toda vez que um aluno é aprovado em uma determinada Prova.

   {
     "event_id": "830433f5-3173-4490-ab0f-f0ceee8cd1f7",
     "event_type": "prova.aprovado",
     "event": {
       "usuario": {
         "id": 123,
         "nome": "Aluno Fantasia",
         "email": "[e-mail]",
         "doc": "123.123.123-12",
         "celular": "13997206774",
         "login_auto": "http://membros.cademi.com.br/auth/login?crstk=",
         "criado_em": "2022-02-10 11:38:50",
         "ultimo_acesso_em": "2022-02-10 11:43:13"
       },
       "produto": {
         "id": 231,
         "nome": "Conhecendo a Cademí",
         "vitrine": {
           "id": 10,
           "nome": "✨ Conheça"
         }
       },
       "prova": {
         "id": 1,
         "produto_id": 231,
         "titulo": "Prova Exemplo",
         "nota_minima": "70"
       },
       "resultado": {
         "id": 123,
         "nota_final": 100,
         "acertos": 3,
         "erros": 0
       }
     }
   }

   Prova - Reprovado

   Esse evento é disparado toda vez que um aluno é reprovado em uma determinada Prova.

   {
     "event_id": "5cead490-dd74-4ebb-834c-7b4fd858a455",
     "event_type": "prova.reprovado",
     "event": {
       "usuario": {
         "id": 123,
         "nome": "Aluno Fantasia",
         "email": "[e-mail]",
         "doc": "123.123.123-12",
         "celular": "12312312330",
         "login_auto": "http://membros.cademi.com.br/auth/login?crstk=",
         "criado_em": "2022-02-10 11:38:50",
         "ultimo_acesso_em": "2022-02-10 11:43:13"
       },
       "produto": {
         "id": 231,
         "nome": "Conhecendo a Cademí",
         "vitrine": {
           "id": 10,
           "nome": "✨ Conheça"
         }
       },
       "prova": {
         "id": 1,
         "produto_id": 231,
         "titulo": "Prova Exemplo",
         "nota_minima": "70"
       },
       "resultado": {
         "id": 123,
         "nota_final": 33,
         "acertos": 1,
         "erros": 2
       }
     }
   }

   Termo Assinado

   Esse evento é disparado toda vez que um usuário assina um termo de aceite.

   {
     "event_id": "7547ecd4-867d-4933-859b-95dd5334c66c",
     "event_type": "termo.assinado",
     "event": {
       "usuario": {
         "id": 123,
         "nome": "Aluno Fantasia",
         "email": "[e-mail]",
         "doc": "123.123.123-12",
         "celular": "13997206774",
         "login_auto": "http://membros.dvp/auth/login?crstk=",
         "criado_em": "2022-02-10T07:56:40-03:00",
         "ultimo_acesso_em": null
       },
       "log": {
         "id": 123,
         "referencia": "plataforma_aceite",
         "referencia_id": null,
         "ip": "::1",
         "useragent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.109 Safari/537.36",
         "criado_em": "2022-03-05T12:28:26-03:00"
       }
     }
   }

   Usuário Grátis - Criado

   Esse evento é disparado toda vez que um usuário gratuito é criado, ou um usuário é definido como gratuito.

   {
     "event_id": "41244473-629b-48a5-9bd5-04d1cc7b6412",
     "event_type": "usuario.gratis.criado",
     "event": {
       "usuario": {
         "id": 123,
         "nome": "Aluno Fantasia",
         "email": "[e-mail]",
         "doc": "123.123.123-12",
         "celular": "13997206774",
         "login_auto": "http://membros.cademi.com.br/auth/login?crstk=",
         "criado_em": null,
         "ultimo_acesso_em": null
       }
     }
   }

   Usuário - Criado

   Esse evento é disparado toda vez que um usuário é criado.

   {
     "event_id": "01664950-b5fc-4d03-b8d0-b6d0576c3ae8",
     "event_type": "usuario.criado",
     "event": {
       "usuario": {
         "id": 123,
         "nome": "Aluno Fantasia",
         "email": "[e-mail]",
         "doc": "123.123.123-12",
         "celular": "13997206774",
         "login_auto": "http://membros.cademi.com.br/auth/login?crstk=",
         "criado_em": null,
         "ultimo_acesso_em": null
       }
     }
   }

   Usuário - Progresso

   Esse evento é disparado toda vez que é registrado o progresso de um aluno. O valor de "progresso" representa a porcentagem total de progresso do aluno neste produto.

   {
     "event_id": "23d0d57c-062c-4f82-9202-56af5cbb61f4",
     "event_type": "usuario.progresso",
     "event": {
       "usuario": {
         "id": 123,
         "nome": "Aluno Fantasia",
         "email": "[e-mail]",
         "doc": "123.123.123-12",
         "celular": "13997206774",
         "login_auto": "http://membros.cademi.com.br/auth/login?crstk=",
         "criado_em": null,
         "ultimo_acesso_em": null
       },
       "produto": {
         "id": 12345,
         "ordem": 5,
         "nome": "Nome do produto",
         "oferta_url": null,
         "vitrine": {
           "id": 1,
           "ordem": 5,
           "nome": "Nome da vitrine"
         }
       },
       "progresso": 30
     }
   }

   Agora, clique em “Continuar” e depois em “Conectar nova ferramenta”:
   
   
   
   
   
9. Agora você deve selecionar a ferramenta que deve receber as informações da Cademí. No caso, também será o Pluga Webhooks e a ação é “Enviar uma mensagem via Pluga Webhooks”. Depois clique em “Continuar”:
   
10. Conecte uma nova conta, dê um nome a ela e clique em “Confirmar”:
    
    
11. Agora, você deve indicar o nome da ferramenta que está integrando e configurar a URL do BotConversa que deve receber essas informações. Para encontrar a URL do BotConversa, siga os passos abaixo:
    
    ➡️ Como enviar informações de uma ferramenta já integrada para o BotConversa
    
    Seu mapeamento deve ficar da seguinte forma, depois clique em “Continuar”:
    
    
12. Chegando no mapeamento dos campos, você deve configurar quais informações da Cademí deseja enviar para o BotConversa:
    
13. Depois clique em “Continuar” e em “Finalizar automatização”:
    
    
    
    Agora, para que sua automatização funcione como o esperado, acione o gatilho na ferramenta de origem que, nesse caso, é criar um novo usuário na Cademí, para que a automatização processe um evento:
    
    
    
    
    
14. No BotConversa, clique em Receber dados para configurar as informações que foram recebidas:
    
    
    
    Ah! É importante lembrar que o evento pode levar cerca de 15 minutos para chegar até o BotConversa, ok? ;)
15. Como foi preenchido na planilha o nome e telefone, indique no BotConversa os campos correspondentes ao nome e telefone do contato:
    
    
    
    
16. Clique em + e adicione as ações desejadas:
    
    
    
    Atualmente, essas são as ações disponíveis no BotConversa:
    
    
    
    
17. Você pode, por exemplo utilizar as informações mapeadas e criar múltiplas ações:
    
    
    
    
18. Para finalizar, é só clicar em ATIVO no topo da página:
    
    
    
    Pronto! Seu BotConversa já está pronto para receber as informações enviadas pela Pluga. =)
    
    
    

Dúvidas?

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