# Cademí via API

## Integração com Área de Membros Externa – Cademí

### 📚 Índice

* Introdução
* Como acessar os dados de API na Cademí
* 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

A **Cademí** é uma plataforma de gestão de áreas de membros que permite a entrega de **cursos online, treinamentos e conteúdos digitais**.

Com a integração nativa entre **Ticto e Cademí**, você pode automatizar todo o processo de liberação de acesso dos alunos, garantindo que o conteúdo seja entregue corretamente conforme o status da compra.

Com essa integração, você pode:

✔️ Liberar acesso automaticamente após a compra aprovada\
✔️ Gerenciar entregas de cursos e assinaturas\
✔️ Remover acessos em casos de reembolso ou cancelamento\
✔️ Reduzir processos manuais e erros operacionais

***

### 🔑 Como acessar os dados de API na Cademí

Antes de configurar a integração na Ticto, é necessário gerar a **API Key** dentro da sua conta Cademí.

#### Passo a passo:

{% stepper %}
{% step %}
Acesse sua conta na **Cademí :** 
{% endstep %}

{% step %}
No menu superior, clique no ícone de **engrenagem (⚙️)**.

<figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FqrvYDOAh8xxIgZSlZEJf%2Funknown.png?alt=media&#x26;token=2c7d5900-28d1-4ebf-ab4a-2ce6f6587cfa" alt=""><figcaption></figcaption></figure>

{% endstep %}

{% step %}
Selecione **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%2F8RyHyDLmEmfOOHGr4s9Y%2Funknown.png?alt=media&#x26;token=9dc585cd-65bb-4f81-928f-3688c45f510f" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Role a página até a seção **Chaves 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%2F51YRbtrhoKRZpPt0FGJH%2Funknown.png?alt=media&#x26;token=be9cf6ac-80f9-4b78-baca-1f6e030279f3" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Clique em **Adicionar Chave** (ícone de **+**).

