AutoCerto
O AutoCerto é o NicoApp de integração com o sistema AutoCerto (integracao.autocerto.com), usado por revendas de veículos para gestão de estoque. Com ele, seu bot consulta marcas, m
Nota
Disponível na aba de NicoApps. Base da integração: API oficial AutoCerto (integracao.autocerto.com).
Como obter as credenciais de acesso
O app pede apenas dois campos na instalação: Username e Password. Pelo Swagger oficial da AutoCerto, a API usa OAuth2 com fluxo "password" (endpoint /oauth/token): o sistema troca esse usuário e senha por um token de acesso automaticamente — você não precisa gerar nem colar um token manualmente, só informar o login.
Atenção
A AutoCerto não publica um guia de autoatendimento para gerar o usuário/senha de integração. Tudo indica que é o mesmo login usado no sistema da loja, mas confirme com a AutoCerto o caminho oficial e se o contrato da loja inclui acesso à API.
Recomendação de caminho:
- Entre em contato com o suporte da AutoCerto (suporte@autocerto.com) ou com o gerente de conta/comercial da loja e peça a liberação/confirmação do acesso à API de integração (integracao.autocerto.com), informando que o uso será via integração externa (chatbot).
- Pergunte explicitamente se o usuário e senha de login do sistema AutoCerto (o mesmo do painel em admin.autocerto.com) servem para a API, ou se a loja precisa de uma credencial de integração separada.
- Antes de configurar no NicoChat, você pode testar as credenciais direto na documentação Swagger (integracao.autocerto.com/swagger/ui/index), usando o botão de autorização (OAuth2/cadeado) com o usuário e senha — se autenticar e listar o estoque por lá, as mesmas credenciais funcionam no app.
- Se a loja tiver mais de uma unidade vinculada ao mesmo login, use o campo opcional Unidade nas ações para filtrar/direcionar por loja.
Nota
A credencial é validada na primeira ação executada. Se uma ação falhar com erro de autorização, confira o Username e o Password na configuração do app antes de suspeitar de outro problema.
Limitações
Atenção
Limite de requisições (rate limit) não é divulgado publicamente pela AutoCerto. Confirme com o suporte ou gerente de conta se existe algum teto de requisições para o contrato da loja antes de dimensionar fluxos de alto volume.
- Estoques grandes: a resposta de Obter Estoque e Obter Placa é limitada a cerca de 20.000 caracteres antes de ser gravada na variável do fluxo (proteção do próprio NicoChat contra payloads gigantes, não um limite da AutoCerto). Em lojas com estoque muito grande, use os filtros (marca, modelo, ano, preço, unidade) para não perder veículos na resposta.
- Criar Lead usa formato diferente das demais ações: o corpo da requisição é enviado como
application/x-www-form-urlencoded, não como JSON. Isso é transparente para quem usa o app, mas é relevante para depuração de erros de payload. - Código do Interesse é uma lista fixa da AutoCerto (0KM, Seminovos, Compras, Pós-Venda) com numeração não sequencial (1, 2, 8, 9, 10) — os números "pulados" são assim mesmo na origem, não é erro do app.
O que o miniapp faz
Ação
O que faz
Entradas principais
Saídas
Obter Estoque
Lista o estoque de veículos da loja, com filtros opcionais
Unidade (se houver mais de uma loja), ID da Marca, ID do Modelo, Ano mínimo/máximo, Preço mínimo/máximo — todos opcionais
Veículos Encontrados (JSON/array)
Obter Marcas
Lista as marcas de veículos e seus IDs
— (sem entrada)
Marcas (JSON/array)
Obter Modelos
Lista os modelos de uma marca e seus IDs
Código da Marca (obrigatório)
Modelos (JSON/array)
Obter Versões
Lista as versões de um modelo/ano e seus IDs
Código do Modelo, Ano do Modelo (ambos obrigatórios)
Versões (JSON/array)
Obter Veículo
Traz todos os detalhes de um veículo pelo ID
ID do Veículo (obrigatório)
Marca, Modelo, Versão, Ano Fabricação/Modelo, Km, Cor, Combustível, Câmbio, Preço, Preço Classificados, Placa, Portas, Renavam, Chassi, Observação, URL do Vídeo, Opcionais (array), Fotos (array)
Obter Placa
Busca um veículo pela placa e já devolve os detalhes completos (encadeia com Obter Veículo)
Placa (obrigatório)
ID do Veículo + os mesmos campos completos de Obter Veículo
Criar Lead
Registra um lead/interessado na AutoCerto
Mídia (obrigatório); Unidade, Interesse, ID do Veículo, Nome, E-mail, Telefone, Telefone2, Mensagem, Descrição do Veículo, Placa, CPF, CEP (opcionais)
ID do Lead
Dicas e observações
- Obter Placa encadeia com Obter Veículo: internamente, a ação busca o veículo no estoque filtrando pela placa, pega o ID retornado e já chama Obter Veículo automaticamente — por isso a resposta traz o cadastro completo do veículo, não apenas o ID. Não é preciso chamar as duas ações manualmente.
- Criar Lead envia form-urlencoded, não JSON: se for investigar um erro de payload nessa ação específica, lembre que o corpo vai como
application/x-www-form-urlencoded(com o headerContent-Typecorrespondente), diferente das ações de consulta. - Selects dinâmicos: os campos de Unidade e Mídia carregam as opções direto da conta AutoCerto depois de instalar o app com as credenciais.
- Marcas, Modelos e Versões reaproveitam a mesma variável de retorno: leia o resultado de cada ação logo em seguida, antes de encadear a próxima chamada (Marcas → Modelos → Versões), para não sobrescrever o dado que ainda precisa ser lido.
- Tratamento de erros: quando a AutoCerto recusa uma operação (ex.: placa inexistente, veículo não encontrado, credencial inválida), a ação falha e devolve a mensagem de erro real da API — use o caminho de erro do bloco para tratar no fluxo.
- Unidade é opcional na maioria das ações: só preencha quando a credencial tiver acesso a mais de uma loja.