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

# Introdução

> O que a API do Metricaas resolve e o que ela deliberadamente não faz.

A API do Metricaas existe para **registrar no CRM o que acontece fora dele**.

O caso que a motivou: uma empresa vendendo por WhatsApp com checkout na Hotmart. O
Metricaas sabia de onde cada lead veio — anúncio, link ou orgânico — mas a venda
só entrava quando alguém lembrava de arrastar o card no funil. Num período de 26
dias, 55 clientes compraram e **12 vendas foram lançadas**. O ROAS era calculado
sobre 11% da receita real, e o Meta otimizava sem saber quem tinha comprado.

Com a API, a venda entra sozinha e o ciclo fecha.

## O que dá pra fazer

<CardGroup cols={2}>
  <Card title="Registrar vendas" icon="receipt" href="/conceitos/vendas">
    Uma chamada por compra, com a data real e o produto. Idempotente.
  </Card>

  <Card title="Ler leads e origem" icon="users" href="/conceitos/leads-e-origem">
    Qual anúncio, campanha e criativo trouxe cada pessoa.
  </Card>
</CardGroup>

## O que ela não faz — e não vai fazer

Estas operações estão fora da API **por decisão**, não por falta de tempo. O
critério: pode causar efeito irreversível fora do Metricaas?

* Enviar mensagem de WhatsApp ou Instagram
* Disparar conversão para o Meta (CAPI)
* Excluir lead ou apagar dados de uma empresa
* Criar usuário, mudar permissões ou escopos
* Ler ou escrever conexões, tokens de OAuth e segredos

Mandar mensagem para o lead errado não tem `ctrl+z`.

## Antes de começar

<Note>
  A API é **server-to-server**. Não há CORS, e o token não deve ir para o navegador
  em nenhuma hipótese — quem tiver o token tem o acesso da pessoa que o emitiu.
</Note>

Base: `https://app.metricaas.com.br/v1`

<Card title="Autenticação" icon="key" href="/autenticacao" horizontal>
  Como gerar o token e o que ele alcança.
</Card>

<Card title="Conectar esta doc ao seu agente" icon="plug" href="/mcp" horizontal>
  Servidor MCP público — o Claude ou o Cursor lê estas páginas enquanto escreve a
  sua integração.
</Card>