FAQ Técnico
Dúvidas comuns sobre a API, integrações e aspectos técnicos do SalesOS.Qual é a URL base da API?
Qual é a URL base da API?
A URL base é
https://api.play2sell.com. Todos os endpoints seguem o padrão /v1/recurso.Como obtenho um token de autenticação?
Como obtenho um token de autenticação?
Use o fluxo Client Credentials do Auth0 com seu Client ID e Secret. Faça um POST para
https://auth.play2sell.com/oauth/token com as credenciais. Consulte o guia de autenticação para detalhes.Qual o rate limit da API?
Qual o rate limit da API?
O limite é de 100 requisições por minuto por token. Ao exceder, a API retorna
429 Too Many Requests com o header Retry-After indicando quando tentar novamente.Os tokens JWT expiram?
Os tokens JWT expiram?
Sim. Access tokens expiram em 24 horas. Implemente renovação automática na sua aplicação para evitar interrupções.
Posso usar webhooks para integrar com outros sistemas?
Posso usar webhooks para integrar com outros sistemas?
Sim. Configure webhooks em Configurações > Integrações > Webhooks. O SalesOS envia requisições HTTP POST para sua URL quando eventos ocorrem (lead criado, deal ganho, etc.).
A API suporta CORS?
A API suporta CORS?
A API suporta CORS para domínios autorizados. Para aplicações frontend, é necessário cadastrar o domínio em Configurações > API > Domínios autorizados.
Quais formatos de data a API aceita?
Quais formatos de data a API aceita?
A API utiliza o formato ISO 8601 para datas:
2026-03-15T14:30:00Z. Datas sem horário devem usar o formato 2026-03-15.Como funciona a paginação?
Como funciona a paginação?
Endpoints de lista suportam
?page=1&per_page=20. A resposta inclui um objeto pagination com total, total_pages, page e per_page.Posso fazer integrações sem programar?
Posso fazer integrações sem programar?
Sim. Use o SalesOS Connect (n8n) para criar automações visuais arrastando e conectando nós. Não requer conhecimento de programação.
A API está disponível em todos os planos?
A API está disponível em todos os planos?
Não. A API REST está disponível apenas nos planos Professional e Enterprise. O plano Starter inclui apenas integrações básicas via webhooks.