Importar um catálogo de carros no Telegram
Três colunas são obrigatórias, mais quinze moldam o card, as fotos vão por URL. O que o importador confere, o que recusa e a única coisa que ele não faz.
Em resumo. O importador aceita um CSV ou XLSX, confere linha a linha sem criar nada, mostra o que falhou e só escreve anúncios quando você confirma. Três colunas são obrigatórias — marca, modelo, ano — e mais quinze decidem o quanto o card de fato diz. As fotos chegam como URLs separadas por uma barra vertical, no máximo trinta por anúncio. O limite é aplicado na confirmação: três anúncios ativos no plano gratuito, cinquenta no Pro. E o que vale saber antes de começar: isto é um empurrão único, não um feed sincronizado.
Os carros já estão numa planilha. Alguém exportou do sistema que você usa, ou você digitou, e agora há quarenta linhas e uma pasta de fotos. Esta página é sobre colocar isso num catálogo do Telegram sem descobrir os problemas um anúncio por vez.
Comece pelo modelo
Baixe o modelo — CSV ou XLSX, o que a sua ferramenta abrir sem reclamar. É uma linha de cabeçalho e um anúncio de exemplo, e os nomes de coluna dele são os que o analisador procura.
Você não precisa usá-lo. Você precisa bater com os nomes das colunas, e o modelo é simplesmente o jeito mais curto de garantir isso.
As três colunas que não são opcionais
marca, modelo, ano. Uma linha sem qualquer uma delas falha na validação e não vira anúncio.
É uma régua deliberadamente baixa, e vale saber o quanto. Uma linha só com essas três é válida: ela importa e produz um card que diz uma marca, um modelo e um ano, e nada mais. Válido não é a mesma coisa que bom.
As quinze que decidem o que o card diz
Todo o resto é opcional, e cada uma que você deixa em branco é uma linha que o comprador não recebe:
mileage_km · transmission · drivetrain · body_type · fuel_type · engine_volume_l · condition · vin · city · price_amount · price_original_amount · price_currency · price_negotiable · description · photo_urls
Duas merecem destaque. price_original_amount é o preço antigo: preencha e o card poderá mostrar a queda em vez de só o número. price_negotiable é a marcação que responde à primeira pergunta de todo comprador antes que ele precise fazê-la.
Se for pular colunas, pule vin e drivetrain. Não pule city nem price_amount: são as duas que decidem se alguém te manda mensagem.
As fotos vão por URL
Coloque os endereços das imagens em photo_urls, separados por uma barra vertical:
https://example.com/photo-1.jpg | https://example.com/photo-2.jpgSão aceitas até 30 por anúncio; o que passar é ignorado em vez de dar erro. Os endereços precisam estar acessíveis na hora da importação — um link para arquivo atrás de login, ou um que expira, te dá um anúncio sem fotos e sem jeito de perceber pela planilha.
Se as fotos só existem no seu disco, suba-as para o anúncio depois da importação. Há uma tela de fotos por anúncio com arrastar para reordenar, e a primeira foto é a que viaja no card compartilhado.
Nada é criado até você mandar
A importação tem dois passos, e a separação importa.
Analisar lê o arquivo e devolve cada linha com os próprios erros de validação. Não cria absolutamente nada. Você recebe uma tela de revisão mostrando quais linhas estão certas e o que exatamente está errado nas outras, então corrige o arquivo uma vez em vez de apagar anúncios ruins depois.
Confirmar é o que escreve. Até você apertar, seu catálogo continua intocado.
Vale usar direito: suba, leia os erros, corrija a planilha, suba de novo. Dois minutos ali ganham de uma tarde editando quarenta anúncios à mão.
O limite morde na confirmação, não no upload
Anúncios ativos são limitados por plano: 3 no gratuito, 50 no Pro. A confirmação verifica quanto espaço resta e para com um erro explícito e uma contagem se não houver.
Então subir quarenta carros no plano gratuito não é um erro que o sistema esconde de você — mas também não vai funcionar. Decida quais três valem estar no ar, ou vá para o Pro antes da importação, não depois.
O que isto não faz
Não segue sua origem. Isto é um empurrão único, não um feed. Não há URL que ele observe, nem atualização agendada, nada que perceba que sua planilha principal mudou. Vendeu um carro, você mesmo arquiva o anúncio; baixou um preço, edita ou importa de novo.
Para um catálogo que gira por mês, tudo bem. É um custo real se o estoque muda toda semana, e convém contar esse custo antes de mover doze meses de estoque.
Se… então…
| Se… | Então… |
|---|---|
| Você tem mais que um punhado de carros | Use o arquivo — na mão deixa de ser razoável perto de dez |
| Suas fotos já vivem num site | photo_urls é mais rápido que subir de novo |
| Suas fotos só estão no celular ou no disco | Importe as linhas primeiro e adicione fotos por anúncio depois |
| Você está no plano gratuito | Escolha seus três antes de subir, não depois do erro |
| Seu estoque gira toda semana | Nada aqui sincroniza — orce essa manutenção antes |
| Você vende dois ou três carros por ano | Pule o arquivo e crie na mão |
Por onde começar
Pegue dez linhas, não quarenta. Preencha as três colunas obrigatórias mais city, price_amount e photo_urls, e rode a análise. Leia o que ela diz sobre essas dez — os erros de um arquivo pequeno são os mesmos do grande, e saem muito mais baratos de ler.
Depois corrija a planilha, confirme essas dez e olhe os cards. Se o card diz o suficiente para alguém te mandar mensagem, acrescente as demais colunas e faça as linhas restantes. Se não diz, as linhas que faltam são exatamente as colunas que você pulou.
Para o que um catálogo de carros no Telegram é como produto, e quando um marketplace ainda ganha, veja vender carros no Telegram. Para montar, comece pela página de anúncios.
O que as pessoas costumam perguntar
- Que arquivo o importador aceita?
- CSV ou XLSX. Há um modelo para baixar em qualquer um dos dois formatos — uma linha de cabeçalho mais um anúncio de exemplo — e bater com as colunas dele é o caminho mais curto para uma importação limpa.
- Quais colunas são realmente obrigatórias?
- Três: marca, modelo e ano. Todo o resto é opcional, e cada coluna opcional que você pula é uma linha que o card não vai mostrar. Um anúncio só com os três campos obrigatórios é válido e parece o que é.
- Como as fotos entram?
- Por URL, numa coluna photo_urls, várias separadas por uma barra vertical. São aceitas até 30 por anúncio; o que passar disso é ignorado. As imagens precisam estar acessíveis nesses endereços na hora da importação.
- Dá para conferir o arquivo antes de criar qualquer coisa?
- Dá, e é justamente para isso que o fluxo tem dois passos. O passo de análise não cria nada: devolve cada linha com os próprios erros de validação para você corrigir o arquivo e subir de novo. Só o passo de confirmação escreve anúncios.
- O que acontece se eu tiver mais linhas do que o plano permite?
- A confirmação para com um 402 e informa a contagem: espaços gratuitos seguram 3 anúncios ativos e o Pro segura 50. Ele preenche o espaço que existe em vez de descartar o resto em silêncio, então confira o número antes de subir 40 carros num plano de 3.
- Ele fica sincronizado com meu arquivo de origem?
- Não. A importação é um empurrão único, não um feed. Quando um preço muda, você edita o anúncio ou importa de novo — não há URL que ele observe nem atualização agendada. Se seu estoque gira toda semana, leve isso em conta.