Aprenda a conectar a edunext com plataformas externas para automatizar processos acadêmicos e financeiros.

Introdução

As integrações na edunext permitem conectar a plataforma a sistemas externos, como ambientes virtuais de aprendizagem (LMS) e ferramentas de automação, otimizando fluxos acadêmicos, financeiros e operacionais.

Com elas, você pode:

• automatizar inscrições de alunos,
• sincronizar cursos e usuários,
• enviar eventos financeiros para outros sistemas,
• reduzir trabalho manual e falhas operacionais.

Neste artigo, você aprenderá como adicionar, configurar e gerenciar integrações de forma segura e eficiente.

Passo a passo

1. Acesse o Painel de Integrações no menu da plataforma.
2. Clique em Adicionar integração.
3. Informe um nome para identificar facilmente a integração.
4. No campo Status, escolha:
   • Habilitado (padrão), ou
   • Desabilitado, caso queira configurar antes de ativar.
5. Selecione o tipo de integração desejado:
   • D2L
   • Webhook
   • Moodle
6. Preencha os campos obrigatórios, conforme o tipo escolhido.
7. Vincule os cursos que utilizarão essa integração.
8. Clique em Salvar para concluir.

Essa integração permite a sincronização automática de cursos e usuários entre a edunext e o D2L Brightspace.

Campos necessários para configuração

• Host (endereço do servidor da instituição no D2L)
  Exemplo: https://lms.d2l.com
• Port (porta de comunicação com o servidor)
  Exemplo: 443
• App ID (Código de identificação da aplicação)
  Exemplo: -YiJ0b9WimgKhBa74LTsNV
• App Key (Chave de identificação da aplicação)
  Exemplo: JBARvnlFp9-Cr9-TtBZfTU
• User ID (Identificação do usuário administrador.)
  Exemplo: A7Fn1U-LKw5g-TxGESFe7EK
• User Key (Chave de identificação do usuário)
  Exemplo: dFIKKfMH_SNuJ22bkYA5A
• Org Unit ID (Código da Unidade Organizacional onde o aluno será inscrito)
  Exemplo: 1266
• Role ID (Código da função que o aluno ocupará dentro da Unidade Organizacional)
  Exemplo: 110
• Send Creation Email (opção para envio automático de e-mails na criação do curso)
• Vincular ao curso (especificar quais cursos serão integrados)

Clique em Salvar para concluir a integração.

Os webhooks permitem que a edunext envie eventos automaticamente para outros sistemas sempre que algo acontecer na plataforma.

Eventos comuns:

• criação de contratos financeiros,
• geração ou atualização de faturas,
• mudanças de status.

Campos necessários para configuração

• URL – endpoint que receberá os eventos
• Tipo – contratos financeiros ou faturas
• Status – status monitorados (separados por vírgula)
• Vincular ao curso – cursos relacionados
• Clique em Salvar para ativar o webhook.

A integração com o Moodle permite que alunos matriculados na edunext tenham acesso automático aos cursos no ambiente Moodle.

🛠️ Configurações obrigatórias no Moodle (antes da edunext)

1) Habilitar Web Services

Caminho: Administração do site → Servidor → Web services → Resumo

• Usuários como clientes com tokens
• Habilitar web services: Sim

2) Criar Serviço Externo

Caminho: Administração do site → Servidor → Web services → Serviços externos → Serviços personalizados → Adicionar

Adicione as seguintes funções ao serviço externo:

• core_user_create_users
• core_user_update_users
• core_user_delete_users
• core_course_create_courses
• core_course_delete_courses
• core_course_get_courses
• core_course_update_courses
• core_enrol_get_users_courses
• core_user_get_users_by_field
• enrol_manual_enrol_users
• enrol_manual_unenrol_users

3) Ativar o protocolo REST

Caminho: Administração do site → Servidor → Web services → Gerenciar protocolos

• Ativar Protocolo REST

4) Criar o token

Caminho: Administração do site → Servidor → Web services → Gerenciar tokens

• Criar um token
• Associar ao serviço externo criado para a integração edunext

Após concluir as etapas no Moodle, volte à edunext e preencha:

• URL – endereço da instância Moodle
• Token – token gerado no Moodle
• Curso ID – ID do curso no Moodle
• Role ID – papel do aluno no Moodle
• Verificar aprovação (opcional)
• Vincular ao curso – cursos integrados
• Clique em Salvar para ativar a integração.

Após salvar a configuração, é essencial monitorar suas integrações para garantir um funcionamento sem falhas. Para isso:

• Acesse o Painel de Integrações para visualizar o status de cada conexão.
• Verifique regularmente as credenciais e configurações das ferramentas integradas.
• Atualize os tokens e chaves de acesso sempre que houver alterações nos serviços externos.
• Remova integrações inativas para evitar erros operacionais.
• Revise os cursos vinculados para garantir que todos os alunos tenham acesso correto ao conteúdo.

Com essas boas práticas, você garante a estabilidade e segurança das integrações na edunext, proporcionando uma experiência fluida tanto para a gestão quanto para os alunos.