Skip to main content
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

Registrar vendas

Uma chamada por compra, com a data real e o produto. Idempotente.

Ler leads e origem

Qual anúncio, campanha e criativo trouxe cada pessoa.

​
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

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.
Base: https://app.metricaas.com.br/v1

Autenticação

Como gerar o token e o que ele alcança.

Conectar esta doc ao seu agente

Servidor MCP público — o Claude ou o Cursor lê estas páginas enquanto escreve a sua integração.