AutoCerto
Esta página do wiki foi descontinuada e pode estar desatualizada. A documentação oficial e atualizada do NicoChat está em docs.nicochat.com/p/466-autocerto. Consulte sempre o link acima — o conteúdo abaixo é mantido apenas como histórico.
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, modelos, versões e estoque, busca um veículo pela placa e cria leads — tudo direto do fluxo do NicoChat.
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.
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.
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
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.