> ## Documentation Index
> Fetch the complete documentation index at: https://docs.play2sell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ Técnico

> Perguntas frequentes sobre API, integrações e aspectos técnicos do SalesOS.

# FAQ Técnico

Dúvidas comuns sobre a API, integrações e aspectos técnicos do SalesOS.

<AccordionGroup>
  <Accordion title="Qual é a URL base da API?">
    A URL base é `https://api.play2sell.com`. Todos os endpoints seguem o padrão `/v1/recurso`.
  </Accordion>

  <Accordion title="Como obtenho um token de autenticação?">
    Use o fluxo OAuth Client Credentials 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](/pt/api/authentication) para detalhes.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="Os tokens JWT expiram?">
    Sim. Access tokens expiram em 24 horas. Implemente renovação automática na sua aplicação para evitar interrupções.
  </Accordion>

  <Accordion title="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.).
  </Accordion>

  <Accordion title="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**.
  </Accordion>

  <Accordion title="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`.
  </Accordion>

  <Accordion title="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`.
  </Accordion>

  <Accordion title="Posso fazer integrações sem programar?">
    Sim. Use o [SalesOS Connect (n8n)](/pt/api/integrations/n8n) para criar automações visuais arrastando e conectando nós. Não requer conhecimento de programação.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Mais perguntas

<CardGroup cols={2}>
  <Card title="API Overview" icon="code" href="/pt/api/overview">
    Documentação completa da API.
  </Card>

  <Card title="Erros de Integração" icon="triangle-exclamation" href="/pt/support/troubleshooting/integrations">
    Soluções para problemas de integração.
  </Card>
</CardGroup>