> 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="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FYHp96q90S9yQQHDwGdDt%2Fimage.png?alt=media&amp;token=4ff3a5a3-792f-4aef-ad7f-ed524b682518" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FRzJuYo9l9dxCsoV7kWlN%2FTictools%20Outros.jpg?alt=media&amp;token=a5e0e0df-74f0-4b4f-9184-4ef2c408e2cf" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2F66sj22zEEQiSin7s8gXi%2Fhyros%20integra.jpg?alt=media&amp;token=4dd0fd30-c3dd-4631-9f9b-d5f9636c536c" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

<div data-with-frame="true"><figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FNmW51hk3yopztI1hfEMg%2Fhyros%20integrar%20novo.jpg?alt=media&amp;token=4e6a738d-bd4e-4dd1-b0e7-831ac43f3180" 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="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FFz4UwxyBw3yG7ao2RMQP%2Fcadastrar%20nova%20integr%20hyros.jpg?alt=media&amp;token=780bbbc1-67fd-44e3-862c-206d57a843e8" 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="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2Ft8wd8Z75Z6bOD6zAACJs%2Fsalvado%20hyros%201.jpg?alt=media&amp;token=6071dc16-a1a5-4289-bd2f-238f903f6379" 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="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FE5DKoVL1BvOUtPAiS0la%2Fteste%20de%20conexao%20hyros.jpg?alt=media&amp;token=aa38594f-cf79-4b4a-90fa-3347e4308a7b" 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 %}

***