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.

Tipos de integrações disponíveis na edunext

A edunext oferece diferentes tipos de integração, cada uma com finalidades específicas.

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 - Link do D2L da instituição de ensino.
• Port - O padrão do D2L é 443.

App ID e App Key

1. Faça login no D2L Brightspace.
2. Gerenciar Extensibilidade: No menu de Ferramentas Administrativas (engrenagem), selecione Gerenciar Extensibilidade.
3. Registrar um Apl.: Clique em Registrar um aplicativo.
4. Preencha os dados: Insira o nome do aplicativo e a URL de redirecionamento https://apitesttool.desire2learnvalence.com/index.php
5. Obtenha as chaves: Após salvar, o D2L gerará um ID do Aplicativo (App ID) e uma Chave do Aplicativo (App Key).

User ID e User Key

1. Com Host, Port e App ID e App Key em mãos, acesse https://apitesttool.desire2learnvalence.com/
2. Insira os dados e clique em "Authenticate" ou "Register".
3. Autorize: O D2L pedirá para você fazer login (se já não estiver) e autorizar a aplicação a acessar seus dados. É recomendável criar um "usuário de serviço" no D2L (um usuário genérico de admin) e usar este usuário para gerar o User ID/Key, em vez de usar sua conta pessoal.
4. Após a autorização, a página retornará os valores de User ID e User Key.

• Org Unit ID - Número da unidade organizacional à qual se deseja que o aluno seja inscrito.
• Role ID - Número da função do usuário que será criado. A permissão de alunos no padrão D2L é 110, mas vale verificar no menu em "Configurações (engrenagem no canto superior direito)" -> Funções e permissões" -> Selecionar a função desejada -> Na URL o ID estará como "roleId=XXX".
• Send Creation Email - Opção de envio automático de e-mail da criação do usuário. Preencha com "yes" ou "no".
• Vincular ao curso - Aqui você associa os produtos quais farão a inscrição dos alunos configurada anteriormente no momento da compra.

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

Configuração da integração com Moodle na 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.