> ## 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.

# Integração com o CRM DataCrazy 

> Envie leads criados no DataCrazy para o Metrito via automação usando o gatilho 'Lead created' e o nó de API.

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:

| Campo      | Valor                                        |
| ---------- | -------------------------------------------- |
| **Método** | `POST`                                       |
| **URL**    | `https://api.metrito.com/v3/tracking/events` |

<Tip>
  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`
</Tip>

## 4. Cabeçalhos (Headers)

Adicione os seguintes cabeçalhos na configuração do nó:

| Nome do Header  | Valor do Header           |
| --------------- | ------------------------- |
| `Content-Type`  | `application/json`        |
| `Authorization` | `Bearer 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.

<Warning>
  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.
</Warning>

## 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:

```json theme={null}
{
  "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.

<Card title="API de eventos (visão geral)" icon="terminal" href="/tracking/events-api">
  Conheça melhor os conceitos de `container_id`, `config.name` e `config.facebook.name`.
</Card>

**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.