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

# Devzapp

## Índice

* [Visão geral Devzapp](#visao-geral-devzapp)
* [Integração via API (1ª opção)](#integracao-via-api-1a-opcao)
  * [Como gerar o Token no Devzapp](#como-gerar-o-token-no-devzapp)
  * [Como configurar a integração na Ticto](#como-configurar-a-integracao-na-ticto-via-api)
* [Integração via Webhook (2ª opção)](#integracao-via-webhook-2a-opcao)
  * [Obtendo a URL do Webhook no Devzapp](#obtendo-a-url-do-webhook-no-devzapp)
  * [Configurando e testando o Webhook na Ticto](#configurando-e-testando-o-webhook-na-ticto)
  * [Utilizando os dados recebidos](#utilizando-os-dados-recebidos)
* [Boas práticas](#boas-praticas)

***

### 🚀 Visão geral Devzapp

A integração entre a **Ticto** e o **Devzapp** permite automatizar o envio de eventos da plataforma para criar fluxos de comunicação via WhatsApp, como recuperação de vendas, cobrança de assinaturas, notificações de pagamento, upsell e outras automações.

A integração pode ser realizada de duas formas:

* **Via API (Token)**
* **Via Webhook**

***

### 🔗 Integração via API (1ª opção)

A integração via API conecta a Ticto ao Devzapp utilizando um **Token de autenticação**, permitindo o envio de informações dos produtos selecionados para a plataforma.

#### 🔑 Como gerar o Token no Devzapp

Caso ainda não possua um Token, siga os passos abaixo.

{% stepper %}
{% step %}
No **Devzapp**, acesse a **campanha** que será utilizada na **integração.**
{% endstep %}

{% step %}
Clique na opção **Tokens** da campanha.

<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%2FOB6Aj3JPu96fjIVyiL0E%2Fimage.png?alt=media&amp;token=db15f3f4-725f-41c0-b876-b99473cfdc24" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Crie um **novo Token**. Clique em **Criar Token**.

<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%2F4ghfCpcNMFOBWg0HdWCH%2Fimage.png?alt=media&amp;token=d12364b1-0e83-4bc2-a481-b6aa75117d8f" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Informe um **nome para identificação da 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%2F6KtlVLPy4IGq8643fxqq%2Fimage.png?alt=media&amp;token=08b3b67f-4d94-4436-8bd2-ad3679a668e6" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Após a criação, **copie o Token gerado** e retorne à Ticto para colá-lo no campo **Token da 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%2FTJhNhfV52TU8wh4ByPhI%2Fimage.png?alt=media&amp;token=69a7975e-84a4-4302-af05-3667b865a781" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
**Importante:** Guarde esse Token com segurança. Ele será utilizado para autenticar a comunicação entre as plataformas
{% endhint %}
{% endstep %}
{% endstepper %}

***

### ⚙️ Como configurar a integração na Ticto (Via API)

{% 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 **Devzapp.**

<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%2FU5DB2S95bCXTPc2XydSG%2Fdevzapp%20tictools.jpg?alt=media&amp;token=2862ed94-50ea-4593-8ffb-6bd1237fbe6f" 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%2FNhqoXrnX12LttzsVxvPd%2Fnova%20int%20devzapp.jpg?alt=media&amp;token=85748bed-c570-45dd-8496-eff6888edcb9" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Preencha o **Nome** da integração, selecione o **Produto** e cole o **Token** gerado no **Devzapp.**

<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%2F5erswawNOfR1MLi6iqY7%2Fcadastrar%20integracao%20devzapp.jpg?alt=media&amp;token=bb544f85-ec2e-4846-b828-860a05636f8e" alt=""><figcaption></figcaption></figure></div>

Clique em **Salvar**.✅

{% hint style="info" %}
Utilize um nome que facilite identificar a finalidade da integração.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 🌐 Integração via Webhook (2ª opção)

A integração via Webhook permite enviar automaticamente os eventos da Ticto para um funil configurado no Devzapp.

#### 🔗 Obtendo a URL do Webhook no Devzapp

{% stepper %}
{% step %}
Acesse sua conta no **Devzapp** e no menu lateral esquerdo, clique em **Funil.** Em seguida clique em **Automações** no canto superior direito.

<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%2FQmyzXbK38ejrJMXtbJtO%2Fimage.png?alt=media&amp;token=94161377-7958-440b-bc16-c59c58cbf40f" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Na lista de funis, localize o **funil desejado**. Na coluna **URL**, clique no ícone correspondente e copie a **URL V1**.

<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%2FTUCAJUxZC1ExE7FTkl6R%2Fimage.png?alt=media&amp;token=ab9a64ba-1878-4f22-824a-9f6c082198f0" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Essa URL de Postback será utilizada na configuração do Webhook na Ticto.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### ⚙️ Configurando e testando o Webhook na Ticto

{% 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 **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%2FdzjeWLXRfm9dhFmoCdvk%2Fimage.png?alt=media&amp;token=faf111e3-1320-46e9-b10c-7ff1a167ed10" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique no botão **Adicionar** para criar um novo 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%2Fni4z7ihrZy4uHcJ1tiNG%2Fwebhooks%20pastas.jpg?alt=media&amp;token=e8c24837-10da-4949-9804-8cdcc9db4f63" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Configure os campos abaixo:

<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%2FgnpntZvTCuIecCGmFZWg%2Fcriando%20webhook%20para%20devzapp.jpg?alt=media&amp;token=c5fbcde5-9f7d-4603-9e32-ddb580f63d4f" alt=""><figcaption></figcaption></figure></div>

| Campo               | Configuração                   |
| ------------------- | ------------------------------ |
| 📦 Produto          | Produto que enviará os eventos |
| 🌐 URL              | URL copiada do Devzapp         |
| 🔖 Versão           | **1.0 (V1)**                   |
| 🎯 Formato de Envio | JSON (Recomendado)             |
| 📤 Eventos          | Selecione os eventos desejados |

{% hint style="info" %}
**Importante:** Não altere o campo **Formato de envio**. Essa configuração já é preenchida automaticamente pela Ticto.
{% endhint %}

Clique em **Salvar**.✅

<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%2FOlLy57gZKhEQ6uhibFUG%2Fteste%20webhook%20cadastrado.jpg?alt=media&amp;token=68c6ba31-db03-434e-aa88-06b1493016e1" alt=""><figcaption></figcaption></figure></div>

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

{% step %}
**Testando a integração**

Após salvar, o Webhook ficará disponível na listagem.

<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%2FKVq860dlIdYjBWcfiKxx%2Fwebhook%20salva%20na%20lista%20ticto.jpg?alt=media&amp;token=36066979-d34d-439f-a3c3-1d0b2a7fd897" alt=""><figcaption></figcaption></figure></div>

No menu **Ações**, você poderá:

* Enviar um evento de teste;
* Consultar o histórico de envios;
* Confirmar se os eventos chegaram ao Devzapp.
  {% endstep %}
  {% endstepper %}

***

### 📨 Utilizando os dados recebidos

Sempre que um evento for enviado pela Ticto, ele ficará disponível dentro do Devzapp.

Esses dados poderão ser utilizados nas automações e mensagens personalizadas.

Exemplos de informações recebidas:

* Nome do comprador;
* E-mail;
* Produto;
* Valor da compra;
* Forma de pagamento;
* Status da compra.

{% hint style="info" %}
Utilize os parâmetros disponibilizados pelo Devzapp conforme a sintaxe da própria plataforma para criar mensagens dinâmicas.
{% endhint %}

***

### 💡 Boas práticas

* Faça um envio de teste antes de colocar a automação em produção.
* Utilize nomes descritivos para Tokens e integrações.
* Configure apenas os eventos necessários para cada funil.
* Caso utilize diferentes estratégias no Devzapp, crie um Webhook específico para cada uma delas.

***