# Metricaas

> API do Metricaas — leads, vendas e atribuição de origem do WhatsApp.

## Docs

- [Detalha um lead](https://docs.metricaas.com.br/api-reference/leads/detalha-um-lead.md)
- [Lista leads](https://docs.metricaas.com.br/api-reference/leads/lista-leads.md)
- [Quem é este token](https://docs.metricaas.com.br/api-reference/sessão/quem-é-este-token.md): Devolve a empresa, o papel, as capacidades efetivas e os **escopos de dados** do token.
- [Lista vendas](https://docs.metricaas.com.br/api-reference/vendas/lista-vendas.md)
- [Registra uma venda](https://docs.metricaas.com.br/api-reference/vendas/registra-uma-venda.md): Cria a venda e move o lead para a etapa de ganho.
- [Remove uma venda](https://docs.metricaas.com.br/api-reference/vendas/remove-uma-venda.md): O lead **não** volta de etapa: ele pode ter outras vendas, e adivinhar a etapa anterior seria inventar histórico. Mova o lead explicitamente se quiser desfazer o ganho.
- [Autenticação](https://docs.metricaas.com.br/autenticacao.md): Bearer token, modos de acesso e por que a permissão pode mudar sozinha.
- [Erros e paginação](https://docs.metricaas.com.br/conceitos/erros-e-paginacao.md): RFC 7807, por que 404 no lugar de 403, e cursor no lugar de offset.
- [Leads e origem](https://docs.metricaas.com.br/conceitos/leads-e-origem.md): Como o Metricaas descobre de onde a pessoa veio, e o que isso significa no payload.
- [Vendas](https://docs.metricaas.com.br/conceitos/vendas.md): Várias por lead, data da compra e idempotência de webhook.
- [Introdução](https://docs.metricaas.com.br/introducao.md): O que a API do Metricaas resolve e o que ela deliberadamente não faz.
- [Conectar esta doc ao seu agente (MCP)](https://docs.metricaas.com.br/mcp.md): Deixe o Claude, o Cursor ou o ChatGPT lerem esta documentação enquanto escrevem a sua integração.
- [Primeiros passos](https://docs.metricaas.com.br/primeiros-passos.md): Do token à primeira venda registrada, em três chamadas.
- [Hotmart → Metricaas com N8N](https://docs.metricaas.com.br/receitas/registrar-venda-da-hotmart.md): Do postback da Hotmart à venda no funil, em três nós.

## OpenAPI Specs

- [openapi](https://docs.metricaas.com.br/openapi.yaml)