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

# Conectar no Brain Studio

> Instale o Wompi no Brain Studio, configure suas credenciais e use o nó de pagamento nos seus fluxos.

Conecte o Wompi para habilitar o provedor no seu workspace e deixar o nó de pagamento disponível no Brain Studio com experiência de **WebView incorporado**.

***

## Antes de começar

Certifique-se de ter:

* Uma **conta ativa do Wompi**
* A **chave pública** do Wompi
* A **chave privada** do Wompi
* O **segredo de eventos** do Wompi
* O **segredo de integridade** do Wompi
* A **porcentagem de IVA** que a operação aplicará
* As credenciais corretas para o seu ambiente: **Sandbox** ou **Produção**

<Tip>
  Para obter ou revisar credenciais, siga [Obtenção de credenciais](/pt/guias/integracoes/pagamentos/provedores/wompi/obter-credenciais).
</Tip>

<Warning>
  Para que o checkout seja aberto dentro do WhatsApp como WebView incorporado, a conta precisa ser **WhatsApp Business verificada**.

  Se não estiver verificada, o checkout será aberto no navegador externo do dispositivo.
</Warning>

***

## Formas de iniciar a instalação

Você pode iniciar a instalação do Wompi a partir de diferentes pontos do Brain Studio. Todos os caminhos usam a mesma configuração do provedor.

<Tabs>
  <Tab title="Jelou Agent">
    Peça ao Jelou Agent para adicionar pagamentos com Wompi enquanto você constrói ou ajusta um fluxo.

    Exemplos:

    * "Adicione pagamentos com Wompi a este fluxo"
    * "Preciso cobrar com Wompi neste caso"
    * "Quero processar pagamentos com Wompi"

    O Jelou Agent detecta o Wompi como provedor disponível no Marketplace e inicia o fluxo assistido de instalação.
  </Tab>

  <Tab title="Marketplace">
    Abra o **Marketplace**, busque por **Wompi** em **Pagamentos & Processamento** ou use o buscador.

    Em seguida, pressione **Conectar** ou **Instalar** para iniciar o fluxo de instalação.
  </Tab>

  <Tab title="Nó Pagamentos">
    Na barra de ferramentas do **Canvas**, abra o nó **Pagamentos**.

    Dentro do nó **Pagamentos**, você verá o **Wompi** como provedor disponível. Se ainda não estiver conectado, pressione **Instalar** para iniciar o mesmo fluxo de conexão usado pelo Marketplace, Jelou Agent e templates.

    <Frame caption="Wompi disponível para instalar a partir do nó Pagamentos no Canvas">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-pagos-instalar.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=95139a18f9e2d4c1c3e7c3b2f6194134" alt="Nó Pagamentos no Canvas mostrando o Wompi como provedor disponível com a opção Instalar" style={{ maxHeight: '355px', width: 'auto', margin: '0 auto' }} width="500" height="708" data-path="assets/images/integraciones/pagos/wompi-pagos-instalar.png" />
    </Frame>
  </Tab>

  <Tab title="Templates">
    Alguns templates do Brain Studio podem incluir configuração de pagamentos.

    Durante a criação do template, o Brain Studio pode pedir que você escolha um provedor de pagamento e conecte o Wompi como parte do fluxo de configuração.
  </Tab>
</Tabs>

<Note>
  Todos os caminhos de instalação usam a mesma configuração do provedor. O que muda é o ponto de onde você inicia o fluxo.
</Note>

***

## Fluxo comum de instalação

Independente do ponto de entrada, o processo compartilhado é o seguinte.

