Saltar al contenido principal

​
Errores de integración

Guía para diagnosticar y resolver problemas comunes con las integraciones de SalesOS, incluyendo API, webhooks y SalesOS Connect.

​
Errores de API

Causa: Token de acceso inválido, expirado o ausente.Soluciones:
  1. Verifica que estás incluyendo el header Authorization: Bearer TU_TOKEN
  2. Comprueba que el token no ha expirado (revisa el campo exp del JWT)
  3. Solicita un nuevo token usando tu refresh token
  4. Verifica que las credenciales de Auth0 sean correctas
Causa: El token es válido pero no tiene permisos suficientes.Soluciones:
  1. Verifica los scopes de tu token (ejemplo: read:leads, write:leads)
  2. Asegúrate de que tu usuario tiene el rol necesario para la operación
  3. Solicita los scopes necesarios al generar el token
Causa: Has superado el límite de solicitudes por minuto.Soluciones:
  1. Revisa los headers X-RateLimit-* para conocer tu uso
  2. Implementa una cola de solicitudes con backoff exponencial
  3. Optimiza tus llamadas para reducir la cantidad de solicitudes
  4. Considera actualizar tu plan para obtener un límite mayor
Causa: Error en el servidor de SalesOS.Soluciones:
  1. Espera unos minutos y reintenta la solicitud
  2. Verifica si hay un incidente activo en la página de status
  3. Si el error persiste, contacta al soporte técnico con los detalles de la solicitud

​
Problemas con webhooks

Verificaciones:
  1. Confirma que el webhook está activo en la configuración
  2. Verifica que la URL del endpoint es accesible públicamente
  3. Comprueba que tu servidor responde con código 200
  4. Revisa los logs de tu servidor para ver si las solicitudes están llegando
  5. Verifica que suscribiste los eventos correctos
SalesOS desactiva webhooks después de 5 intentos fallidos de entrega.Solución:
  1. Verifica y corrige el problema en tu endpoint
  2. Reactiva el webhook desde la configuración
  3. Implementa un manejo correcto de errores que responda 200
Verificaciones:
  1. Usa el cuerpo raw de la solicitud (no el parseado) para verificar la firma
  2. Verifica que estás usando el secreto correcto
  3. Asegúrate de usar HMAC-SHA256 para el cálculo

​
Problemas con SalesOS Connect (n8n)

  1. Verifica que el workflow está activo (no solo guardado)
  2. Comprueba las credenciales de SalesOS en n8n
  3. Revisa el log de ejecuciones para identificar errores
  4. Verifica que el trigger está configurado correctamente
  1. Actualiza las credenciales de SalesOS en n8n
  2. Genera un nuevo token de acceso si el actual expiró
  3. Verifica que el token tiene los scopes necesarios

​
Problemas con Omie ERP

  1. Verifica que las credenciales de Omie (App Key y App Secret) son correctas
  2. Comprueba que los datos del cliente están completos (CNPJ/CPF, razón social)
  3. Verifica si el cliente ya existe en Omie (duplicado)
  1. Revisa los datos fiscales de tu empresa (CNPJ, inscripción municipal)
  2. Verifica el código de servicio utilizado
  3. Comprueba los datos del tomador del servicio
  4. Consulta el mensaje de error específico devuelto por la prefectura
Al reportar un error de integración al soporte, incluye: el endpoint utilizado, el método HTTP, los headers de la respuesta y el cuerpo de la respuesta de error.
Para soporte técnico con integraciones, contacta a suporte@play2sell.com con los detalles del error.