> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.kiwify.com.br/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).

# Como integrar com o MailingBoss (BuilderAll)

# Como integrar com o MailingBoss

O MailingBoss é o software de e-mail marketing da ferramenta [BuilderAll](https://builderall.com/).

Você pode adicionar tags aos seus contatos baseado no produto e evento da compra e com isso criar automações de e-mail marketing.

### Buscando sua API Key do MailingBoss

O primeiro passo é pegar a sua API Key do MailingBoss. É através dessa informação que a Kiwify conseguirá conectar na sua conta.

Na dashboard da BuilderAll, clique em **Tools -> Mailingboss**.
![](https://storage.crisp.chat/users/helpdesk/website/-/b/c/e/d/bceda219e6714000/image_kvk00x.png =699xauto)



No menu lateral, clique em **Integration**.

![](https://storage.crisp.chat/users/helpdesk/website/bceda219e6714000/screenshot57_1h9afr4.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/b/c/e/d/bceda219e6714000/image_as88z9.png =291xauto)

Clique em **Copy Token** para copiar a sua **API Key.**![](https://storage.crisp.chat/users/helpdesk/website/-/b/c/e/d/bceda219e6714000/image_1vvlpg2.png =869xauto)



### Conecte a Kiwify ao MailingBoss

No painel da Kiwify, vá no menu **Apps** e clique em **MailingBoss**.

Após isso, clique em **Adicionar conta**.


![](https://storage.crisp.chat/users/helpdesk/website/bceda219e6714000/screenshot7_1br4unh.png)
Escolha um nome para a sua conta do MailingBoss e cole o Token que acabou de copiar. 

![](https://storage.crisp.chat/users/helpdesk/website/bceda219e6714000/screenshot8_15550sc.png)

Agora clique na conta que acabou de ser criada.

![](https://storage.crisp.chat/users/helpdesk/website/bceda219e6714000/screenshot9_zt3soa.png)

### Criando regras para a integração

A nossa integração funciona com um sistema de regras. Cada regra é específica para um produto e é ativada baseada em um evento.

Os eventos disponíveis para criação das regras são: 

* Compra Aprovada;
* Cartão recusado;
* Reembolso;
* Chargeback;
* Carrinho abandonado;
* Boleto Gerado;
* Pix Gerado;
* Assinatura Cancelada;
* Assinatura Atrasada;
* Assinatura Renovada.

Quando o evento configurado na regra ocorrer é executada uma ação que pode ser inserir ou remover tags ou listas no contato.

| Caso o contato seja novo, será adicionado um novo contato. Mas se for um contato existente, será apenas adicionada/removida uma tag ou lista.

![](https://storage.crisp.chat/users/helpdesk/website/bceda219e6714000/screenshot-at-sep-25-11-37-52_1mkkuvh.png)

|| As listas são puxadas diretamente do MailingBoss, mas as tags devem ser digitadas ao criar cada regra.

Depois de criar a regra, é só clicar em "Salvar alterações".

Você pode repetir esse processo e criar quantas regras quiser.

||| Cada regra é obrigatoriamente ligada a um produto. Não é possível ter uma regra única para "todos os produtos"