Conta
Embed para agências
A sua agência oferece o Sellume inteiro aos seus clientes, com o seu nome, o seu logo, as suas cores e o seu domínio.
O seu cliente usa o mesmo app do Sellume, com as mesmas telas e etapas, mas com a marca da sua agência e no seu domínio. Não é um quadro colado no seu site: é o app inteiro, sem iframe. O Sellume lê o Mercado Livre do seu cliente pelo app do Mercado Livre da sua agência.
O embed não usa a API: chaves de API e avisos não valem para ele. Tudo se configura no portal do integrador.
Como começar#
O Início do portal mostra 6 etapas. "Abrir para os clientes" só fica disponível com as 6 verdes e com o contrato vigente aprovado:
- Chave e segredo do app conferem.
- Retorno da autorização confere.
- Permissões completas.
- Notificações chegando.
- Domínio no ar.
- Marca publicada.
As quatro primeiras vêm do app do Mercado Livre; as duas últimas, de marca e domínio.
App do Mercado Livre da agência#
- No DevCenter do Mercado Livre, crie um app com o nome e o logo da sua agência e as mesmas permissões do app oficial do Sellume, inclusive "Vendas e envios".
- No portal, em App do Mercado Livre, salve a chave (App ID) e o segredo e marque o aceite: "Autorizo o Sellume a usar este app em nome da agência".
- O segredo vai direto para o cofre e nunca é exibido (nem para a equipe do Sellume): o portal mostra só os 4 últimos caracteres.
- Conecte uma conta de teste da agência pelo próprio portal. As verificações rodam na hora.
| Verificação | Fica verde quando | Como corrigir |
|---|---|---|
| Chave e segredo conferem | a autorização de teste com a conta da agência funciona; a renovação periódica do acesso confere o segredo de novo | copie de novo a chave e o segredo do DevCenter e salve; se trocou o segredo lá, salve o novo |
| Retorno confere | a autorização de teste volta para o seu domínio | no DevCenter, cadastre a URL de retorno https://<seu-domínio>/retorno/mercado-livre |
| Permissões completas | anúncio, descrição, perguntas e avaliações de um anúncio da conta de teste são lidos | marque no DevCenter as mesmas permissões do app oficial; erro em avaliações quer dizer que falta "Vendas e envios". Reconecte a conta de teste. Nada é importado pela metade |
| Notificações chegando | chega a primeira notificação válida com o número do seu app | no DevCenter, cadastre a URL de notificações https://<seu-domínio>/avisos/mercado-livre |
As verificações repetem a cada 6 horas e quando uma leitura falha. Se o segredo for revogado ou trocado no DevCenter sem atualizar o portal, a importação do app para (o que já foi lido continua), e a agência recebe alerta e e-mail na hora. Uma conta do cliente com acesso vencido pede só a reconexão daquela conta.
Marca e domínio#
Domínio. No seu DNS, aponte um subdomínio com CNAME para cname.vercel-dns.com (ou um registro A para 76.76.21.21, se for o domínio raiz). O HTTPS é automático. O portal confere o DNS e o certificado.
Marca. Salva em versões; você publica quando estiver pronta.
- 4 cores livres: primária, fundo, texto e destaque. O texto sobre o destaque é calculado.
- Contraste mínimo, conferido no servidor: texto sobre fundo, branco sobre a primária e texto sobre o destaque com 4,5:1 ou mais; destaque sobre a primária com 3:1 ou mais. Abaixo disso a versão é recusada (fica no histórico).
- Logo da agência.
- Nome exibido e contato: não podem conter "sellume".
- Os seus clientes ficam presos ao seu domínio e à sua organização: ninguém de fora entra num domínio de agência, e o seu cliente não entra por outro endereço.
Clientes e créditos#
Clientes. No portal você cadastra, edita, pausa e remove clientes.
- O cadastro gera um convite por link de uso único, mostrado uma vez e válido por 7 dias. Quem envia o link é a agência.
- Nova senha também por link, válido por 24 horas.
- O cliente final não recebe nenhum e-mail do Sellume, não vê preço, checkout nem teste grátis.
Planos dos seus clientes. Você cria planos próprios, só com créditos por mês e limite de anúncios, sem preço (o preço é entre você e o seu cliente). O teto de anúncios por cliente vem do seu plano Embed.
Distribuição real de créditos. Os créditos que você dá a cada cliente saem da carteira da agência e nunca passam do disponível (saldo da carteira menos o que já está distribuído e não foi usado):
- O não usado volta quando você reduz ou remove. Não dá para reduzir abaixo do que o cliente já usou (mais o que está em andamento).
- A distribuição renova a cada ciclo da agência, na ordem que você definir. Quem não couber fica com o que der, e você é avisado.
- Pacote avulso (e cortesia) aumentam o disponível na hora.
A sua cobrança. O Sellume cobra só a agência: plano Embed mensal pago antes (Sellume Embed Base, Growth, Business e Enterprise), pacote avulso que não vence, subida de plano na hora (pedida ao suporte; plano novo cobrado inteiro, ciclo recomeça no dia, saldo mantido) e descida no próximo ciclo — como em Planos e cobrança. Valores definidos no contrato.
Planos dos seus clientes e crédito extra. A soma dos planos (créditos/mês) de todos os seus clientes nunca passa dos créditos mensais do seu plano — é o que renova todo mês para eles. O pacote avulso não entra nessa soma: ele vira crédito extra que você dá a um cliente só naquele mês (se sobrar, volta para você na renovação) ou deixa guardado (não vence).
Suporte#
- O suporte do cliente final é da agência. O app mostra o contato que você cadastrou na marca.
- A agência fala com o Sellume pelo portal.
- Se o Sellume precisar pausar o embed ou bloquear um domínio, a agência recebe o motivo por e-mail. Com o embed pausado, os clientes veem uma tela neutra e o portal continua funcionando.
Mudanças#
O histórico completo está em Mudanças. Entradas do embed:
- 11/10/2026 — Embed para agências: app do Mercado Livre da agência, domínio e marca, clientes com distribuição real de créditos e planos Embed pagos antes.