> 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-superadmin/redes-sociais-e-marketplaces/mercado-livre-superadmin.md). # Mercado Livre - Superadmin Esta documentação detalha o processo completo para integrar uma conta do **Mercado Livre** à plataforma **Z-PRO**, permitindo que sua equipe receba **mensagens e perguntas de compradores** diretamente no painel de atendimento como tickets. Com essa integração, todas as interações de compradores realizadas em seus anúncios no Mercado Livre passam a ser centralizadas no Z-PRO, evitando a necessidade de monitorar múltiplas plataformas. {% hint style="warning" %} **Configuração global vs. por tenant:** os apps cadastrados aqui ficam disponíveis para todos os tenants. A conexão e o gerenciamento do número WABA de cada tenant é feito individualmente pelo Administrador em Configurações → Integrações {% endhint %} {% hint style="info" %} **Pré-requisitos:** * Uma conta ativa no **Mercado Livre** (vendedor). * Acesso ao **Portal de Desenvolvedores do Mercado Livre** (). * Acesso de **Super Admin** na sua instalação do Z-PRO. {% endhint %} {% hint style="info" %} **Páginas de referência das telas do admin:** [Configuração - Apps — Mercado Livre ](/configuracao-administrador/configuracoes-painel-admin/apps-configuracoes/mercado-livre-configuracao-apps.md) [Canal Mercado Livre](/configuracao-administrador/administracao-painel-admin/canais-de-comunicacao/canal-mercado-livre.md) {% endhint %} *** ### Como funciona a integração Após a configuração: * Cada **mensagem ou pergunta** enviada por um comprador através do Mercado Livre criará um **ticket** dentro do Z-PRO. * Sua equipe poderá responder os compradores diretamente do painel de atendimento. * O token de acesso é renovado **automaticamente** pelo Z-PRO. {% hint style="warning" %} **Atenção aos limites do Mercado Livre:** * O **token de acesso expira a cada 6 horas** e é renovado automaticamente pelo Z-PRO. * Mensagens de **pós-venda** possuem limite de **350 caracteres**. * Uma configuração **Global** (sem tenant) será aplicada a **todos os tenants** que não tiverem uma configuração própria. {% endhint %} *** ### Etapa 1: Criando o Aplicativo no Portal de Desenvolvedores do Mercado Livre Antes de configurar a integração no Z-PRO, é necessário criar um aplicativo no portal de desenvolvedores do Mercado Livre para obter as credenciais OAuth (**App ID** e **App Secret**). 1. Acesse o **DevCenter do Mercado Livre**: * 2. Faça login com sua conta do Mercado Livre. 3. Clique em **Criar novo aplicativo**. 4. Preencha os dados solicitados pelo Mercado Livre conforme o passo a passo oficial: * [Como criar uma aplicação no Mercado Livre](https://developers.mercadolivre.com.br/pt_br/crie-uma-aplicacao-no-mercado-livre) 5. Nos campos de configuração do app, utilize os valores **fixos** fornecidos pelo Z-PRO: * **Redirect URI:** `https://oauth.techprovider.com.br/callback.html` * **Webhook URL:** `https://oauth.techprovider.com.br/ml-webhook` {% hint style="danger" %} **Importante:** O **Redirect URI** e o **Webhook URL** devem ser cadastrados, **exatamente** como informados acima, no DevCenter do Mercado Livre. Qualquer divergência impedirá o funcionamento da integração. {% endhint %} 6. Após criar o aplicativo, copie e guarde: * **App ID (client\_id)** * **App Secret (client\_secret)** {% hint style="info" %} **Quer usar um domínio próprio (whitelabel)?** Caso você queira utilizar um domínio próprio para o OAuth em vez do `oauth.techprovider.com.br`, configure-o previamente em **`/oauth-dominio`** dentro do Z-PRO. {% endhint %} *** ### Etapa 2: Acessando o App Mercado Livre no Painel Super Admin Com o aplicativo criado no Mercado Livre e as credenciais em mãos, acesse o Z-PRO para iniciar a integração. 1. Faça login no Z-PRO com o usuário **Super Administrador** da sua instalação. 2. No menu lateral, localize a seção **Redes Sociais / Marketplace**. 3. Clique na opção **App Mercado Livre**. 4. Clique no botão **Novo App** para criar uma nova integração. *** ### Etapa 3: Definindo o Escopo da Integração (Global ou Tenant) Ao criar um novo app, defina o escopo: * **Global (todos os tenants):** A integração será aplicada para todos os tenants da instalação que não tiverem uma configuração própria. * **Tenant específico:** A integração será aplicada apenas para uma conta/empresa específica. {% hint style="warning" %} **Recomendação:** A configuração **Global** funciona como um fallback — qualquer tenant que **não tenha** uma configuração própria utilizará a global. Para clientes individuais (revendedores SaaS), o ideal é configurar **por tenant**. {% endhint %} *** ### Etapa 4: Preenchendo as Credenciais do Aplicativo Preencha o formulário **Novo App Mercado Livre** com as informações obtidas no DevCenter:
Clique em **Criar** para salvar a integração. {% hint style="info" %} O **Site ID** define o marketplace em que o app vai operar. Use **MLB** para Brasil, **MLA** para Argentina, **MLM** para México e assim por diante. {% endhint %} *** ### Etapa 5: Criando o Canal Mercado Livre no Painel Admin Após a integração estar criada no Super Admin, é necessário **vincular um canal** dentro do painel administrativo do tenant para que as mensagens cheguem como tickets. 1. Acesse o **painel administrativo** do Z-PRO da conta (tenant) integrada. 2. No menu lateral, vá em **Canais**. 3. Clique em **Adicionar Canal**. 4. Selecione o tipo **Mercado Livre,** de um nome e clique em **criar canal.** 5. ```
``` Após a criação do canal, clique em **"conectar"** e siga o fluxo de **autenticação OAuth**: você será redirecionado para o Mercado Livre para autorizar o acesso da sua conta de vendedor.
Após autorizar, o canal será criado e ficará **conectado**. A partir desse momento, todas as **mensagens e perguntas** enviadas por compradores nos seus anúncios do Mercado Livre passarão a chegar no Z-PRO como **tickets de atendimento**. *** ### Etapa 6: Atendimento dos Tickets do Mercado Livre Cada nova mensagem ou pergunta de comprador gera um ticket no Z-PRO, que pode ser respondido diretamente pelo painel de atendimento. * As mensagens chegam na **fila de tickets**, igual a qualquer outro canal. * O ticket conterá os dados do comprador e o contexto da pergunta/mensagem. * A resposta enviada pelo Z-PRO será entregue ao comprador no Mercado Livre. {% hint style="warning" %} **Limite de caracteres em pós-venda:** Mensagens enviadas após a finalização da compra (pós-venda) possuem um limite de **350 caracteres**. Mensagens mais longas serão rejeitadas pela API do Mercado Livre. {% endhint %} *** ### Resumo das Funcionalidades | Funcionalidade | Onde acessar | | ------------------------------------------ | ------------------------------------- | | Configurar integração com Mercado Livre | Super Admin > App Mercado Livre | | Criar canal de atendimento | Painel Admin > Canais > Mercado Livre | | Receber mensagens e perguntas como tickets | Atendimento (fila de tickets) | | Renovação automática do token | Automática (a cada 6 horas) | *** ### Encerramento Com a integração ativa, o Z-PRO passa a: * **Receber automaticamente** todas as mensagens e perguntas dos compradores do Mercado Livre. * **Centralizar o atendimento** em uma única plataforma omnichannel. * **Renovar tokens automaticamente** sem necessidade de intervenção manual. * **Permitir o uso de múltiplas contas** (uma por tenant) com integrações isoladas. Esta integração é ideal para vendedores que utilizam o Mercado Livre como canal de vendas e desejam unificar o atendimento dos compradores junto aos demais canais de comunicação (WhatsApp, Instagram, E-mail etc.). *** ### Possíveis Erros e Soluções #### Erro de autenticação OAuth ao criar o canal **Causa:** Redirect URI cadastrado incorretamente no DevCenter do Mercado Livre. **Solução:** Verifique se o **Redirect URI** está cadastrado **exatamente** como `https://oauth.techprovider.com.br/callback.html` no app do Mercado Livre. #### Mensagens não estão chegando como tickets **Causa:** Webhook URL incorreto ou canal não autorizado. **Solução:** 1. Confirme que o **Webhook URL** cadastrado no Mercado Livre é `https://oauth.techprovider.com.br/ml-webhook`. 2. Refaça o processo de autorização do canal no Painel Admin. #### Mensagem de pós-venda rejeitada **Causa:** A mensagem ultrapassou o limite de **350 caracteres** imposto pela API do Mercado Livre. **Solução:** Reduza o tamanho da mensagem ou divida o conteúdo em múltiplas mensagens. #### Configuração Global não está sendo aplicada para um tenant **Causa:** O tenant possui uma configuração própria que sobrepõe a Global. **Solução:** Remova a configuração específica do tenant ou ajuste-a conforme necessário. A Global só se aplica quando o tenant **não tem** configuração própria. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ajuda.zdg.com.br/configuracao-superadmin/redes-sociais-e-marketplaces/mercado-livre-superadmin.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.