Perguntas frequentes

Preciso ser desenvolvedor para usar a API?

Não necessariamente. Com Zapier, Make ou n8n você conecta o Perpetuus a outras ferramentas sem escrever código. Para capturar leads do site, o formulário público resolve sem backend.

Quem pode gerar tokens de API?

Qualquer usuário autenticado pode gerar um token com as suas próprias permissões. O token herda o papel do usuário na organização — um operador não consegue, via API, fazer nada além do que já faz na interface.

O token dá acesso a todas as minhas organizações?

O token identifica o usuário; a organização é definida em cada requisição pelo header x-tenant-id. Você só acessa organizações das quais é membro.

Existe limite de requisições?

Endpoints sensíveis (geração de token, disparo de campanhas) têm rate limit reforçado. Para listagens, o pageSize máximo é 100 — use paginação para volumes maiores.

Posso disparar ações automáticas?

Sim — o módulo de Automações do Perpetuus reage a eventos (card criado, fase alterada, mensagem recebida) e pode executar ações, incluindo chamadas HTTP para sistemas externos. Configure em Automações no app.

Como alimento meu BI (Power BI, Looker, Metabase)?

Use GET /boards/{boardId}/cards para dados linha a linha e GET /boards/{boardId}/report para métricas agregadas. O passo a passo completo está em Relatórios e BI.

E se eu excluir algo por engano via API?

Exclusões via API são definitivas, como na interface. Atenção especial a DELETE /boards/{id} (remove o board e os cards) e às operações em massa de contatos. Teste sempre em um board de sandbox primeiro.

Onde vejo todos os endpoints?

Na API Reference — referência interativa com exemplos de request e resposta para todas as operações disponíveis.