Passo a passo para o gestor # Conectar sua conta Cloudinary ao Locarë O Cloudinary guarda os **contratos, fotos e vistorias** que você anexa no Locarë — numa conta **sua**, com a sua cota. O Locarë só envia, lê e apaga os arquivos pela chave que você entrega aqui. > **Os arquivos são seus e ficam privados.** — Tudo é guardado em modo privado: nenhum arquivo tem endereço público, e o download sempre passa pelo Locarë, que confere quem está pedindo. Há plano gratuito — confira o limite atual no site do Cloudinary. > **Há um jeito mais curto: «Conectar Cloudinary».** — No cartão do Cloudinary, digite o **Cloud name** (passo 2 abaixo) e clique em **Conectar Cloudinary**. Autorize na tela do Cloudinary e pronto: sem gerar chave nem escolher papel. Os passos 3 e 4 deste guia são para quem prefere usar a chave de API. Antes de começar: as 3 informações | O quê | Onde NASCE | Onde você COLA | | --- | --- | --- | | Cloud name | No **Cloudinary** painel inicial (Dashboard) ou Settings | No **Locarë** Arquivos → «Cloud name» | | API Key | No **Cloudinary** Settings → API Keys | No **Locarë** Arquivos → «API Key» | | API Secret (secreta) | No **Cloudinary** junto da API Key | No **Locarë** Arquivos → «API Secret» | ## Passo 1 — Criar a conta no Cloudinary *Em `cloudinary.com`, clique em **Sign up for free** e crie a conta com o e-mail da imobiliária. O plano gratuito atende a maioria das carteiras no começo.* ## Passo 2 — Achar o Cloud name *Depois de entrar, clique na **engrenagem** (Settings), no canto inferior esquerdo. O **Cloud name** é o nome no alto do menu, à esquerda. É o nome da sua «nuvem» e não é segredo. Copie e guarde.* ## Passo 3 — Gerar uma chave com o papel certo *A chave é o que deixa o Locarë guardar os arquivos na sua conta. **O papel dela decide se funciona.*** 1. No menu das configurações, clique em **API Keys**. 2. Clique em **Generate New API Key**, no canto superior direito. 3. Dê um nome que você reconheça depois, como **Locare**. 4. Em **Role**, escolha **Master Admin**. > **«Media Library User» não funciona.** — É o papel que aparece ao lado, e o nome parece o certo. Mas ele não permite enviar nem apagar arquivos: a chave é aceita e falha no primeiro anexo. A chave nova também nasce sem permissão nenhuma — o papel precisa ser escolhido na hora de gerar. Se o seu plano oferecer **Tech Admin** ou **Media Library Admin**, eles também servem e dão menos poder. Na dúvida, Master Admin. ## Passo 4 — Copiar a API Key e o API Secret *A chave criada aparece na lista. A **API Key** é o número da coluna API Key, na linha dela. O **API Secret** fica oculto: passe o mouse sobre ele e use o **olho** para ver ou o ícone ao lado para **copiar**. Trate o Secret como uma senha.* > **Use uma chave só para o Locarë.** — Master Admin alcança a conta inteira do Cloudinary. Com uma chave dedicada, se um dia precisar revogar, você revoga só esta, sem derrubar mais nada. ## Passo 5 — Colar no Locarë e testar 1. No Locarë, vá em **Configurações → Serviços → Arquivos** e escolha **Cloudinary**. 2. Cole o **Cloud name**, a **API Key** e o **API Secret**, e clique em **Salvar**. 3. Clique em **Testar conexão**. Aparecendo o selo **«Testado»** em verde, está pronto. > **O «Testar conexão» tira a dúvida de verdade.** — Ele não confere só a senha: grava um arquivo, lê de volta, compara e apaga. Se o papel da chave estiver curto, você descobre ali, e não no primeiro contrato anexado. ## Está tudo funcionando? 1. **Cloud name**, **API Key** e **API Secret** colados em Arquivos. 2. Selo **«Testado»** em verde depois do «Testar conexão». 3. Uma foto enviada num imóvel aparece na ficha dele. Locarë · Guia da integração Cloudinary · 24/09/2026, com o «Conectar Cloudinary». As telas do Cloudinary podem mudar com o tempo; o passo a passo segue o mesmo. --- Central de Ajuda Locarë · revisão de 23/10/2026 · versão para pessoas: https://app.locareapp.com/manual