# ConvertKit

## ConvertKit

📚 **Índice**

* Introdução
* Como acessar os dados de API no ConvertKit
* Como criar uma nova integração no painel Ticto
* Gerenciando integrações existentes
* Segmentações: como configurar regras e ações
* Campos e definições utilizadas na integração

***

## 🎯 Introdução

O **ConvertKit** é uma ferramenta poderosa de automação de marketing criada especialmente para **criadores, infoprodutores e negócios digitais**.\
Com ele, você pode:

✔️ Gerenciar listas de contatos\
✔️ Criar campanhas automatizadas\
✔️ Disparar e-mails segmentados\
✔️ Adicionar e remover tags\
✔️ Construir relacionamentos mais profundos com seus leads

A integração com a **Ticto** permite:

* Enviar leads automaticamente para o ConvertKit
* Aplicar tags conforme ações dentro da plataforma
* Criar segmentações inteligentes baseadas em eventos
* Automatizar nutrição e ativação de alunos/assinantes

***

## 🌐 Como acessar os dados de API no ConvertKit

Para integrar sua conta ConvertKit com a Ticto, você precisa de dois dados:

* **API Key**
* **API Secret**

***

### 🔑 Passo a passo para localizar sua API Key e API Secret

{% stepper %}
{% step %}
Acesse sua conta ConvertKit.
{% endstep %}

{% step %}
No canto superior direito, clique no **ícone do perfil**.

<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%2FyICdCGHwea5xj46FUd2t%2Fimage.png?alt=media&#x26;token=e368c606-ff43-4f14-a493-a31d9b3f48dc" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Selecione **Settings** (Configurações).

<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%2Fqw4yryeDDPGHhxfEtPnU%2Fimage.png?alt=media&#x26;token=215cdc26-e889-406c-98b0-c755961efc7a" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
No menu lateral esquerdo, clique em **Developer**.

<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%2FH1rCfo7nJri40vLgggj4%2Fimage.png?alt=media&#x26;token=f6f7aa6c-99f8-4053-9f0a-29c0501345bc" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Localize os campos:

* **API Key**
* **API Secret**

📌 *Copie ambos os valores — você irá colá-los dentro da Ticto.*

{% hint style="danger" %}
Nunca compartilhe sua API Key ou API Secret publicamente.\
Elas fornecem acesso direto à sua conta ConvertKit.
{% endhint %}
{% endstep %}
{% endstepper %}

***

## 🔧 Como criar uma nova integração no painel Ticto

{% stepper %}
{% step %}
No menu lateral, acesse **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%2FRB66dSS4yRfRgHpHrrcp%2Fimage.png?alt=media&#x26;token=eb95e22e-2b98-4da5-81be-98419abf829f" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Entre na seção **E-mail Marketing**

<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%2F7FLTZjM6iao3PRP6AiAr%2Fimage.png?alt=media&#x26;token=bcd712e7-ab5f-45e2-9e79-1d50f9f42725" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Escolha **ConvertKit**

<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%2FyHCtr8JfPurnaQHaZDc4%2Fimage.png?alt=media&#x26;token=d88048c6-6357-4256-b904-d204f84d8a10" 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%2FXw4O8yLQu8KlM5yGqUHT%2Fimage.png?alt=media&#x26;token=fbfa124b-96b3-49fc-9a87-de2592eb37e3" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Realize o preenchimento dos campos abaixo para cadastro da integração

**Produto**

Selecione o produto Ticto que será vinculado à integração.

* **Produto**

  Selecione o produto Ticto que será vinculado à integração.
* **Nome da Conta**

  Nome interno para identificar sua conta ConvertKit.\
  Exemplo:\
  👉 *“ConvertKit – Produto Principal”*
* **API\_KEY**

  Cole aqui a **API Key** copiada do ConvertKit.
* **API\_SECRET**

  Cole aqui a **API Secret** copiada do ConvertKit.
* **Botão Salvar**

  Clique para concluir o cadastro 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%2FDfcbaBxwh6gkFiwD1UK3%2Fimage.png?alt=media&#x26;token=97c42893-76bb-4c8c-b733-2ba50d57fbe0" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

