> 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="/files/Rt77rEuUO1WeSVfgkzk5" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

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

{% step %}
Informe um **nome para identificação da integração.**

<div data-with-frame="true"><figure><img src="/files/xDCR6l0KaLzYspcjuIyW" 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="/files/JJYSo3fQMdfKuuAMxjpR" 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="/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 **Devzapp.**

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

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

<div data-with-frame="true"><figure><img src="/files/H8OlNVswo8LDHqhBrkuG" 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="/files/HxdBL1ZRa70CDhzTRp15" 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="/files/Bhcihb82JOmm5r8DvkVh" 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="/files/auTe9boI3zHfMZVw6VEg" 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="/files/TGpMcjJts8lxRg0tNi9C" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

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

<div data-with-frame="true"><figure><img src="/files/tGVq0M7l0yhXQHuaHY7R" 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="/files/EJ2tJEFP2fS1KivQDbqm" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Configure os campos abaixo:

<div data-with-frame="true"><figure><img src="/files/wFS1bDwasTYf0dLgTmPo" 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="/files/WOyggcAJWV3tESrnlHPh" 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="/files/uIVOwECHnRow5aGgiEy2" 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.

***