Preguntas frecuentes - Técnico

Respuestas a preguntas técnicas frecuentes sobre la API, integraciones y arquitectura de SalesOS.

API

¿Cuál es la URL base de la API?

La URL base de la API de producción es:

https://api.play2sell.com/v1

Consulta la documentación de la API para más detalles.

¿Cómo obtengo un token de acceso?

SalesOS usa OAuth/JWT para autenticación. Puedes obtener un token vía:

Client Credentials: Para integraciones servidor a servidor
Authorization Code: Para aplicaciones con interfaz de usuario

Consulta la guía de autenticación para instrucciones detalladas.

¿Cuáles son los límites de la API?

Los límites dependen de tu plan:

Starter: 100 solicitudes/minuto
Business: 500 solicitudes/minuto
Enterprise: 2,000 solicitudes/minuto

Los headers de respuesta incluyen información sobre tu uso actual.

¿La API soporta filtrado y paginación?

Sí, todos los endpoints de listado soportan paginación (page, per_page) y filtros específicos por recurso. Consulta la documentación de cada endpoint para los parámetros disponibles.

Integraciones

¿Qué integraciones están disponibles?

SalesOS ofrece:

API REST para integraciones directas
Webhooks para eventos en tiempo real
SalesOS Pay para facturación y NFS-e
Posibilidad de crear integraciones personalizadas

¿Cómo configuro webhooks?

Registra tu endpoint en la API:

POST /v1/webhooks
{
  "url": "https://tu-servidor.com/webhook",
  "events": ["lead.created", "opportunity.won"]
}

Consulta la guía de webhooks para más detalles.

¿SalesOS Connect requiere instalación?

Cualquier herramienta capaz de hacer solicitudes HTTP firmadas funciona: cree una API key, firme las solicitudes como se describe en Autenticación y suscríbase a los webhooks de los eventos que le interesen.

¿Puedo integrar SalesOS con mi ERP?

Sí. SalesOS Pay cubre la emisión de NFS-e y conciliación. Para integrar con tu propio ERP usa la API REST, webhooks o SalesOS Connect.

Seguridad y datos

¿Qué tipo de encriptación usa SalesOS?

Comunicaciones: TLS 1.3 para todas las conexiones
Datos en reposo: Encriptación AES-256
Autenticación: Tokens JWT firmados con RS256

¿Dónde se almacenan los datos?

Los datos se almacenan en infraestructura de nube con alta disponibilidad y backups regulares. Los datos son aislados por empresa (multi-tenant con Row Level Security).

¿Hay un SLA de disponibilidad?

El plan Enterprise incluye un SLA con garantía de 99.9% de disponibilidad. Los planes Starter y Business no incluyen SLA formal pero operamos con el mismo nivel de compromiso.

Para preguntas técnicas más específicas, contacta a nuestro equipo de soporte técnico en suporte@play2sell.com.