> 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="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FYl5dysxVWT6kShAPDHcM%2Fdashboard%20perfil%20credenciais.jpg?alt=media&amp;token=dc1be38f-7be7-4634-9dd9-6ababdc95b41" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

<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%2F3vhnC48rFNibA3DIclvO%2Fnova%20credencial%20api.jpg?alt=media&amp;token=6b2e3a9f-1e76-4a5d-8b51-44959aaeb2be" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Informe um nome para facilitar a identificaçã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%2FHRlR5r1iFN8DB87YiiQn%2Fnome%20da%20credencial.jpg?alt=media&amp;token=e2509815-af1a-4ad7-b6c6-2bfe669a43dd" 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="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2F0T6YptY3jKIPqnGiNXuY%2Fcredenciais%20geradas%20gian.jpg?alt=media&amp;token=442ac7bd-c498-4fe8-87aa-fae86dbb1baa" 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="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FYaXDxHmDe1qC6rB1q5Lt%2Fcred%20criadaaa.jpg?alt=media&amp;token=c789e8d3-2d38-441b-a073-a80e1dd90f9f" 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="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 %}
Acesse **Webhook.**

<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%2FBIHzQ5tFkekgkZJgulnM%2Fwebhook%20tictools.jpg?alt=media&amp;token=f2d7166c-636d-4b79-88bf-56f34b8b0078" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

<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%2Fni4z7ihrZy4uHcJ1tiNG%2Fwebhooks%20pastas.jpg?alt=media&amp;token=e8c24837-10da-4949-9804-8cdcc9db4f63" 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="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FUXznm0rFdbSKYYgrYN6f%2Fpart1%20webhook.jpg?alt=media&amp;token=3b1a3db7-eda1-4898-ae43-a8bff4e50d95" 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="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2F91RrlCnAZ7j10OUDxmJO%2Fpart2%20webhook.jpg?alt=media&amp;token=483ef346-fd5d-4939-8a30-dc867a72b76c" 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="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FYWxevWo7YqBgYHus3LXv%2Fsalvo%20webhook.jpg?alt=media&amp;token=284ed1c3-24b3-49b9-9df2-722b393f08dd" 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 %}

***