<Steps>
  <Step title="Escolher credenciais de teste ou produção">
    O Brain Studio pedirá que você selecione se conectará o Wompi com **credenciais de teste** ou com **credenciais de produção**.

    No Wompi, essas credenciais correspondem a chaves de **Sandbox** ou de **Produção**.

    <Frame caption="Seleção do ambiente para conectar o Wompi">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-conectar-seleccion-ambiente.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=d5499b48a3364c3bfc6eed82616f62dc" alt="Modal do Brain Studio para escolher entre credenciais de teste ou credenciais de produção ao conectar o Wompi" width="1024" height="392" data-path="assets/images/integraciones/pagos/wompi-conectar-seleccion-ambiente.png" />
    </Frame>
  </Step>

  <Step title="Preencher as quatro credenciais">
    Preencha o modal com:

    * **Chave pública**
    * **Chave privada**
    * **Segredo de eventos**
    * **Integridade**

    <Frame caption="Credenciais necessárias para conectar o Wompi">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-conectar-credenciales.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=dfcec4660f4c3c5890c0b6af92d1fb00" alt="Modal do Brain Studio para inserir chave pública, chave privada, segredo de eventos e integridade do Wompi" width="1024" height="768" data-path="assets/images/integraciones/pagos/wompi-conectar-credenciales.png" />
    </Frame>
  </Step>

  <Step title="Configurar IVA aplicado">
    Defina o **IVA aplicado** que a integração utilizará durante a operação de cobrança.

    <Frame caption="Configuração do IVA aplicado para o Wompi">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-conectar-iva.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=5f15bbf566ab0318e53f8602ed0977e7" alt="Modal do Brain Studio para configurar o IVA aplicado durante a conexão do Wompi" width="1024" height="429" data-path="assets/images/integraciones/pagos/wompi-conectar-iva.png" />
    </Frame>
  </Step>

  <Step title="Confirmar a conexão">
    Confirme a conexão. O Brain Studio salvará a configuração e deixará o **Wompi** disponível no seu workspace.
  </Step>

  <Step title="Usar o Wompi pelo nó Pagamentos no Canvas">
    Depois de instalar, você poderá usar o Wompi a partir do nó **Pagamentos** no **Canvas**, tenha o fluxo começado pelo Jelou Agent, Marketplace, nó Pagamentos ou template.
  </Step>
</Steps>

***

## Credenciais Sandbox vs Produção

O Wompi separa as credenciais por ambiente:

* **Sandbox:** credenciais para testes sem dinheiro real.
* **Produção:** credenciais para processar pagamentos reais.

As chaves e segredos têm prefixos diferentes conforme o ambiente:

| Ambiente | Chave pública  | Chave privada  | Segredo de eventos | Segredo de integridade |
| -------- | -------------- | -------------- | ------------------ | ---------------------- |
| Sandbox  | `pub_test_...` | `prv_test_...` | `test_events_...`  | `test_integrity_...`   |
| Produção | `pub_prod_...` | `prv_prod_...` | `prod_events_...`  | `prod_integrity_...`   |

<Warning>
  As credenciais Sandbox não processam pagamentos reais. Antes de operar em produção, você deve conectar o Wompi usando credenciais produtivas.
</Warning>

<Tip>
  Use sempre credenciais do mesmo ambiente. Não misture chaves ou segredos de Sandbox com chaves ou segredos de Produção.
</Tip>

***

## Passar para produção

Se você instalou o Wompi com credenciais de **desenvolvimento/Sandbox**, pode usar o nó de pagamento para testes. Para operar com pagamentos reais:

<Steps>
  <Step title="Abrir Passar para produção">
    Você pode iniciar a mudança a partir de:

    * A **barra lateral avançada** do nó Wompi no **Canvas**
    * A página de **Wompi** no **Marketplace**

    Em ambos os casos, é aberto o mesmo modal para passar a integração para produção.

    <Frame caption="Modal para passar o Wompi para produção">
      <img src="https://mintcdn.com/jelouai/qfuCOV36dV96m5-d/assets/images/integraciones/pagos/wompi-pasar-a-produccion.png?fit=max&auto=format&n=qfuCOV36dV96m5-d&q=85&s=081a3fb2363e6886c60fb41ff2202557" alt="Modal do Brain Studio para passar a integração do Wompi para produção" width="1024" height="896" data-path="assets/images/integraciones/pagos/wompi-pasar-a-produccion.png" />
    </Frame>
  </Step>

  <Step title="Preencher credenciais produtivas">
    Insira as credenciais de Produção:

    * **Chave pública**
    * **Chave privada**
    * **Segredo de eventos**
    * **Integridade**
  </Step>

  <Step title="Confirmar IVA aplicado">
    Revise e confirme o **IVA aplicado** que a integração usará em produção.
  </Step>

  <Step title="Confirmar a mudança">
    Confirme a ação. A partir desse momento, a integração opera com credenciais de produção.
  </Step>
</Steps>

***

## Alterar credenciais

* Para passar de **desenvolvimento/Sandbox** para **Produção** com a mesma instalação, use a seção **Passar para produção**.
* Para **rotacionar credenciais** ou **substituir a configuração**, desconecte o Wompi e instale novamente seguindo o **fluxo comum de instalação** desta página.

***

## Próximo passo

Uma vez conectada a integração, continue com:

<Card title="Uso e configuração" href="/pt/guias/integracoes/pagamentos/provedores/wompi/uso-e-configuracao" icon="gear">
  Configure o nó de pagamento e continue o fluxo conforme o resultado do pagamento em WebView.
</Card>
