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 evento avulso para o Meta (CAPI). A venda registrada pela API envia o Purchase — pelo mesmo caminho e com as mesmas travas da tela, descritas em Vendas. O que não existe é mandar ao Meta um evento que o CRM não registrou.
  • 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 de API não deve ir para o navegador em nenhuma hipótese — quem tiver o token tem o acesso da pessoa de quem ele herda o papel.
Base: https://app.metricaas.com.br/v1

Autenticação

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

MCP da documentação — estas páginas

Servidor MCP público, sem token — o seu agente lê esta documentação enquanto escreve a integração. Não enxerga dado nenhum da sua empresa.