> ## 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 com a HeroSpark

###### ${color}[#4a4a4a](Abra a opção de integração com a HeroSpark 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 **HeroSpark **para iniciar;

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

**4.** Agora copie a **URL da API**, pois será utilizada no próximo passo dentro da plataforma HeroSpark;


# Crie um webhook na HeroSpark

**1.** Acesse sua conta na HeroSpark pelo link: [https://herospark.com/](https://herospark.com/);

**2**. Após cadastrar o produto, vá até a opção **automações;**


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

3. Clique em** Escolher um modelo > Pagamento confirmado > Usar este modelo;**

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

4. Depois selecione a opção** Gerar um webhook > Ok entendi;**


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

5. Cole a **URL da API** (Membox) no campo "**URL";**


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

6. Preencha os demais campos conforme a orientação abaixo:

* **Filtro de disparo:**
Produtos específicos = selecione o produto que está configurando nessa integração;
* **Edição de webhook:**
Cole a URL da API (Membox) no campo "URL";
* **Método:**
POST;
* **Headers:**
Chave = Content-Type
Valor: application/json
* **Body**

```
{
    "payment_status": "{{ payment_status }}",
    "subscription_status": "{{ subscription_status }}",
    "product_id": "{{ product_id }}",
    "product_name": "{{ product_name }}",
    "buyer_name": "{{ buyer_name }}",
    "buyer_email": "{{ buyer_email }}",
    "buyer_phone": "{{ buyer_phone_raw }}",
    "offer_price": "{{offer_price }}",
    "offer_title": "{{offer_title}}",
    "offer_discount_value": "{{offer_discount_value}}",
    "installments": "{{installments}}",
    "payment_date": "{{payment_date}}",
    "payment_value": "{{payment_value}}",
    "payment_method": "{{payment_method}}",
    "subscription_canceled_by": "{{subscription_canceled_by}}",
    "subscription_available_until": "{{subscription_available_until}}",
    "subscription_expiration_at": "{{subscription_expiration_at}}"
}
```


||| Por Modelo de contratação:
||| Esses procedimentos devem ser aplicados a modelos distintos dependendo do modelo de contratação do seu produto (compra única ou assinatura).
||| Produto de compra única
||| Repita os passos 2 ao 6 no modelo:
||| Chargeback recebido.
||| Produto de assinatura
||| Repita os passos 2 ao 6 nos modelos:
||| Chargeback recebido;
||| Assinatura cancelada;
||| Assinatura inadimplente;
||| Assinatura cancelada pelo cliente;
||| Assinatura cancelada sistema e/ou produtor.


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

### Como coletar ID do produto na HeroSpark

1. Para coletar o ID do produto, vá em: **Menu lateral > Produtos**

2. Seleciona o produto > **Editar**

3. Copie o código do produto que aparecerá na URL dessa página.


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

4. Cole o ID no campo "**ID do produto na HeroSpark**"

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


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

# HeroSpark > Membox
Quando um novo cliente adquirir um produto na HeroSpark, 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 do produto na HeroSpark, 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 uma integração HeroSpark > Membox.
​
​**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 uma integração.

**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 uma integração.

**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 quantas integrações forem necessárias entre a Membox e HeroSpark 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!