Primeiros passos

Confirme o que o token alcança

curl https://app.metricaas.com.br/v1/me \
  -H "Authorization: Bearer $METRICAAS_TOKEN"

Olhe client.name (é a empresa certa?), mode (write se você vai registrar venda) e scopes (o token vê todos os canais?).

Ache o lead

curl "https://app.metricaas.com.br/v1/leads?stage=Novo%20Lead&limit=5" \
  -H "Authorization: Bearer $METRICAAS_TOKEN"

Guarde o id. É ele que a venda referencia.

Registre a venda

curl -X POST https://app.metricaas.com.br/v1/sales \
  -H "Authorization: Bearer $METRICAAS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "lead_id": "3df0cc9b-7627-4450-bb54-8a2cd9303fa2",
    "value": 67.00,
    "sold_at": "2026-08-07T11:49:12-03:00",
    "external_source": "hotmart",
    "external_id": "HP2346486658"
  }'

O lead vai para a etapa de ganho e a receita aparece no painel.

Os dois erros que todo mundo comete na primeira vez

422 em sold_at — 'ISO 8601 COM offset'

Você mandou 2026-08-07T11:49:12. Falta o fuso.O Metricaas grava em UTC. Sem offset não existe resposta certa: 00:52 pode ser 00:52 em São Paulo ou 21:52 do dia anterior. A API recusa em vez de adivinhar — porque adivinhar errado joga a venda para outro dia, às vezes outra semana, e ninguém percebe até o relatório não bater.Correto: 2026-08-07T11:49:12-03:00.

A venda entrou mas o painel não mudou

Quase sempre é escopo. Chame GET /v1/me: se scopes.channels não inclui o canal daquele lead, o token registrou a venda mas não a enxerga de volta.Também vale conferir o período selecionado no painel — sold_at é a data da compra, então uma venda de 31/07 lançada hoje aparece em julho, não hoje. É o comportamento correto, e costuma surpreender na primeira vez.

Começar

Conceitos

Receitas

Os dois erros que todo mundo comete na primeira vez

​Os dois erros que todo mundo comete na primeira vez

Os dois erros que todo mundo comete na primeira vez