AutoCerto
AutoCerto es el NicoApp de integración con el sistema AutoCerto (integracao.autocerto.com), usado por concesionarias de vehículos para la gestión de inventario. Con él, tu flujo consulta marcas, modelos y vehículos del inventario.
Nota
Disponible en la pestaña de NicoApps. Base de la integración: API oficial de AutoCerto (integracao.autocerto.com).
Cómo obtener las credenciales de acceso
La app solicita solo dos campos en la instalación: Username y Password. Según el Swagger oficial de AutoCerto, la API usa OAuth2 con flujo "password" (endpoint /oauth/token): el sistema intercambia ese usuario y contraseña por un token de acceso automáticamente — no necesitas generar ni pegar un token manualmente, solo informar el inicio de sesión.
Atención
AutoCerto no publica una guía de autoservicio para generar el usuario/contraseña de integración. Todo indica que es el mismo inicio de sesión usado en el sistema de la tienda, pero confirma con AutoCerto cuál es el camino oficial y si el contrato de la tienda incluye acceso a la API.
Camino recomendado:
- Ponte en contacto con el soporte de AutoCerto (suporte@autocerto.com) o con el gerente de cuenta/comercial de la tienda y solicita la liberación/confirmación del acceso a la API de integración (integracao.autocerto.com), informando que el uso será mediante una integración externa (chatbot).
- Pregunta explícitamente si el usuario y la contraseña de inicio de sesión del sistema AutoCerto (el mismo del panel en admin.autocerto.com) sirven para la API, o si la tienda necesita una credencial de integración separada.
- Antes de configurar en NicoChat, puedes probar las credenciales directamente en la documentación Swagger (integracao.autocerto.com/swagger/ui/index), usando el botón de autorización (OAuth2/candado) con el usuario y la contraseña — si autentica y lista el inventario allí, las mismas credenciales funcionan en la app.
- Si la tienda tiene más de una unidad vinculada al mismo inicio de sesión, usa el campo opcional Unidade en las acciones para filtrar/dirigir por tienda.
Nota
La credencial se valida en la primera acción ejecutada. Si una acción falla con error de autorización, revisa el Username y el Password en la configuración de la app antes de sospechar de otro problema.
Limitaciones
Atención
El límite de solicitudes (rate limit) no es divulgado públicamente por AutoCerto. Confirma con el soporte o con el gerente de cuenta si existe algún tope de solicitudes para el contrato de la tienda antes de dimensionar flujos de alto volumen.
- Inventarios grandes: la respuesta de Obter Estoque y Obter Placa está limitada a cerca de 20.000 caracteres antes de guardarse en la variable del flujo (protección del propio NicoChat contra payloads gigantes, no un límite de AutoCerto). En tiendas con un inventario muy grande, usa los filtros (marca, modelo, año, precio, unidad) para no perder vehículos en la respuesta.
- Criar Lead usa un formato diferente al de las demás acciones: el cuerpo de la solicitud se envía como
application/x-www-form-urlencoded, no como JSON. Esto es transparente para quien usa la app, pero es relevante para la depuración de errores de payload. - Código do Interesse es una lista fija de AutoCerto (0KM, Seminovos, Compras, Pós-Venda) con numeración no secuencial (1, 2, 8, 9, 10) — los números "saltados" son así en el origen, no es un error de la app.
Qué hace el NicoApp
Acción
Qué hace
Entradas principales
Salidas
Obter Estoque
Lista el inventario de vehículos de la tienda, con filtros opcionales
Unidade (si hay más de una tienda), ID da Marca, ID do Modelo, Ano mínimo/máximo, Preço mínimo/máximo — todos opcionales
Veículos Encontrados (JSON/array)
Obter Marcas
Lista las marcas de vehículos y sus IDs
— (sin entrada)
Marcas (JSON/array)
Obter Modelos
Lista los modelos de una marca y sus IDs
Código da Marca (requerido)
Modelos (JSON/array)
Obter Versões
Lista las versiones de un modelo/año y sus IDs
Código do Modelo, Ano do Modelo (ambos requeridos)
Versões (JSON/array)
Obter Veículo
Trae todos los detalles de un vehículo por el ID
ID do Veículo (requerido)
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 un vehículo por la placa y ya devuelve los detalles completos (se encadena con Obter Veículo)
Placa (requerido)
ID do Veículo + los mismos campos completos de Obter Veículo
Criar Lead
Registra un lead/interesado en AutoCerto
Mídia (requerido); Unidade, Interesse, ID do Veículo, Nome, E-mail, Telefone, Telefone2, Mensagem, Descrição do Veículo, Placa, CPF, CEP (opcionales)
ID do Lead
Consejos y observaciones
- Obter Placa se encadena con Obter Veículo: internamente, la acción busca el vehículo en el inventario filtrando por la placa, toma el ID devuelto y ya llama a Obter Veículo automáticamente — por eso la respuesta trae el registro completo del vehículo, no solo el ID. No es necesario llamar a las dos acciones manualmente.
- Criar Lead envía form-urlencoded, no JSON: si vas a investigar un error de payload en esta acción específica, recuerda que el cuerpo va como
application/x-www-form-urlencoded(con el headerContent-Typecorrespondiente), a diferencia de las acciones de consulta. - Selects dinámicos: los campos Unidade y Mídia cargan las opciones directamente de la cuenta AutoCerto después de instalar la app con las credenciales.
- Marcas, Modelos y Versões reutilizan la misma variable de retorno: lee el resultado de cada acción justo después, antes de encadenar la siguiente llamada (Marcas → Modelos → Versões), para no sobrescribir el dato que aún necesitas leer.
- Tratamiento de errores: cuando AutoCerto rechaza una operación (ej.: placa inexistente, vehículo no encontrado, credencial inválida), la acción falla y devuelve el mensaje de error real de la API — usa el camino de error del bloque para tratarlo en el flujo.
- Unidade es opcional en la mayoría de las acciones: complétalo solo cuando la credencial tenga acceso a más de una tienda.