# Principia

### Como funciona a integração

Através desta integração, as compras realizadas serão liberadas na sua Área de Membros do Curseduca.

### Configurando a integração

Primeiramente, logue na plataforma <https://parceiro.stage.principia.net/> e crie um curso ou uma turma.

<details>

<summary>Como criar um curso ou turma na Principia?</summary>

Não sabe como criar um curso ou uma turma? Acesse o link da central de ajuda da Principia: <https://provicapital.notion.site/FAQ-Parceiro-3b809c2e22aa4c38b2246b23ec0927e6#ea41034db4b446159c92d8d042302fe1>

</details>

Caso você já tenha um curso ou turma criados, siga o passo a passo para configurar a sua integração de pagamento com o Curseduca.&#x20;

Para iniciar, acesse seu ambiente como instrutor ou administrador e clique no botão <mark style="color:blue;">**Grupo de acesso,**</mark> conforme imagem abaixo:

<figure><img src="/files/H5rflmghhrgUdn4oQbqN" alt=""><figcaption><p>Home</p></figcaption></figure>

Em seguida, seremos direcionados para a página <mark style="color:blue;">**Grupo de acesso**</mark> e, devemos clicar escolher o Grupo a qual desejamos integrar, conforme mostra a imagem:

<figure><img src="/files/GPG5WYbFv3J4lmlzwYJf" alt=""><figcaption><p>Home > Grupo de acesso </p></figcaption></figure>

Na mesma aba, vamos editar o grupo escolhido. Para isso, basta clicar no botão, conforme mostra a imagem:

<figure><img src="/files/m9m4jvKbXakRBFJy5bW5" alt=""><figcaption><p>Home > Grupo de acesso > editar </p></figcaption></figure>

Em seguida, a aba de "**editar grupo de acesso**" se abrirá e você irá clicar em <mark style="color:blue;">**integrações**</mark>, conforme mostra:

<figure><img src="/files/035TJupBO2G7uIRAuRS1" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Agora, vamos <mark style="color:blue;">**+Adicionar nova integração**</mark> clicando no botão:

<figure><img src="/files/YdyhmVUbdGh6gUpJEJUM" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Em seguida copiaremos a "URL do Webhook" da plataforma escolhida, no caso, a **Principia**. De acordo com o print:

{% hint style="info" %}
Dica: Você pode reservar a URL copiada, em um bloco de notas. Pois utilizaremos no próximo passo.
{% endhint %}

<figure><img src="/files/EPIhbDj5jNEduIUnfcgR" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Depois de copiar a URL do Webhook, clique em <mark style="color:blue;">**+Adicionar integração ao grupo de acesso**</mark>, conforme a imagem:

<figure><img src="/files/dcaZcNfCAVNWBwGo9lLi" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Pronto, a primeira parte da integração foi feita.&#x20;

<figure><img src="/files/yGK0CAD4WPlnVv69IZWw" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Agora, vamos configurar a Webhook da Principia!

### Principia - Configuração do Webhook&#x20;

Agora,  abra uma outra aba e logue na plataforma da Principia. No menu a esquerda, clique em 'Configurações'

<figure><img src="/files/oXtpBSi1s9G5A4y7heqV" alt=""><figcaption><p>Principia</p></figcaption></figure>

Em seguida, clicamos no menu superior em 'Integrações'

<figure><img src="/files/Rj5xlXrL5gjyasqJWady" alt=""><figcaption><p>Principia</p></figcaption></figure>

Agora, selecionamos 'Webhooks', conforme a imagem:

<figure><img src="/files/9yuccWheQmuCtragxZo2" alt=""><figcaption><p>Principia</p></figcaption></figure>

Após isso, basta selecionar a opção de **'+criar webhook'**

<figure><img src="/files/ipeFf3D06lYGhVIiyosV" alt=""><figcaption><p>Principia</p></figcaption></figure>

Agora, você irá preencher os seguintes campos

* **Nome:**  Escolha um nome da sua preferência
* **URL** : Aqui, é a URL do webhook que copiamos na página do <mark style="color:blue;">**Curseduca**</mark>, lembra?
* **Token de autorização:** não há necessidade de preenchimento
* **Eventos:** São as eventualidades que podem ocorrer e que fará com que a Principia envie uma notificação ao <mark style="color:blue;">**Curseduca**</mark>, selecione **'TODOS'**

Por fim, clique em **'Criar Webhook'**

<figure><img src="/files/r8NFapc5kS4BQdjA28yh" alt=""><figcaption><p>Principia</p></figcaption></figure>

Feito isso, agora vamos liberar o produto comprado. Certo?

***

### Integração do produto

Seu membro fez uma compra na Principia e agora você precisa liberar este produto? Certo, aprenda aqui o passo a passo.

Ainda na plataforma da Principia, no menu à esquerda, vamos em '**Cursos e Turmas'**

<figure><img src="/files/4dJObSI3EoHrK9yusZpB" alt=""><figcaption><p>Principia</p></figcaption></figure>

Selecione a turma que você deseja vincular  e copie o ID dela

<figure><img src="/files/KEyOKkd1LLCLVcAFHXUQ" alt=""><figcaption><p>Principia</p></figcaption></figure>

Após pegar este código, iremos configurar dentro do produto correspondente no <mark style="color:blue;">**Curseduca**</mark>, abaixo explicaremos detalhadamente este passo a passo.

### Curseduca - Configuração do Produto

Agora vamos cadastrar a ID do **conteúdo** no <mark style="color:blue;">**Curseduca**</mark>**!**

Vamos voltar lá na tela de integrações de Grupo de acesso do <mark style="color:blue;">**Curseduca**</mark>, conforme a imagem:

<figure><img src="/files/yGK0CAD4WPlnVv69IZWw" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Vamos em <mark style="color:blue;">**+Adicionar referência externa**</mark>&#x20;

<figure><img src="/files/fdsLyIqMd3nkO2hxWkJp" alt=""><figcaption></figcaption></figure>

Agora, você irá incluir na <mark style="color:blue;">**referência externa**</mark> o código do **ID da turma**, que coletamos na página na Principia. Nesse caso, o código é `44162`.  Em seguida, clique em **'salvar'.** Conforme segue a imagem:

<figure><img src="/files/pKksUSFPf4HuL1v2tBaM" alt=""><figcaption><p>Home > Grupo de acesso > editar > integrações</p></figcaption></figure>

Prontinho! Sua integração foi realizada.

{% hint style="danger" %}
Informamos que: não oferecemos suporte a este checkout para a compra de múltiplos produtos em uma única transação.
{% endhint %}

{% hint style="info" %}

#### **NOTA:** Todos os códigos e URLs são para exemplificação da Central de Ajuda. Nenhum código deve ser copiado diretamente da Central de Ajuda, cada plataforma tem o seu, por isso siga o passo a passo para obter o seu webhook e o código de produto.

{% endhint %}


---

# 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.curseduca.com/integracoes/principia.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.