> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # [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. ![Janela Conectar portal da Enphase com o passo a passo e os campos API Key, Client ID e Client Secret](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/01-integracoes-portal-enphase-_1qx4bld.png) ### 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. ![Formulário preenchido com o botão Autorizar na Enphase e o campo Código de autorização; com o código vencido, aparece o aviso para gerar um novo](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/04-codigo-recusado-mostra-o-qu_1b2hk8x.png) 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. ![Tela Integrações depois de conectar, com a mensagem Conta conectada](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/03-conectar-com-codigo-conta-a_1gihbel.png) --- ## 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**. ![Janela Editar conexão da Enphase para reconectar a autorização](https://storage.crisp.chat/users/helpdesk/website/-/2/e/a/d/2ead53dce3a73c00/05-autorizacao-vencida-reconec_1smti90.png) As usinas já vinculadas e o histórico gravado continuam no lugar. A coleta volta no próximo ciclo.