# Festero para desenvolvedores

> API de leitura, webhooks e servidor MCP para integrar os dados da sua empresa no Festero aos seus sistemas e a assistentes de IA.

Documentação da API pública do Festero. Cada página abaixo tem uma versão em Markdown na mesma rota, terminada em .md.

## Início

- [Festero para desenvolvedores](https://developers.festero.com.br/index.md): API de leitura, webhooks e servidor MCP para integrar os dados da sua empresa no Festero aos seus sistemas e a assistentes de IA.

## Primeiros passos

- [Introdução](https://developers.festero.com.br/introducao.md): O que a API do Festero faz, para quem é e quem pode criar uma credencial.
- [Início rápido](https://developers.festero.com.br/inicio-rapido.md): Crie a credencial, peça o token e faça a primeira chamada à API.
- [Autenticação](https://developers.festero.com.br/autenticacao.md): Como autenticar: credencial, client credentials, token de 60 minutos e escopos.
- [Limites de uso](https://developers.festero.com.br/limites.md): Limites de uso por plano, cabeçalhos de limite e como lidar com o erro 429.
- [Paginação e datas](https://developers.festero.com.br/paginacao.md): Como paginar listas, sincronizar só o que mudou e ler datas e valores em dinheiro.
- [Erros](https://developers.festero.com.br/errors.md): Formato dos erros da API do Festero (Problem Details), o requestId para o suporte e, para cada código, o que significa e o que fazer.
- [Versionamento](https://developers.festero.com.br/versionamento.md): Política de versões da API, avisos de descontinuação e histórico de mudanças.

## API

- [Conta](https://developers.festero.com.br/api/conta.md): Rotas de saúde e de identificação da credencial.
- [CRM](https://developers.festero.com.br/api/crm.md): Oportunidades de venda e etapas do funil.
- [Eventos](https://developers.festero.com.br/api/eventos.md): Os eventos da empresa e seus dados principais.
- [Orçamentos](https://developers.festero.com.br/api/orcamentos.md): Orçamentos com opções e itens.
- [Visitas](https://developers.festero.com.br/api/visitas.md): Visitas agendadas por clientes interessados.
- [Financeiro](https://developers.festero.com.br/api/financeiro.md): Recebíveis e resumo de vendas por período.

## Webhooks

- [Webhooks](https://developers.festero.com.br/webhooks.md): Como os webhooks funcionam: cadastro, entrega, reentregas e limites.
- [Eventos de webhook](https://developers.festero.com.br/webhooks/eventos.md): Os eventos de webhook, quando disparam e um exemplo de payload.
- [Verificar a assinatura](https://developers.festero.com.br/webhooks/assinatura.md): Como verificar a assinatura Festero-Signature em Node, Python e C#.

## Para agentes de IA

- [Servidor MCP](https://developers.festero.com.br/mcp.md): Conecte assistentes de IA aos dados do Festero pelo servidor MCP.

## Opcional

- [Referência interativa](https://developers.festero.com.br/referencia/): todas as rotas, parâmetros e respostas da API, para consultar e testar no navegador.
- [Documento OpenAPI](https://developers.festero.com.br/openapi.v1.json): a especificação OpenAPI da API em JSON.