> ## Documentation Index
> Fetch the complete documentation index at: https://docs.assiny.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Membox

> Matricule o aluno na Membox a cada venda aprovada na Assiny e cancele o acesso quando a venda deixar de valer

## Como Integrar com a Membox

A Membox é uma área de membros com aplicativo próprio. Com a integração ativa, quando um novo cliente adquirir um produto na Assiny, as informações desse cliente são enviadas automaticamente para a Membox, que cadastra o aluno e o vincula ao curso.

A conexão é feita por uma URL: você a copia na Membox, ao criar a integração, e a cadastra como webhook na Assiny.

## Antes de começar: como modelar a integração

Esta é a parte que mais gera dúvida, e vale resolver antes de mexer nas duas telas.

Quem decide **quais cursos** o aluno recebe é a integração criada na Membox, e não o produto da Assiny. Ao criar a integração, a Membox pede o tipo de acesso:

| Tipo de acesso | O que ele libera |
| - | - |
| **Acesso completo** | Todos os cursos disponíveis |
| **Acesso customizado** | Apenas os cursos que você selecionar para os alunos originados através dessa integração |

Com isso em mãos, o desenho muda conforme o que você vende:

| O que você vende | Como montar |
| - | - |
| **Curso individual** | Uma integração Assiny → Membox para cada produto vendido |
| **Pacote de cursos** | Um produto único e uma integração, com os cursos do pacote escolhidos em **Acesso customizado** |
| **Assinatura** | Um produto único e uma integração. Se a assinatura libera todos os cursos, use **Acesso completo** |

Você poderá criar quantas integrações forem necessárias.

## Passo a Passo

### Parte 1: Criando a integração na Membox

<Steps>
  <Step title="Acesse a Membox">
    Acesse sua conta na Membox em [app.membox.io/login](https://app.membox.io/login).
  </Step>

  <Step title="Abra as Integrações">
    No menu lateral, clique em **Integrações** e depois em **Adicionar nova**.
  </Step>

  <Step title="Escolha a Assiny">
    Clique na opção **Assiny** para iniciar.
  </Step>

  <Step title="Copie a URL da API">
    Copie a **URL da API** que a Membox exibe. Ela será usada na Parte 2.
  </Step>

  <Step title="Defina o tipo de acesso">
    Escolha entre **Acesso completo** e **Acesso customizado**, conforme a tabela acima. Se escolher **Acesso customizado**, selecione os cursos que essa integração deve liberar.
  </Step>

  <Step title="Crie a integração">
    Clique em **Criar integração**.
  </Step>
</Steps>

### Parte 2: Configurando na Assiny

Na Assiny, a URL da Membox entra como um webhook do projeto — **Webhooks** é um item próprio da barra lateral. A **URL da API** da Membox é geral, e não uma por produto: mesmo que você crie várias integrações do lado da Membox, aqui basta **um webhook**, com todos os produtos entregues pela Membox em **Produtos vinculados**.

<Steps>
  <Step title="Acesse a Assiny">
    Em outra aba, acesse sua conta na Assiny pelo link `https://admin.assiny.com.br/login`, entre na sua organização e abra o projeto.
  </Step>

  <Step title="Abra os Webhooks">
    Na barra lateral do projeto, abra **Webhooks** e clique em **Novo Webhook**.
  </Step>

  <Step title="Preencha a aba Geral">
    A tela **Criando novo webhook** está dividida em **Geral**, **Eventos** e **Avançado**. Os três campos de **Geral** são obrigatórios:

    * **Nome do webhook** — use algo que identifique o destino, por exemplo `Membox`
    * **URL** — cole a **URL da API** copiada da Membox na Parte 1
    * **Produtos vinculados** — selecione os produtos que a Membox entrega
  </Step>

  <Step title="Selecione os eventos">
    Na aba **Eventos**, use o campo **Selecione o evento a ser enviado** para marcar os eventos que a Membox deve receber. A lista completa aparece no próprio campo.
  </Step>

  <Step title="Dispare um evento de teste">
    Ainda em **Eventos**, use a área **Evento de teste** — *"Dispare um evento simulado para verificar a integração."* Assim você confirma que a URL da Membox responde antes de criar o webhook.
  </Step>

  <Step title="Crie o webhook">
    Com as abas preenchidas, clique em **Criar webhook**.
  </Step>
</Steps>

A aba **Avançado** é opcional: traz os **Headers personalizados** (até 3 cabeçalhos HTTP enviados junto ao webhook) e a opção **Ativar personalização de fuso horário**. A Membox não pede nenhum dos dois. Para conhecê-los, veja [Como configurar](/webhooks/como-configurar).

<Warning>
  **Produtos vinculados** define de quais produtos este webhook recebe eventos. Um produto que ficar de fora da seleção não dispara nada — quem comprar esse produto não é cadastrado na Membox, e você só descobre pela reclamação do aluno.
</Warning>

## Pronto!

Sua integração está ativa. A Assiny passa a enviar as vendas para a Membox, que cuida da matrícula e do acesso.

## Depois de configurado

O que acontece na prática, sem nenhuma ação manual:

* **Na compra**, as informações do cliente são enviadas automaticamente para a Membox, e ele é vinculado ao curso conforme o tipo de acesso definido na integração.
* **Se o cliente for removido do produto na Assiny**, o acesso ao curso correspondente é automaticamente cancelado na Membox.
* **Em assinaturas**, atraso no pagamento ou cancelamento resulta no bloqueio ou na remoção do acesso.

<Warning>
  Antes de remover um cliente do produto na Assiny, lembre que a mesma ação tira o curso dele na Membox. Se a ideia era só organizar a base ou corrigir um cadastro, o aluno fica sem acesso.
</Warning>

## Se a integração precisar de ajustes

Na Membox, a integração criada continua sendo a fonte da verdade sobre quais cursos o aluno recebe: mudou o pacote, mudou o escopo do **Acesso customizado**. Na Assiny, a URL e os produtos que alimentam a Membox ficam no webhook cadastrado — abra **Webhooks** na barra lateral para revisar a URL, os **Produtos vinculados** e os eventos marcados, ou para disparar um novo **Evento de teste**.

<CardGroup cols={2}>
  <Card title="Central de Integrações" icon="plug" href="/integracoes/central-de-integracoes">
    Veja todas as integrações disponíveis no painel da Assiny.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks/introducao">
    Entenda como os webhooks da Assiny funcionam, dos eventos aos logs de disparo.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.