## ✔️ Tela de Integração Concluída

Após salvar, você verá a integração listada com:

* **Nome da Integração** (ex: `[TESTE] CONVERT KIT`)
* **Produto associado** (ex: “Produto Principal”)
* **Menu de Ações** (ícone de três pontos)

***

## 📌 Menu de Ações da Integração

Ao clicar nos três pontinhos, são exibidas as opções:<br>

* **Testar Conexão** Verifica se os dados de API estão funcionando corretamente.
* **Segmentações** Abre a área de regras e automações personalizadas.
* **Editar** Permite alterar dados da integração.
* **Remover** Exclui a integração.

> ⚠️ Remover a integração também desativa todas as segmentações vinculadas a ela.

<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%2FX7J2jNyoR9DnUvMigLZM%2Fimage.png?alt=media&#x26;token=c3852c87-0cc2-4181-bdd7-c32a9f9205e6" alt=""><figcaption></figcaption></figure></div>

***

## 🧠 Segmentações – Criando Regras e Ações

As **Segmentações** permitem que você configure como os leads serão enviados ao ConvertKit ou quais tags serão aplicadas, removidas ou atualizadas.

### Como acessar segmentações

{% stepper %}
{% step %}
Na integração, clique em **Ações**

<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%2FFQ7zJ3zGYmWhBsC6Cqv4%2Fimage.png?alt=media&#x26;token=1b0ea674-f8dd-480b-9117-7d7133ea3be4" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Selecione **Segmentações**

<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%2FjGfEeAOuXrdIt9ySXCMp%2Fimage.png?alt=media&#x26;token=5e2bb437-f33f-429c-bfd0-33ffb566f9e0" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **+ Adicionar nova Segmentação** ou **+ Cadastrar novo**

<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%2F9D4ARilDOMpUqUiVvzXv%2Fimage.png?alt=media&#x26;token=f3c6cf7a-2554-4012-891a-93c22e5d09fa" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Preencha os campos para ativar criar e determinar quando a segmentação será ativada, após preencher clique em **Salvar.**

### 1. **Título da Segmentação**

Nome interno para identificar a regra.\
Exemplos:

* “Tag após compra”
* “Lead pendente”

***

### 2. ⏱️ **Quando o seu Lead...**

Configura o evento que irá disparar a segmentação.

#### **Executar a Ação**

Escolha o evento analisado (ex: compra aprovada, cancelamento, acesso liberado etc.)

#### **Do Tipo**

Define o tipo do evento que será monitorado.

***

### 3. ⚙️ **Execute a Seguinte Ação**

Defina o que acontecerá no ConvertKit quando a segmentação for acionada.

#### **Executar a ação**

Ação principal, como:

* ➕ **Adicionar Tags**
* ➖ **Remover Tags**

#### **Adicionar Tags**

Selecione as tags ConvertKit que serão adicionadas ao lead.

#### **Remover Tags**

Selecione as tags que serão removidas.

💡 *As tags disponíveis são carregadas diretamente da sua conta ConvertKit.*

#### **Salvar**

Finaliza e ativa a segmentaçã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%2F0tA6aiBKu4laQ2f98pFW%2Fimage.png?alt=media&#x26;token=de3f2096-7df7-4f99-81bd-1b826c9743a8" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

***

## 🎉 Após criar a segmentação

A plataforma exibirá uma notificação confirmando que a segmentação foi criada com sucesso.

Você poderá:

* ✏️ Editar
* 🗑️ Excluir
* ➕ Criar novas segmentações

Tudo acessível pelo botão **Ações**.

***

## 🧩 Definições importantes

#### 📌 Produto

Produto dentro da Ticto monitorado pela integração.

#### 📌 Tags (ConvertKit)

Marcadores usados para segmentar contatos e ativar automações.

#### 📌 Eventos

Ações do lead dentro da Ticto que disparam segmentações (ex: compra, acesso, cancelamento).

#### 📌 Segmentação

Regra que define *quando* e *o que* será enviado ao ConvertKit.