> For the complete documentation index, see [llms.txt](https://ajuda.uplaces.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.uplaces.com.br/integracoes/cloudinary.md).

# Cloudinary: o que é e como configurar

O que é o Cloudinary e como ligar a sua conta à Uplaces: Cloud name, Upload preset, API key e API secret, onde colar e como conferir.

O Cloudinary é um serviço de gerenciamento de imagens e arquivos na nuvem: ele guarda as fotos, ajusta o tamanho e as entrega rápido pela internet. Existe um plano gratuito com limites, que serve para começar. Na Uplaces, usar a sua conta no Cloudinary é opcional: sem ela, as fotos e os arquivos que você envia usam o armazenamento padrão da Uplaces e a loja funciona do mesmo jeito. Com ela, as imagens ficam na sua própria conta, e você as organiza e consulta pelo painel do Cloudinary. Para ligar, copie quatro dados do Cloudinary e cole na tela de integrações da Uplaces.

## Antes de começar

* Conta no Cloudinary. O plano gratuito serve para começar ([cadastro](https://cloudinary.com/users/register/free)).
* Perfil de administrador ou diretor na Uplaces. O item **Outras integrações** aparece no menu com o módulo **Outras integrações** ligado em **Módulos**.
* Tenha à mão os quatro dados: **Cloud name**, **API Key**, **API Secret** e o nome de um **upload preset**.

**Os quatro dados, em uma frase cada:**

* **Cloud name:** o nome da sua conta no Cloudinary. Faz parte do endereço de todas as suas imagens.
* **Upload preset:** um conjunto de regras de envio que você cria no Cloudinary. É ele que permite enviar imagens direto do navegador, sem expor a sua chave. Veja [upload presets na documentação do Cloudinary](https://cloudinary.com/documentation/upload_presets).
* **API Key** e **API Secret:** o par de chaves da conta. Servem para os envios feitos pelo servidor. O **API Secret** é como uma senha.

{% stepper %}
{% step %}

## Copiar os dados no Cloudinary

No painel do Cloudinary (os caminhos mudam com o tempo; em caso de dúvida, consulte a documentação do Cloudinary):

1. Anote o **Cloud name**, a **API Key** e o **API Secret**. Ficam na página inicial do painel, em credenciais do ambiente.
2. Crie um **upload preset**: em **Settings**, na aba **Upload**, **Add upload preset**. Em **Signing mode**, escolha **Unsigned**. Salve e anote o nome do preset.
   {% endstep %}

{% step %}

## Colar os dados na Uplaces

1. No menu da Uplaces, abra **Outras integrações › Configurações**. A tela abre na aba **Integrações**.
2. Na seção **Cloudinary**, preencha:

| Campo na tela      | O que colar                                               |
| ------------------ | --------------------------------------------------------- |
| **Cloud name**     | o Cloud name do Cloudinary                                |
| **Upload present** | o nome do upload preset criado (a tela escreve "present") |
| **Api key**        | a API Key                                                 |
| **Api secret**     | o API Secret                                              |

3. Clique em **Salvar**.

Não envie o **API Secret** por e-mail nem por mensagem. Quem o tem acessa os arquivos da sua conta.
{% endstep %}
{% endstepper %}

## Resultado

Os próximos envios de imagem, como logo e fotos de produto, vão para a sua conta no Cloudinary. As imagens que já estavam na loja continuam onde estão. Para conferir, envie uma imagem e procure o arquivo na **Media Library** do Cloudinary.

## Problemas comuns

<details>

<summary>O envio da imagem falha</summary>

O upload preset precisa estar em **Unsigned**. Preset assinado não funciona com o envio direto do navegador.

</details>

<details>

<summary>A imagem continua no armazenamento da Uplaces</summary>

O envio direto só liga quando **Cloud name** e **Upload present** estão preenchidos. Confira os dois e salve.

</details>

<details>

<summary>Cloud name não encontrado</summary>

Copie de novo, sem espaços no começo ou no fim.

</details>

<details>

<summary>O Cloudinary avisa que o espaço acabou</summary>

O limite é do plano da sua conta no Cloudinary. Consulte o plano no painel do Cloudinary.

</details>

## Perguntas frequentes

<details>

<summary>O que é o Cloudinary?</summary>

É um serviço de imagens na nuvem. Ele armazena as fotos e os arquivos, ajusta o tamanho e entrega rápido. A Uplaces pode usar a sua conta dele para guardar as imagens da sua loja.

</details>

<details>

<summary>Preciso ter conta no Cloudinary para usar a Uplaces?</summary>

Não. Sem conta própria, as imagens usam o armazenamento padrão da Uplaces.

</details>

<details>

<summary>O Cloudinary é gratuito?</summary>

Existe um plano gratuito, com limites definidos pelo Cloudinary. Consulte os planos no site do Cloudinary.

</details>

<details>

<summary>As fotos que vêm do ERP vão para a minha conta no Cloudinary?</summary>

As fotos importadas do ERP são copiadas para o armazenamento de imagens: a sua conta no Cloudinary, quando você preencheu também a **Api key** e o **Api secret**, ou o armazenamento da Uplaces. Para manter a foto no endereço do ERP, marque **Manter imagem hospedada no ERP** em **Critérios para atualização de PRODUTOS**, na integração do ERP.

</details>

<details>

<summary>Qual a diferença entre o upload preset e a chave de API?</summary>

O upload preset libera o envio direto do navegador, com as regras que você definiu. A API Key e o API Secret autorizam o envio feito pelo servidor.

</details>

## Veja também

* [Imagens e vídeos dos produtos](https://ajuda.uplaces.com.br/ecommerce-b2b/produtos/imagens-e-videos.md)
* [Integrações](https://ajuda.uplaces.com.br/integracoes/integracao-com-erp.md)
* [Importar do ERP](https://ajuda.uplaces.com.br/integracoes/importar-do-erp.md)