<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%2FFz7aQrK1O1UQ7JvcpAZP%2Fimage.png?alt=media&#x26;token=cafe9afd-b177-440f-8810-19231c6e4e30" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
No campo **Nome**, informe um identificador (exemplo: *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%2FgcnNPoQ4ynqO7YquPzZN%2Fimage.png?alt=media&#x26;token=4b01bdf4-5825-4b9f-9ee6-f2cc4e14b225" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Salvar & Continuar**.

<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%2Fu9MrSLjR9moRctSGQwck%2Fimage.png?alt=media&#x26;token=658755f9-9d28-4081-a77f-dd71438a239a" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Copie a **API Key** erada.

<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%2FSoOM4kkyLGvGT1VNPK3Q%2Funknown.png?alt=media&#x26;token=7ad04cd5-f5d2-4640-bdec-4f43b2fe600d" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
A API Key será exibida **apenas uma vez**. Guarde-a com segurança antes de sair da página.
{% endhint %}
{% endstep %}
{% endstepper %}

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

Com a API Key em mãos, siga os passos abaixo:

{% stepper %}
{% step %}
Faça login na sua conta **Ticto** [**https://dash.ticto.com.br/signin**](https://dash.ticto.com.br/signin)

<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%2FpV90l0aLbZ5LtKX3PM4T%2Fimage.png?alt=media&#x26;token=d2ed5413-e5ef-4594-a7a7-e711cb96ff39" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
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%2FnjUdTXnNTn0MbbVy5Sh7%2Fimage.png?alt=media&#x26;token=28b2c4c6-9791-4709-be4f-1389e048d8b3" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Selecione **Área de Membros Externa**.

<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%2FSV3MPqS3QLTf4l7LzXSi%2Fimage.png?alt=media&#x26;token=7bfbc557-206d-45fd-b300-e6377bc7b101" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Escolha a opção **Cademí**.

<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%2FvqfMLy140WCtQMEPCUeD%2Fimage.png?alt=media&#x26;token=93370eee-ea1a-45e6-bdd0-d77678925adb" 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%2FNQx5f2o4ujfPttiLfqLT%2Fimage.png?alt=media&#x26;token=7c1632a7-2521-40cf-a634-acba7f1fd042" alt=""><figcaption></figcaption></figure></div>

Preencha os campos abaixo:

* **Produto**\
  Selecione o produto da Ticto que será associado à Cademí.
* **Nome da Conta**\
  Nome interno para identificar a integração (exemplo: *Cademí – Curso de Inglês*).
* **API Key**\
  Cole a chave de API gerada na Cademí.
* **Salvar**\
  Após preencher os campos, clique para concluir o cadastro.

💡 **Dica:** utilize nomes claros para facilitar a gestão futura das integraçõ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%2FFlr40qv3TIrhXuYvE3nI%2Fimage.png?alt=media&#x26;token=7552607d-67ec-4d0d-8443-bcbeaebe0b40" alt=""><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

***

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

Após salvar, a integração será exibida na lista com as seguintes informações:

* Nome da Integração
* Produto associado
* Ações (menu de três pontinhos)

<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%2Fa9Sbe8j6nnvMIX5oL6z3%2Fimage.png?alt=media&#x26;token=7a99cde0-a333-4bae-af53-0997c98351ad" alt=""><figcaption></figcaption></figure></div>

***

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

Ao clicar nos três pontos, você terá acesso às opções:

* **Testar Conexão** \
  Verifica se os dados de API estão funcionando corretamente.
* **Segmentações**\
  Acessa a área de regras e automações da integração.
* **Editar**\
  Permite alterar o nome da integração, API Key ou produto vinculado.
* **Remover**\
  Exclui a integração criada.

{% hint style="warning" %}
Ao remover a integração, todas as segmentações associadas a ela serão desativadas.
{% endhint %}

<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%2Faef9sVGrr3zYstbRvVtI%2Fimage.png?alt=media&#x26;token=e98f7568-1438-4ef9-9bb6-e401a5aaf3e1" alt=""><figcaption></figcaption></figure></div>

***

### 🧠 Segmentações – Criando regras e automações

As **segmentações** definem **quando** e **como** as informações serão enviadas da Ticto para a Cademí.

#### Passo a passo para criar uma segmentação:

{% stepper %}
{% step %}
Na lista de integrações, 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%2FCNUm7vD3s1LawL5RPebv%2Fimage.png?alt=media&#x26;token=1a4a8f49-c13b-4d73-ab5b-db2ab02dcef5" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Na lista clique em **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%2FPr1e9VvoNFPcFxJXP4sd%2Fimage.png?alt=media&#x26;token=3fd43ef5-6b04-426b-8eb4-50c63d3a19b2" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **+ Adicionar nova 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%2FCUROozrO22k8KCOE4boj%2Fimage.png?alt=media&#x26;token=52612d0b-10ee-43e1-a115-6ae02810788c" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Preencha os campos:<br>

#### 🏷️ 1. Cadastrar Segmentação

* **Título da Segmentação**\
  Nome interno para identificar a regra (exemplo: *Compra Aprovada – Curso X*).

***

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

Define o evento que irá disparar a automação.

* **Executar a ação:** Comprar
* **Do tipo:** Compra Aprovada, Reembolsada, Cancelada, entre outras opções disponíveis

***

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

Define o que será executado dentro da Cademí.

* Selecione a **Entrega** a ser efetuada.

{% hint style="warning" %}
Caso a entrega ainda não tenha sido criada na Cademí, não se preocupe! \
Você pode efetuar a criação a partir da sua integração na Ticto, veja o tópico : [#criando-uma-entrega-da-cademi-via-ticto](#criando-uma-entrega-da-cademi-via-ticto "mention")
{% endhint %}

***

#### 🎯 Oferta

Selecione a **oferta do produto** que será responsável por disparar o envio do lead para a Cademí.

***

#### 💾 Salvar

Clique em **Salvar** para gravar a segmentação.

Ao finalizar, será exibida uma mensagem confirmando que a segmentação foi criada com sucesso.

<figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FaUYrLIntJV5CUFJnCdod%2Fimage.png?alt=media&#x26;token=e495f36f-f0e6-4ced-a6da-73b97d0fe349" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### :white\_check\_mark: Criando uma entrega da Cademí via Ticto

Para criar um entrega a partir da Ticto siga os passos:&#x20;

{% stepper %}
{% step %}
Clique em **+Nova Entrega.**

<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%2F6haWEtBAycUADBblNlm5%2Fimage.png?alt=media&#x26;token=ceeedf64-b09a-42a3-b510-40880356acc3" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Preencha os campos:

* Nome da entrega
* Tipo: Simples ou Recorrência.

<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%2FdeihHfdtQWmiOSyFFNl8%2Fimage.png?alt=media&#x26;token=44681d0a-b6fc-47d0-a01f-0ec4e8b6d303" alt=""><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}
Clique no botão de Salvar, para guardar as informações.

<figure><img src="https://3610983464-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnWIfc9hpnMPQKmkeC8kA%2Fuploads%2FMmJEds0uTshosJunAPec%2Fimage.png?alt=media&#x26;token=f7cd30cf-fd16-4d51-a383-3460b40355aa" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Caso a entrega seja criada, finalize a configuração no painel da **Cademí** e retorne à Ticto para concluir a segmentação.
{% endhint %}
{% endstep %}
{% endstepper %}

### 📌 Observações importantes

* Sempre teste a conexão antes de liberar vendas
* Crie segmentações claras para cada tipo de evento
* Utilize nomes descritivos para facilitar a gestão
* Configure também segmentações de **remoção de acesso**, se necessário

***