Configurando o Maestrus para receber matrículas de vendas externas

Olá! Tudo bem?

Nesse tutorial você irá aprender como receber matrículas realizadas em sistemas externos em seu Maestrus!

Vamos lá!

Mas antes, veja os pré requisitos para o uso desse recurso de sistema:

  1. Módulo de: Integração de Matrículas por Postback disponível no seu plano contratado (caso não encontre esse módulo, entre em contato com nosso time de suporte);
  2. Conhecimento básico em alguma linguagem de programação;
  3. Conhecimento a respeito de requisições no protocolo HTTP;
  4. Conhecimento em dados no formato JSON;
  5. Conhecimento de validação de dados por chaves HMAC em requisições HTTP;


Configurando o sistema para realizar a integração:

Como passos fundamentais é necessário acessar o Menu: Educação -> Configurações -> Matrículas Externas, conforme mostra o print abaixo:

IMAGEM 1

 

Na tela de configuração observe e realize os seguintes procedimentos:

IMAGEM 2

  1. Clique no botão em Novo Token; Após isso um novo token será gerado;
  2. Clicando mais uma vez no mesmo botão, que agora tem por nome, Copiar Token, o seu hash será copiado para a área de transferência do sistema operacional;
  3. Reserve o Token de maneira secreta na sua aplicação, uma vez que, ele será o responsável para gerar a chave HMAC dos dados enviados;
  4. Reserve a URL do POST onde seu sistema deve informar ao Maestrus onde enviar os dados;

Para gerar um Hash HMAC com SHA1 você pode proceder conforme o exemplo abaixo escrito em Python:

IMAGEM 3

De posse do token gerado e da URL de envio você irá necessitar programar no seu sistema o envio das requisições com os dados dispostos no seguinte modelo:

 

IMAGEM 4

Como resultado dessa requisição os retornos possíveis são:

  • HTTP 200: Sucesso, seus dados foram enviados e processados,
  • HTTP 400: Há alguma problema com os dados sua requisição, informados no JSON resultante ou o seu HMAC é inválido;
  • HTTP 403: Seu plano não dispõe dessa funcionalidade;

Caso tenha dúvidas adicionais ao processo de procedimento com a integração nosso time de suporte estará apto e disposto a ajudá-lo! =)
 

 

 


Última atualização: 05/03/2021 21:45:35

Vamos conversar? Fale com um especialista.

Whatsapp Freshchat
Vá para o topo