[Monitoramento] Como conectar o portal Enphase (Enlighten)

Quer acompanhar no Groner as usinas dos seus clientes com microinversores Enphase? O Monitoramento conecta com a Enphase por uma aplicação sua no portal de desenvolvedor da Enphase. Você não informa a senha do Enlighten: autoriza o acesso uma vez na própria página da Enphase. Depois disso, o Groner busca a geração das usinas sozinho, várias vezes por dia.

Neste artigo você vê o que precisa ter em mãos, como criar a aplicação, como conectar a conta e o que fazer se a Enphase pedir uma nova autorização.

O que você precisa ter

• O acesso à conta do Enlighten (de instalador ou de dono do sistema) que enxerga as usinas.
• Uma conta no portal de desenvolvedor da Enphase: https://developer-v4.enphase.com. Ela é gratuita.

O Groner pede quatro informações:

• API Key: a chave da sua aplicação na Enphase.
• Client ID: o identificador da aplicação.
• Client Secret: a senha da aplicação. É diferente da senha do Enlighten.
• Código de autorização: gerado pela Enphase quando você aprova o acesso. Ele vale uma vez só.

Parte 1: Crie a sua aplicação na Enphase

1. Acesse https://developer-v4.enphase.com e crie a sua conta de desenvolvedor (ou entre, se já tiver).
2. Vá em Applications e clique em Create Application.
3. Dê um nome (por exemplo, "Groner Monitoramento") e escolha o plano Watt, que é gratuito.
4. Em Access Control, marque as permissões de leitura dos sistemas (System Details e Site Level Production Monitoring).
5. Salve. Na tela da aplicação aparecem a API Key, o Client ID e o Client Secret. Deixe essa tela aberta: você vai copiar os três.

Dica: o plano Watt permite 1.000 consultas por mês. O Groner se ajusta a esse limite. Se você tem muitas usinas e quer a geração atualizada com mais frequência, contrate um plano maior na Enphase e escolha esse plano no formulário do Groner.

Parte 2: Conecte a conta no Monitoramento

1. Abra a tela de integrações

1. No menu lateral do Monitoramento, clique em Integrações.
2. Clique em + Portal, no canto superior direito.
3. Na janela Qual portal?, digite enphase na busca e clique em Enphase (Enlighten).

A janela Conectar portal abre com o passo a passo resumido e os campos.

2. Preencha as chaves da aplicação

1. Em Nome desta conta (opcional), escreva um nome para reconhecer a conta depois, como "Enphase Matriz".
2. Cole a API Key, o Client ID e o Client Secret que estão na tela da sua aplicação na Enphase.
3. Em Plano da sua aplicação, deixe Watt (gratuito) ou escolha o plano que você contratou.

3. Autorize o acesso na Enphase

1. Clique em Autorizar na Enphase. O botão só fica disponível depois que o Client ID está preenchido.
2. Uma nova aba abre na Enphase. Entre com o e-mail e a senha do Enlighten e aprove o acesso.
3. A Enphase mostra uma página cujo endereço termina em code=…. Copie o endereço inteiro da barra do navegador (ou só o código depois de code=).
4. Volte ao Groner e cole em Código de autorização.
5. Clique em Conectar logo em seguida: o código vale por pouco tempo.

Pronto! A conta aparece em Integrações com o status Coletando. Clique em Ver estações para ver as usinas da conta e vincular cada uma a um negócio do Groner.

Com que frequência os dados chegam

• No plano Watt, a geração do dia é atualizada a cada cerca de 40 minutos, das 5h às 21h. Assim as 1.000 consultas do mês não acabam antes do fim do mês.
• Em planos maiores, a atualização fica mais frequente (a cada 10 minutos ou mais).
• O histórico diário e mensal de cada usina também é importado da Enphase.
• A potência mostrada é a média do intervalo entre duas atualizações, porque a Enphase não informa a potência do momento nesse tipo de consulta.

Erros comuns

"Enphase recusou a autorização (código ou autorização vencida)"
O código já foi usado ou demorou demais para ser colado. Clique de novo em Autorizar na Enphase, aprove e cole o endereço novo. Depois clique em Conectar sem esperar.

"Client ID ou Client Secret inválido"
Confira se você copiou as chaves da aplicação certa na Enphase, sem espaço no começo ou no fim.

O botão Autorizar na Enphase está cinza
Preencha primeiro o campo Client ID.

A conta aparece em "Precisam de atenção" com "Credencial inválida"
A autorização venceu ou foi removida no Enlighten. Para reconectar:

1. Na conta Enphase, clique em ⋯ e depois em Editar (apelido / credenciais).
2. Clique em Autorizar na Enphase. O Client ID já gravado é usado.
3. Aprove na Enphase, cole o novo endereço em Código de autorização (só para reconectar) e clique em Salvar.

As usinas já vinculadas e o histórico gravado continuam no lugar. A coleta volta no próximo ciclo.

Atualizado em: 29/10/2026