> 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/tictools-integracoes/outros/hyros.md).

# Hyros

## Índice

* [Visão geral da integração](#visao-geral-da-integracao)
* [Pré-requisitos](#pre-requisitos)
* [Como obter a API Key da Hyros](#como-obter-a-api-key-da-hyros)
* [Como integrar a Hyros na Ticto](#como-integrar-a-hyros-na-ticto)
* [Como validar a integração](#como-validar-a-integracao)
* [Eventos enviados para a Hyros](#eventos-enviados-para-a-hyros)
* [Boas práticas](#boas-praticas)

***

### 🚀 Visão geral da integração

A integração com a **Hyros** foi desenvolvida para que os eventos de venda realizados na Ticto sejam enviados automaticamente para sua conta da Hyros.

Após configurada corretamente, a integração permite que a Hyros utilize essas informações para:

*  Melhorar a atribuição das vendas;
*  Identificar quais campanhas geram mais receita;
* 💰 Acompanhar faturamento por fonte de tráfego;
*  Otimizar campanhas com dados reais de conversão.

{% hint style="info" %}
A Ticto é responsável pelo envio das informações da venda. Toda a visualização, processamento e atribuição dos dados acontecem dentro da plataforma da Hyros.
{% endhint %}

***

### 🎯 Pré-requisitos

Antes de iniciar a configuração, verifique se você possui:

* Conta ativa na Ticto;
* Conta ativa na Hyros;
* Permissão de administrador nas duas plataformas;
* API Key gerada na Hyros.

{% hint style="warning" %}
A integração somente poderá ser concluída utilizando uma API Key válida.
{% endhint %}

***

### ⚙️ Como obter a API Key da Hyros

Para localizar sua chave de integração:

{% stepper %}
{% step %}
Acesse sua conta da Hyros.

{% endstep %}

{% step %}
Abra o menu **Settings.**

{% endstep %}

{% step %}
Localize a seção **API ou Integrations.**

{% endstep %}

{% step %}
Copie a **API Key** disponibilizada.

{% endstep %}
{% endstepper %}

{% hint style="info" %}
Caso não encontre a API Key, consulte a documentação oficial da Hyros ou entre em contato com o suporte da plataforma.
{% endhint %}

***

### 🔗 Como integrar a Hyros na Ticto

Após obter sua API Key, siga os passos abaixo.

{% stepper %}
{% step %}
Faça login na sua conta da Ticto e no menu lateral, clique em **TICTOOLS.**

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

{% step %}
Clique em **Outros.**

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

{% step %}
Clique em **Hyros**.

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

{% step %}
Clique em **Nova Integração.**

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

{% step %}
Preencha o nome da integração, selecione o Produto e cole a API Key que foi copiada do sistema da Hyros.

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

Clique em **Salvar**.✅
{% endstep %}

{% step %}
Após salvar, a integração ficará **ativa.**

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

**Teste a conexão.**&#x20;

Clique no menu **"Ações"** da integração salva e clique em **"Testar Conexão"**

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

{% hint style="success" %}
A partir deste momento, as novas vendas processadas pela Ticto poderão ser enviadas automaticamente para a Hyros.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 🔄 Como validar a integração

Após finalizar a configuração:

1. Realize uma compra de teste.
2. Aguarde o processamento da venda.
3. Acesse sua conta da Hyros.
4. Verifique se o evento foi recebido.

Caso os eventos não apareçam imediatamente, aguarde alguns minutos para sincronização.

{% hint style="warning" %}
O tempo de processamento pode variar conforme a Hyros.
{% endhint %}

***

### 📊 Eventos enviados para a Hyros

Quando a integração estiver ativa, a Ticto poderá enviar eventos relacionados às vendas, como:

* Compra aprovada;
* Pagamento confirmado;
* Valor da venda;
* Dados da transação;
* Identificação do comprador (quando aplicável);
* Produto adquirido.

{% hint style="info" %}
Os eventos disponíveis podem variar conforme a evolução da integração.
{% endhint %}

***

### 💡 Boas práticas

Para garantir um rastreamento eficiente:

* Utilize sempre a API Key correta;
* Não altere a chave durante campanhas em andamento, salvo quando necessário;
* Realize compras de teste após qualquer alteração na integração;
* Confirme que os scripts da Hyros estão corretamente instalados nas suas páginas de vendas.

{% hint style="success" %}
A qualidade dos relatórios depende tanto da integração da Ticto quanto da correta implementação da Hyros em seu funil.
{% endhint %}

***