> 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/quadrify.md).

# Quadrify

## Índice

* [Visão geral](#visao-geral)
* [Pré-requisitos](#pre-requisitos)
* [Como obter as credenciais da API da Ticto](#como-obter-as-credenciais-da-api-da-ticto)
* [Como instalar a integração no Quadrify](#como-instalar-a-integracao-no-quadrify)
* [Como configurar o Webhook na Ticto](#como-configurar-o-webhook-na-ticto)
* [Como validar a integração](#como-validar-a-integracao)

***

### 🚀 Visão geral

A integração entre a **Ticto** e o **Quadrify** permite que todas as vendas realizadas na plataforma sejam enviadas automaticamente para o Quadrify, possibilitando uma análise mais completa do seu negócio.

Após concluir a configuração, o Quadrify passa a receber eventos de vendas em tempo real através do Webhook da Ticto.

{% hint style="success" %}
**Benefícios da integração**

* Centralização dos dados de vendas;
* Relatórios exclusivos no Quadrify;
* Atualização automática das vendas;
* Maior controle sobre indicadores e métricas do negócio.
  {% endhint %}

***

### ✅ Pré-requisitos

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

* Uma conta de **Produtor** ativa na Ticto;
* Pelo menos um produto cadastrado;
* Uma conta ativa no Quadrify.

{% hint style="info" %}
**Importante**

Você precisará criar (ou utilizar) suas credenciais de API da Ticto durante o processo.
{% endhint %}

***

### 🔗 Como obter as credenciais da API da Ticto

As credenciais de API serão utilizadas pelo Quadrify para estabelecer uma conexão segura com sua conta da Ticto.

{% stepper %}
{% step %}
Faça login na sua conta da Ticto e clique na sua foto do **Perfil**, localizada no canto superior direito. Em seguida clique em **Credenciais de API**.

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

{% step %}
Clique em **Nova Credencial.**

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

{% step %}
Informe um nome para facilitar a identificação.

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

Exemplo:

```
Ticto_Quadrify
```

Depois clique em **Criar credencial**.
{% endstep %}

{% step %}
Após a criação serão exibidos:

* Client ID
* Client Secret

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

Copie ambos os códigos e armazene-os em um local seguro.

{% hint style="warning" %}
**Atenção**

O **Client Secret** é exibido apenas no momento da criação da credencial.

Caso ele seja perdido, será necessário gerar uma nova credencial.
{% endhint %}

Clique em **Concluir** para finalizar.

{% hint style="info" %}
**Importante**

As credenciais criadas poderão ser utilizadas para todos os produtos existentes e também para novos produtos cadastrados futuramente.
{% endhint %}
{% endstep %}

{% step %}
Credenciais salvas

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

***

### 🔄 Como instalar a integração no Quadrify

Com as credenciais em mãos, é hora de conectar as plataformas.

{% stepper %}
{% step %}
Acesse sua conta no **Quadrify**

{% endstep %}

{% step %}
No menu lateral, clique em: **Integrações**

Localize a integração da **Ticto** e clique em: **Instalar**
{% endstep %}

{% step %}

#### Informe suas credenciais

Preencha os campos:

* Client ID
* Client Secret

Utilize exatamente os dados gerados na Ticto.
{% endstep %}
{% endstepper %}

***

### ⚙️ Como configurar o Webhook na Ticto

O Webhook é responsável por enviar automaticamente os eventos de venda para o Quadrify.

{% stepper %}
{% step %}
Em sua Dashboard Ticto, no menu lateral, clique em **TICTOOLS.**

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

{% step %}
Acesse **Webhook.**

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

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

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

{% step %}
Selecione o **Produto** de integração. Retorne ao painel de instalação do **Quadrify** para copiar a **URL de Webhook** disponibilizada pela plataforma e preencha o campo na Ticto.

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

{% hint style="info" %}
**Importante**

Certifique-se de colar a URL exatamente como fornecida pelo Quadrify. Alterações no endereço impedirão o envio dos eventos.
{% endhint %}

Ainda nesta página na Ticto, temos outras **configurações** para preencher:

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

| Campo            | Configuração           |
| ---------------- | ---------------------- |
| Versão           | **2.0 (Recomendado)**  |
| Formato de envio | **JSON (Recomendado)** |
| Eventos          | **Marcar Todos**       |

{% hint style="info" %}
**Dica**

A versão **2.0** oferece maior compatibilidade e melhor desempenho para integrações
{% endhint %}

Em seguida, clique em **Salvar.**✅
{% endstep %}

{% step %}
Webhook salvo.

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

{% hint style="warning" %}
Retorne novamente ao Quadrify, clique em: **Atualizar**

O Quadrify fará uma validação automática da integração.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 🎯 Como validar a integração

Após concluir todas as etapas:

* As vendas realizadas na Ticto serão enviadas automaticamente ao Quadrify;
* Os eventos serão sincronizados via Webhook;
* Os relatórios e dashboards do Quadrify começarão a receber dados conforme novas vendas forem ocorrendo.

{% hint style="success" %}
**Integração concluída com sucesso**

A partir deste momento, o Quadrify receberá automaticamente as informações das suas vendas realizadas na Ticto.
{% endhint %}

***