Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.metrito.com/llms.txt

Use this file to discover all available pages before exploring further.

Este guia ensina como conectar o DataCrazy ao Metrito usando o painel de Automações. Quando um lead for criado no CRM, a automação disparará uma requisição HTTP para o endpoint de eventos do Metrito. Isso é fundamental para a atribuição no Meta Ads, inclusive em cenários com Click to WhatsApp (CTWA).

​
Pré-requisitos

  • Uma conta ativa no Metrito com um contêiner de rastreamento (você precisará do código MTC).
  • Uma Chave de API do Metrito com permissão para enviar eventos (escopo de rastreamento).
  • Acesso à área de Automações no painel do DataCrazy para criar o fluxo.

​
1. Criar o gatilho da automação

  1. No DataCrazy, acesse a página de Automações.
  2. Crie um novo fluxo ou abra um já existente.
  3. No bloco inicial (Start), adicione um novo gatilho.
  4. Selecione a opção Lead created (When a lead is created / Quando um lead for criado).
Com isso, o fluxo será acionado automaticamente sempre que um novo lead entrar no CRM.

​
2. Adicionar o nó de API

  1. A partir do ponto de saída do bloco Start (onde diz When the event occurs, then), conecte o próximo passo.
  2. Adicione um nó de requisição externa. Na interface do DataCrazy, ele pode se chamar API, HTTP ou Webhook.
  3. Esse nó será o responsável por enviar os dados do lead para o Metrito via um método POST.

​
3. Configurar URL e método

Preencha as configurações do nó de API com os seguintes valores:
CampoValor
MétodoPOST
URLhttps://api.metrito.com/v3/tracking/events
Se quiser que o processamento seja feito na hora (modo síncrono) e receber uma resposta JSON imediata com o status do lead, adicione ?sync=true ao final da URL: https://api.metrito.com/v3/tracking/events?sync=true

​
4. Cabeçalhos (Headers)

Adicione os seguintes cabeçalhos na configuração do nó:
Nome do HeaderValor do Header
Content-Typeapplication/json
AuthorizationBearer SUA_CHAVE_DE_API
Substitua SUA_CHAVE_DE_API pela chave real que você gerou no Metrito. O valor final deve conter a palavra Bearer, seguida de um espaço e o token (exemplo: Bearer mtk_live_Jw_LnFIkve...).

​
Onde gerar a chave no Metrito?

  1. Acesse o painel da plataforma Metrito.
  2. Navegue até Configurações → Chaves de API (ou API keys).
  3. Crie uma nova chave certificando-se de conceder a permissão de rastreamento (tracking:write).
  4. Copie o token gerado e cole-o na sua automação.
Sua chave de API é uma credencial sensível. Nunca a compartilhe publicamente. Se o DataCrazy oferecer um cofre de segredos ou variáveis de ambiente seguras, prefira utilizá-los.

​
5. Corpo da requisição (JSON)

O corpo da requisição (body ou payload) deve ser enviado no formato JSON. No DataCrazy, as variáveis dinâmicas usam o padrão ${nomeDaVariavel} (cifrão + chaves). Os nomes são os mesmos para todos os usuários (ex.: ${leadSourceUrl} para a URL de origem). Aqui está um exemplo de payload para enviar o lead como evento Contact na Meta, já com o padrão de variáveis do DataCrazy: 
{
  "container_id": "MTC-XXXXXXXX",
  "config": {
    "name": "Lead Criado",
    "facebook": {
      "name": "Contact",
      "trackCustom": false,
      "sourceKey": "business_messaging"
    }
  },
  "lead": {
    "name": "${leadName}",
    "email": "${leadEmail}",
    "phone": "${leadPhone}"
  },
  "utm": {
    "source_id": "${leadSourceId}",
    "utm_content": "${leadSourceId}",
    "utm_medium": "ctwa_ad"
  },
  "cookies": {
    "ctwaClid": "${leadCtwaId}"
  },
  "meta": {
    "url": "${leadSourceUrl}"
  }
}

​
Explicação dos campos principais:

  • container_id: É o seu código MTC (ex.: MTC-55AEW53Y). Para encontrar este código:
    1. No Metrito, acesse Rastreamento.
    2. Escolha o contêiner desejado.
    3. Você verá o código MTC-XXXXXX logo abaixo do nome do contêiner. Copie-o e substitua MTC-XXXXXXXX no JSON acima (valor fixo, não é variável do DataCrazy).
  • config.facebook: Informa ao Metrito como esse evento deve ser encaminhado para a API de Conversões da Meta.
  • utm.source_id e utm_content: ID do anúncio na Meta — use ${leadSourceId} nos dois quando fizer sentido para o seu fluxo. Com source_id, o Metrito pode enriquecer campanha, conjunto e pixel (se a conexão Facebook Marketing estiver ativa).
  • cookies.ctwaClid: Identificador CTWA — ${leadCtwaId}.
  • meta.url: URL de origem do lead — ${leadSourceUrl} (mesmo nome em todas as contas DataCrazy).
As expressões ${leadName}, ${leadEmail}, ${leadPhone}, ${leadSourceId}, ${leadCtwaId} e ${leadSourceUrl} são resolvidas pelo DataCrazy no momento em que a automação roda.

​
6. Testes e validação

  1. Salve a automação no DataCrazy.
  2. Execute a automação com um lead de teste (caso o CRM ofereça a opção de testar o nó).
  3. No painel do Metrito, acesse os detalhes do contêiner e verifique se o evento e os dados do lead foram recebidos com sucesso.
  4. Se você enviou o evento para a Meta, verifique o Gerenciador de Eventos (modo de teste do servidor) para confirmar o recebimento do payload de conversão.

​
Próximos passos

Na aba Referência de API da documentação (em API de Rastreamento → Eventos), você encontra o contrato completo do endpoint POST /v3/tracking/events, incluindo todos os parâmetros opcionais.

API de eventos (visão geral)

Conheça melhor os conceitos de container_id, config.name e config.facebook.name.
Dica de resolução de problemas: Se o nó de API retornar 401 ou 403, confira o header Authorization: deve ser a palavra Bearer, um espaço e o token da chave copiado do Metrito (valor fixo). Não use ${...} no header — o padrão ${variável} do DataCrazy vale para o corpo JSON, não para a chave de API.