Visão Geral da API

Bem-vindo ao Guia Técnico da Perpetuus API. Toda a inteligência e funcionalidade que você encontra em nossa interface web — boards, cards, contatos, relatórios analíticos, automações e inteligência de atendimento — está acessível programaticamente.

Nossa API segue os princípios RESTful, consumindo e retornando payloads em formato JSON e utilizando códigos de status HTTP padrão para indicar o sucesso ou falha das operações.

Acesso e URL Base

Toda a interação com a API pública do Perpetuus deve ser direcionada para a URL base oficial:

https://api.perpetuus.com.br/api

Casos de Uso Comuns para Desenvolvedores

Com a Perpetuus API, você pode integrar facilmente o CRM ao ecossistema da sua empresa:

• Sincronização de Leads (Inbound): Capture contatos de formulários proprietários, landing pages externas ou sistemas parceiros e envie diretamente para uma fase específica de um Board.
• Integração de BI e ETL: Extraia dados linha a linha de cards e logs de atividades para alimentar Power BI, Looker Studio ou bancos de dados analíticos locais.
• Automação Comercial: Conecte o CRM a sistemas de faturamento e ERPs para iniciar e acompanhar cotações ou gerar orçamentos comerciais em PDF de forma programática.
• Agentes de IA: Conecte LLMs e assistentes de voz ao CRM utilizando nosso protocolo unificado MCP (Model Context Protocol).

Próximos Passos

1. Autenticação e Multi-Tenancy: Aprenda a obter o seu token de longa duração e configure os headers necessários.
2. Convenções de URL e Dados: Entenda como a API mapeia os recursos usando documentId e quais os formatos padrão de resposta.
3. API Reference: Explore interativamente a especificação OpenAPI completa de cada endpoint com try-it-out.