> For the complete documentation index, see [llms.txt](https://ajuda.zdg.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.zdg.com.br/configuracao-administrador/configuracoes-painel-admin/apps-configuracoes/mercado-livre-configuracao-apps.md).

# Mercado Livre - Configuração Apps

{% hint style="danger" %}
**Funcionalidade em beta:** este recurso foi lançado recentemente e ainda está em fase de testes. Alguns comportamentos podem apresentar instabilidade ou não funcionar como esperado em todos os cenários. Estamos coletando feedback e aplicando melhorias e correções ao longo das próximas versões. Se encontrar algum problema, entre em contato com o suporte.
{% endhint %}

{% hint style="info" %}
**Disponível para o perfil:** Administrador
{% endhint %}

Esta página permite que cada tenant configure suas **próprias credenciais OAuth** do Mercado Livre, substituindo a configuração global definida pelo Super Administrador.

{% hint style="info" %}
**Precisa do tutorial completo?** Veja o passo a passo desde a criação do app no portal de desenvolvedores até a ativação do canal em: [Integrando o Mercado Livre ao Z-PRO.](/configuracao-superadmin/redes-sociais-e-marketplaces/mercado-livre-superadmin.md)
{% endhint %}

***

### Como acessar

No painel administrativo, acesse **Configurações → Apps → Mercado Livre**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FiqeFWJK7Zmf5ybXuIeKF%2Fimage.png?alt=media&amp;token=171f4b46-ca0b-4b88-8444-c5397e0a0ea0" alt="" width="333"><figcaption></figcaption></figure>

***

### Você verá a seguinte tela

A listagem exibe todos os apps configurados com as colunas: **ID**, **App ID**, **Site**, **Descrição** e **Status**.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FwE8ORdZfAxUdNMEo7aaP%2Fimage.png?alt=media&amp;token=1005b5d8-a336-4a82-833b-2eaf2b99c01c" alt=""><figcaption></figcaption></figure>

***

### Criando uma nova configuração

Clique em **+ Novo App ML** para abrir o modal de cadastro.

<figure><img src="https://3541975055-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FM5B652UsmGn3Q7h9Du1t%2Fuploads%2FJdHfXsrRmljEXC9GNB8B%2Fimage.png?alt=media&amp;token=cebc1d24-b590-4e1f-b092-66d2e116df4b" alt="" width="375"><figcaption></figcaption></figure>

| Campo                             | Descrição                                                                                                                      |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **App ID (client\_id)**           | ID do cliente gerado no portal de desenvolvedores do Mercado Livre                                                             |
| **Site ID**                       | País de operação — ex: **Brasil (MLB)**, Argentina (MLA), México (MLM)                                                         |
| **App Secret (client\_secret)**   | Chave secreta gerada no portal de desenvolvedores                                                                              |
| **Redirect URI (OAuth callback)** | Campo **fixo** — `https://oauth.techprovider.com.br/callback.html`. Cadastre exatamente esta URL no DevCenter do Mercado Livre |
| **Webhook URL**                   | Campo **fixo** — não pode ser alterado                                                                                         |
| **Descrição**                     | Identificação opcional da configuração — ex: "App principal ML Brasil"                                                         |
| **Ativo**                         | Ativa ou desativa esta configuração de credenciais                                                                             |

{% hint style="warning" %}
**Esta configuração sobrescreve a global.** Ao cadastrar credenciais aqui, este tenant passa a usar suas próprias credenciais em vez das configuradas pelo Super Administrador. Se não houver configuração nesta página, o sistema utiliza a configuração **Global** definida no Super Admin.
{% endhint %}

{% hint style="danger" %}
O **Redirect URI** deve ser cadastrado **exatamente** como `https://oauth.techprovider.com.br/callback.html` no DevCenter do Mercado Livre. Qualquer divergência impedirá o funcionamento da integração.
{% endhint %}

***

### Páginas relacionadas

* [Tutorial completo: Integrando o Mercado Livre ao Z-PRO](/configuracao-superadmin/redes-sociais-e-marketplaces/mercado-livre-superadmin.md)
* [Canal Mercado Livre](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/canal-mercado-livre.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.zdg.com.br/configuracao-administrador/configuracoes-painel-admin/apps-configuracoes/mercado-livre-configuracao-apps.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
