# Circle

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

O **Circle** é uma plataforma de área de membros focada na criação de **comunidades interativas**, ideal para cursos, mentorias, assinaturas e produtos digitais que exigem maior engajamento entre alunos e produtores.

Com a integração entre **Ticto + Circle**, é possível **automatizar o gerenciamento de acessos**, garantindo que os participantes sejam adicionados ou removidos da comunidade de acordo com o status da compra.

***

### 📚 Índice

* Introdução
* Quando utilizar a integração com o Circle
* Como acessar a integração no painel Ticto
* Criando uma nova integração com o Circle
* Gerenciando integrações existentes
* Próximos passos após a integração
* Observações importantes

***

### 🎯 Introdução

A integração da **Ticto com o Circle** permite que ações como **compra aprovada, cancelamento ou reembolso** sejam utilizadas para controlar automaticamente o acesso dos alunos à sua comunidade.

Isso garante uma experiência mais profissional, organizada e sem a necessidade de liberações manuais.

Com essa integração, você pode:

* Adicionar membros automaticamente à comunidade
* Controlar o acesso conforme o produto adquirido
* Reduzir tarefas operacionais
* Oferecer uma jornada fluida ao aluno

***

### 🤔 Quando utilizar a integração com o Circle

A integração com o Circle é indicada se você:

* Utiliza o **Circle** como área de membros ou comunidade
* Trabalha com cursos, mentorias ou assinaturas
* Não deseja usar o **Mozart** (área de membros nativa da Ticto)
* Precisa automatizar a entrada e saída de membros

***

## 🌐 Como acessar os dados de API no Circle

Antes de configurar a integração na Ticto, você precisa copiar dois dados dentro da sua conta Circle:<br>

* **API Key**

#### 🔑 Passo a passo:

{% stepper %}
{% step %}
Caso você ainda não possua uma conta **Circle**, basta acessar o <https://circle.so/> informar o e-mail que deseja utilizar e clicar em

**"Começar de graça"**

<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%2F0Qf3RptrkYWNOwWLLX1u%2Fimage.png?alt=media&#x26;token=43390387-9141-4fe4-853e-561b03da542b" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
No canto superior esquerdo, clique no **nome ou logotipo da sua comunidade**.
{% endstep %}

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

{% endstep %}

{% step %}
Clique em **API** ou procure por **Developers > Tokens** na barra lateral esquerda, dependendo da interface.
{% endstep %}

{% step %}
Clique em **Create Token** ou **Create Key**

{% endstep %}

{% step %}
Dê um **nome** ao seu token (ex: "Integração Make", "API App").

{% endstep %}

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

{% endstep %}

{% step %}
**Copie a chave** gerada e guarde-a em um local seguro, pois ela pode não ser exibida novamente.&#x20;

{% hint style="danger" %}
Nunca compartilhe sua API Key publicamente. Ela permite acesso direto à sua conta Circle
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 🧭 Como acessar a integração no painel Ticto

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

<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%2FLJCrSyVl5lAiWnjmW3k3%2Fimage.png?alt=media&#x26;token=2b022596-48a5-43a9-9d60-825c999cf7e3" 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%2FzIze43XttVGswHnzqOFZ%2Fimage.png?alt=media&#x26;token=d7546443-6f9b-45d5-ba38-fd6a1b361f61" alt=""><figcaption></figcaption></figure></div>

Preencha os campos abaixo:

* **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í.
* **Produto**\
  Selecione o produto da Ticto que será associado à 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%2FLmYjI2aPQWqBEDNYruC3%2Fimage.png?alt=media&#x26;token=3cf403e8-7353-4eb8-9edd-357b88700014" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
A API Key precisa estar **ativa e válida**. Caso esteja incorreta, a integração não será criada.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### ✔️ Gerenciando integrações existentes

A

No menu **Ações** da integração, você encontrará:

* **Testar Conexão**\
  Verifica se a comunicação com o Circle está funcionando corretamente.
* **Segmentações**\
  Acessa a área onde você cria as regras de automação.
* **Editar**\
  Permite alterar nome, API Key ou produto vinculado.
* **Remover**\
  Exclui a integração criada.

<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%2FVTer0Z4gKetpCFo0ynPG%2Fimage.png?alt=media&#x26;token=0c650216-afa4-4902-bcf7-b02bb2295a6f" alt=""><figcaption></figcaption></figure></div>

> ⚠️ **Importante**\
> Ao remover uma integração, todas as segmentações vinculadas a ela também serão desativadas.

### 🧠 Segmentações – Como funcionam

Após criar a integração com o **Circle**, é necessário configurar as **segmentações**. Elas são responsáveis por definir **quando** e **como** um membro será adicionado ou removido da comunidade.

As segmentações conectam eventos da Ticto (como compra aprovada ou reembolso) a ações automáticas no Circle.

***

### ➕ Criando uma segmentação no Circle

1. Acesse a integração do Circle criada.
2. Clique em **Ações → Segmentações**.
3. Clique em **+ Adicionar nova segmentação**.

***

#### 🏷️ Campos da segmentação

**Título da Segmentação**

Nome interno da regra, usado apenas para organização.

Exemplo:

* Compra Aprovada – Comunidade Premium
* Reembolso – Remover Acesso

***

**Quando o seu Lead**

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

**Do tipo:**

* Compra Aprovada
* Reembolsada
* Chargeback

***

**Execute a seguinte ação**

Define o que acontecerá no Circle quando o evento for disparado.

Opções disponíveis:

* **Adicionar contato**\
  Adiciona o membro à comunidade ou espaço configurado.
* **Remover contato**\
  Remove o acesso do membro à comunidade.
* **Adicionar a assinatura**\
  Vincula o membro a uma assinatura ativa no Circle.
* **Ilimitado (todos os acessos)**\
  Concede acesso completo a todos os espaços disponíveis no Circle.

***

**Turma / Espaço**

Quando aplicável, selecione o **espaço ou comunidade** à qual o membro será adicionado.

> 💡 Caso a opção **Ilimitado (todos os acessos)** seja selecionada, esse campo não será exibido.

***

**Salvar**

Após configurar todos os campos, clique em **Salvar** para ativar a segmentação.

Uma mensagem de sucesso será exibida confirmando o cadastro.

***

### ✏️ Gerenciando segmentações

Após criadas, as segmentações poderão ser:

* Editadas
* Excluídas

Tudo isso pelo botão **Ações** ao lado de cada segmentação.

***

### 📌 Observações importantes

* Verifique sempre se a API Key está correta
* Teste a integração antes de iniciar as vendas
* Utilize nomes claros para identificar suas integrações
* Planeje as regras de acesso conforme o tipo do produto


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.ticto.com.br/sou-produtor/tictools-integracoes/area-de-membros-externa/circle.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.