> For the complete documentation index, see [llms.txt](https://help.ticto.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ticto.com.br/sou-produtor/trackeamento/integracao-ticto-utmify.md).

# Integracao Ticto - Utmify

### Índice

* [O que é essa integração](#o-que-e-essa-integracao)
* [Pré-requisitos](#pre-requisitos)
* [Passo 1 – Criar o Webhook na Utmify](#passo-1)
* [Passo 2 – Configurar o Webhook na Ticto](#passo-2)
* [Vendas separadas x Vendas unificadas](#vendas-separadas-x-unificadas)
* [Impacto no Pixel / CPA das campanhas](#impacto-pixel-cpa)
* [Reenviar vendas que não chegaram na Utmify](#reenviar-vendas)

## 🌐 O que é essa integração

A Utmify é uma plataforma de tracking usada por produtores para acompanhar vendas, campanhas e métricas de anúncios (Meta, Google, TikTok, Kwai, Taboola). A integração com a Ticto é feita via **Webhook**: a cada evento de venda, assinatura ou afiliação, a Ticto envia os dados para a Utmify em tempo real.

{% hint style="info" %}
Este artigo cobre: como conectar a Ticto à Utmify, a diferença entre **vendas separadas** e **vendas unificadas** (Order Bump), e o impacto dessa escolha nas campanhas de anúncio.
{% endhint %}

## Pré-requisitos

* Conta ativa na Utmify.
* Conta de produtor na Ticto, com acesso ao menu **Tictools**.
* Saber, antes de começar, se o objetivo é enviar as vendas **separadas** (Order Bump como vendas distintas) ou **unificadas** (Order Bump somado à oferta principal). Essa escolha define qual URL usar (ver seção específica abaixo).

## Passo 1 – Criar o Webhook na Utmify <a href="#passo-1" id="passo-1"></a>

{% stepper %}
{% step %}
Na Utmify, acesse **Integrações** no menu lateral esquerdo.

<div data-with-frame="true"><figure><img src="/files/tSaVrQUf9ffX9XW2CF2l" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique na aba **Webhooks**.

<figure><img src="/files/TKyU0FrxNvSCY29sUc36" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Clique em **Adicionar Webhook**.

<div data-with-frame="true"><figure><img src="/files/LV6X25TN3fMBRJQESGTD" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
No campo de busca da plataforma, digite **"ticto"** e selecione o card **Ticto**.

<div data-with-frame="true"><figure><img src="/files/OiI9vjWBqwHlRwbHpRhQ" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Dê um nome para a integração (ex.: "Ticto Webhook") e insira o token gerado dentro da ticto e clique em criar. A Utmify exibe a tela **"Webhook criado com sucesso"** com duas URLs prontas para copiar:\ <br>

<div data-with-frame="true"><figure><img src="/files/5fJ1UZogpbWWNs1qonLz" alt=""><figcaption></figcaption></figure></div>

| URL exibida na Utmify                                                    | Uso                                                                                                        |
| ------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| **URL 1 – Vendas separadas** (`.../webhooks/ticto?id=...`)               | Cada item (oferta principal, order bump, upsell) chega como uma venda distinta na Utmify                   |
| **URL 2 – Vendas unificadas** (`.../webhooks/ticto?unified=true&id=...`) | Order bumps e upsells são somados à oferta principal em **1 única venda** no dashboard/campanhas da Utmify |
|                                                                          |                                                                                                            |

<figure><img src="/files/ZAWAeWksSHh2AejqMSRk" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Cadastre **apenas uma** das duas URLs na Ticto — nunca as duas ao mesmo tempo, para não duplicar o registro da venda.
{% endhint %}

{% hint style="info" %}
A própria Utmify sinaliza, no rótulo da URL 2, que **order bumps e upsells continuam sendo considerados no cálculo de extra quota** mesmo no modo unificado — reforça o ponto de que a mudança é só de visualização, não de cobrança.
{% endhint %}
{% endstep %}
{% endstepper %}

## Passo 2 – Configurar o Webhook na Ticto <a href="#passo-2" id="passo-2"></a>

{% stepper %}
{% step %}
Na Ticto, abra o menu lateral e acesse **Tictools**.

<div data-with-frame="true"><figure><img src="/files/ePgg6gDWqPNqw96zbB1q" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique no card **Webhooks**.

<div data-with-frame="true"><figure><img src="/files/tGVq0M7l0yhXQHuaHY7R" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Selecione (ou crie) a pasta onde deseja organizar o webhook e clique em **+ Adicionar**.
{% endstep %}

{% step %}
**Itens a serem enviados** — escolha entre:

| Opção no toggle da Ticto                                    | O que faz                                                      | URL da Utmify que deve ser colada no Passo 6 |
| ----------------------------------------------------------- | -------------------------------------------------------------- | -------------------------------------------- |
| **Enviar Order Bump \| Combo junto com a oferta principal** | Envia um único evento com o valor total (oferta + order bumps) | **URL 2 – Vendas unificadas**                |
| **Enviar Order Bump \| Combo separadamente**                | Envia um evento distinto para cada item                        | **URL 1 – Vendas separadas**                 |

<div data-with-frame="true"><figure><img src="/files/jgjOdz9yzMKczVjLkQQa" alt=""><figcaption></figcaption></figure></div>

{% hint style="danger" %}
**A opção escolhida aqui precisa refletir exatamente a URL que será colada no campo URL (Passo 6).** Se o toggle estiver em "junto com a oferta principal" mas a URL colada for a **URL 1 (separadas)** — ou vice-versa — a venda vai aparecer errada no dashboard da Utmify (duplicada, fragmentada ou com valor incorreto). Sempre confira as duas configurações juntas antes de salvar.
{% endhint %}

{% hint style="info" %}
Essa é a configuração que define se a venda chega na Utmify como **1 venda unificada** ou como **múltiplas vendas separadas**. Ver detalhes na próxima seção.
{% endhint %}
{% endstep %}

{% step %}
**Produtos** — selecione os produtos que farão parte desta integração.

<div data-with-frame="true"><figure><img src="/files/miPeyzsOvv2aINyALxfB" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**URL** — cole a URL copiada da Utmify no Passo 1 (a URL correta para a opção escolhida no passo anterior).

<div data-with-frame="true"><figure><img src="/files/EA6z5Z1hzbEbYacJXQfR" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Versão** — selecione **2.0** (recomendada; a versão 1.0 é apenas para integrações legadas).

<div data-with-frame="true"><figure><img src="/files/DvR8oPX3kzTDBhDHmXpg" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Formato de Envio** — mantenha **JSON**.

<div data-with-frame="true"><figure><img src="/files/5BTCb6sUAfBq13yUvMwJ" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Eventos** — marque **Todos** (ou, no mínimo, os eventos de Venda Realizada, Reembolso e Chargeback, para que a Utmify reflita o status real da venda).

<div data-with-frame="true"><figure><img src="/files/40CQX9lyVLSLWrmFRYZP" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Salvar**. A Ticto faz um teste automático da URL antes de permitir salvar — se falhar, revise a URL colada.
{% endstep %}
{% endstepper %}

## Vendas separadas x Vendas unificadas <a href="#vendas-separadas-x-unificadas" id="vendas-separadas-x-unificadas"></a>

Esse ponto gera dúvida recorrente de produtores, então vale reforçar:

* **Cobrança/faturamento na Ticto não muda.** As vendas continuam sendo calculadas individualmente para efeitos de taxa.
* O que muda é **apenas como a venda aparece no dashboard e nas campanhas dentro da Utmify**.

| Cenário desejado pelo produtor                                                   | Configuração na Ticto                                     | URL da Utmify a usar          |
| -------------------------------------------------------------------------------- | --------------------------------------------------------- | ----------------------------- |
| Ver Order Bump/upsell como venda separada da oferta principal (padrão histórico) | "Enviar Order Bump \| Combo separadamente"                | **URL 1 – Vendas separadas**  |
| Ver Order Bump/upsell somado à oferta principal como **1 única venda**           | "Enviar Order Bump \| Combo junto com a oferta principal" | **URL 2 – Vendas unificadas** |

{% hint style="info" %}
As duas URLs são geradas juntas, na mesma tela, no momento em que o webhook é criado na Utmify ("Webhook criado com sucesso"). O produtor não precisa criar duas integrações separadas — só decide qual das duas URLs vai colar no campo **URL** da Ticto, conforme a opção escolhida em "Itens a serem enviados" (Passo 2).
{% endhint %}

{% hint style="info" %}
Para visualizar o **total** de vendas consideradas (mesmo usando vendas separadas), o produtor também pode consultar a aba **Assinatura** dentro da Utmify, que mostra o total agregado. Nas abas de campanhas das plataformas de anúncio, existe ainda a coluna **Vendas Individuais** para detalhar por item.
{% endhint %}

{% hint style="warning" %}
Um produtor só deve usar **uma das duas URLs**, nunca as duas ao mesmo tempo — usar ambas duplica o registro da venda na Utmify.
{% endhint %}

## Impacto no Pixel / CPA das campanhas <a href="#impacto-pixel-cpa" id="impacto-pixel-cpa"></a>

Alguns produtores relataram que enviar Order Bump como custo adicional para a campanha aumentava o CPA percebido nas plataformas de anúncio (Meta, Google etc.). O funcionamento real, confirmado com a Utmify, é o seguinte:

* Quando a venda é **unificada**, a Utmify dispara **um único evento de venda** para a plataforma de anúncio (ex.: Meta), mesmo que o pedido tenha 1, 2 ou 3 order bumps.
* O valor enviado nesse evento único é a **soma total** do pedido (oferta principal + todos os order bumps) — não são enviados múltiplos disparos.

{% hint style="info" %}
Ou seja: 1 pedido com 3 order bumps unificado = **1 disparo** para o pixel, com o **valor somado**. Isso resolve o receio de "inflar" artificialmente o número de conversões reportadas à plataforma de anúncio.
{% endhint %}

Se o produtor quiser que o pixel receba **apenas o valor da oferta principal** (sem order bumps), a recomendação é:

* Manter o padrão **antigo** (vendas separadas) e configurar o Pixel da Utmify para enviar **somente o produto principal**.

Se o produtor quiser **as duas coisas** — visualizar vendas agrupadas no dashboard da Utmify **e** enviar ao pixel apenas o produto principal — a solução é criar **dois dashboards** na Utmify:

1. **Dashboard A** — webhook no padrão antigo (vendas separadas) + Pixel configurado para enviar somente a venda do produto principal. Este é o dashboard que efetivamente alimenta a Meta.
2. **Dashboard B** — webhook no padrão novo (vendas unificadas), sem pixel configurado. Este serve apenas para análise/visualização agregada dentro da própria Utmify.

## Reenviar vendas que não chegaram na Utmify <a href="#reenviar-vendas" id="reenviar-vendas"></a>

{% stepper %}
{% step %}
Na Ticto , acesse o relatório **Minhas Vendas**.
{% endstep %}

{% step %}
Localize o pedido em questão e clique em **Detalhes** da venda desejada e depois em **Postbacks Enviados**.
{% endstep %}

{% step %}
Se o status estiver como **Failed**, clique em **Reenviar** para que todos os webhooks cadastrados para aquele produto sejam disparados novamente para essa venda específica.
{% endstep %}

{% step %}
Para investigar a causa de uma falha (ou apenas conferir o retorno do servidor), clique em **Detalhes** — a tela mostra o payload enviado e a resposta recebida.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Para mais detalhes de como reenviar um postback consulte nosso passo a passo: [Minhas vendas- Postbacks enviados](/sou-produtor/minhas-vendas/acoes-em-uma-venda/minhas-vendas-postbacks-enviados.md)
{% endhint %}