Como integrar EDMPay com Utmify

Visão Geral

A EDMPay pode ser integrada à Utmify, uma ferramenta de rastreamento de vendas. Com essa integração, cada venda confirmada na EDMPay é enviada automaticamente para a Utmify, permitindo rastrear a origem das suas vendas e medir o desempenho das suas campanhas de marketing.

Objetivo

Sem essa integração, não é possível saber quais campanhas, anúncios ou fontes de tráfego geraram cada venda. A integração com a Utmify resolve isso: os dados de cada compra — incluindo parâmetros UTM — são enviados automaticamente, centralizando as informações de rastreamento em um só lugar.

Como configurar a integração

Siga os 3 passos abaixo na ordem indicada.

Passo 1 — Criar uma credencial de API na Utmify

Em sua conta na Utmify, acesse o menu Integrações.
Navegue até Webhook e clique em Credenciais API.
Insira um nome de sua preferência para a credencial e clique em Criar Credencial.
Guarde o código gerado — ele será necessário no próximo passo.
Clique em Finalizar.

💡 Dica: Salve essa credencial em um local seguro. Sem ela, não será possível autenticar as requisições enviadas pela EDMPay.

Passo 2 — Criar uma automação na EDMPay

No painel da EDMPay, acesse o menu Automações.
Escolha a automação desejada. Neste exemplo, usamos Pagamento confirmado.
Clique em Usar este modelo.
Na próxima tela, selecione a opção Gerar um Webhook e clique em OK.

Passo 3 — Configurar o Webhook na EDMPay

Na tela de Edição e visualização, preencha os campos conforme abaixo:

A. Filtro de disparo

Escolha se o webhook deve ser disparado para todos os produtos ou apenas para um produto específico.

B. URL do Webhook

https://api.utmify.com.br/api-credentials/orders

C. Método

POST

D. Headers

Adicione as duas chaves abaixo:

Chave	Valor

Chave	Valor
`Content-Type`	`application/json`
`x-api-token`	Cole aqui a credencial de API gerada no Passo 1

E. Body

Copie e cole o código JSON abaixo no campo de body:

{
  "isTest": false,
  "status": "{{ payment_status }}",
  "orderId": "{{ payment_id }}",
  "customer": {
    "name": "{{ buyer_name }}",
    "email": "{{ buyer_email }}",
    "phone": "{{ buyer_phone_raw }}",
    "country": "BR",
    "document": "{{ buyer_document_id | remove: '.' | remove: '-' }}"
  },
  "platform": "EDMPay",
  "products": [
    {
      "id": "{{ product_id }}",
      "name": "{{ product_name }}",
      "planId": "{{ offer_id }}",
      "planName": "{{ offer_title }}",
      "quantity": 1,
      "priceInCents": "{{ offer_price }}"
    }
  ],
  "createdAt": "{{ created_at }}",
  "commission": {
    "gatewayFeeInCents": "{{ payment_value }}",
    "totalPriceInCents": "{{ payment_value | minus: net_value_cents }}",
    "userCommissionInCents": "{{ net_value_cents }}"
  },
  "refundedAt": null,
  "approvedDate": "{% if payment_date and payment_date != '' %}{{ payment_date }}{% else %}null{% endif %}",
  "paymentMethod": "{% if payment_method == 'bank_slip' %}boleto{% else %}{{ payment_method }}{% endif %}",
  "trackingParameters": {
    "sck": null,
    "src": "{% if cart_src and cart_src != '' %}'{{ cart_src }}'{% else %}null{% endif %}",
    "utm_term": "{% if utm_term and utm_term != '' %}'{{ utm_term }}'{% else %}null{% endif %}",
    "utm_medium": "{% if utm_medium and utm_medium != '' %}'{{ utm_medium }}'{% else %}null{% endif %}",
    "utm_source": "{% if utm_source and utm_source != '' %}'{{ utm_source }}'{% else %}null{% endif %}",
    "utm_content": "{% if utm_content and utm_content != '' %}'{{ utm_content }}'{% else %}null{% endif %}",
    "utm_campaign": "{% if utm_campaign and utm_campaign != '' %}'{{ utm_campaign }}'{% else %}null{% endif %}"
  }
}

⚠️ Atenção: Se você criou mais de uma automação, repita os passos 2 e 3 para cada uma delas.

Integração finalizada! 🎉

Com tudo configurado, a cada Pagamento confirmado na EDMPay, os dados da venda serão enviados automaticamente para a Utmify — incluindo os parâmetros de rastreamento UTM.