> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.membox.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Integração via Webhook

###### ${color}[#4a4a4a](Abra a opção de integração via Webhook na Membox.)


# Veja como integrar

1. Acesse a sua conta na Membox pelo link: [https://app.membox.io/login](https://app.membox.io/login);

2. No menu lateral esquerdo, clique em **Integrações** e depois em **Adicionar nova**;

3. Clique na opção **Webhook** para iniciar;

![](https://storage.crisp.chat/users/helpdesk/website/-/6/d/2/2/6d22ad5234502000/image_jmvh3r.png)

4. Defina qual será o **tipo de acesso**, e se customizado, selecione os cursos a serem liberados para alunos originados através dessa integração;

5. Clique em **Criar integração**.

# Dispare eventos via Webhook
Dispare os eventos seguindo o formato de payload abaixo (**Importante**: todos os campos são obrigatórios).

Para cadastrar um novo aluno ou adicioná-lo a um curso utilize o evento **"insert"**.

```
{ 
"type":"insert",
"customer": {
  "name": "John Doe", 
  "email": "test@emailtest.com", 
  "phone": "12345678900", 
  "document": "51905163002"
}, 
"product": {
   "name": "Curso de exemplo"
}, 
"order_bumps": [{
      "id": "Código de referência do Produto"
}], 
"tags": ["tagexemplo", "tagexemplo2"],
"credential": "credencial-da-integracao"
}
```


Para bloquear um aluno ou removê-lo de um ou mais cursos utilize o evento **"remove"**


```
{ 
"type":"remove",
"customer": {
  "name": "John Doe", 
  "email": "test@emailtest.com", 
}, 
"product": {
   "name": "Curso de exemplo"
}, 
"tags": ["tagexemplo", "tagexemplo2"],
"credential": "credencial-da-integracao"
}
```


# Webhook > Membox
Quando um novo cliente adquirir um produto utilizando o webhook, as informações desse cliente serão enviadas automaticamente para a Membox.

Lá, ele será registrado e vinculado ao curso ou tipo de acesso configurado durante a integração.

Da mesma forma, se o cliente for removido, o acesso ao curso correspondente será automaticamente cancelado na Membox.

No caso de negócios por assinatura, atrasos no pagamento ou cancelamentos resultam no bloqueio ou remoção do acesso aos cursos.

# Observação
Você deverá criar uma integração para cada produto vendido.

**Veja alguns exemplos:**

**1 - Venda de cursos individuais: **neste caso, cada produto deve ter sua própria integração. Ou seja, para cada produto vendido, você deverá criar um webhook.
​
​**2 - Venda de pacotes:** neste cenário, mesmo que o pacote possua mais de um curso, entendemos como um produto único e para ele deve ser criada apenas um webhook.

**Ressaltando **que na integração Membox deverão ser selecionados os cursos a serem liberados no pacote em "Acesso customizado".

**3 - Venda de assinaturas:** aqui também entendemos como apenas um produto e por isso também deverá ser criada apenas um webhook.

**Atenção:** se a assinatura libera todos os cursos, então deverá ser selecionado a opção "Acesso completo" na integração Membox.

Você poderá criar quantos webhooks forem necessários para os seus diferentes produtos.
---
## ${color}[#000000](Suporte Membox)
Se tiver dúvidas, sugestões ou críticas, entre em contato conosco pelo e-mail [hello@membox.io](mailto:hello@membox.io) ou pelo chat da plataforma.

Estamos à disposição para ajudar!