> ## 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.
# Uso e configuração
> Adicione o nó do Conekta ao seu fluxo no Canvas, configure seus inputs e teste pagamentos em ambiente de teste.
Depois de conectada a integração, o nó do **Conekta** fica disponível no Canvas e permite criar experiências de cobrança com **WebView incorporado** dentro do fluxo conversacional.
Se você ainda não instalou a integração, siga primeiro [Conectar no Brain Studio](/pt/guias/integracoes/pagamentos/provedores/conekta/conectar-no-brain-studio).
***
## Adicionar o nó ao Canvas
Abra no Brain Studio o fluxo onde deseja incorporar a cobrança com Conekta.
Adicione **Conekta** na barra de ferramentas do **Canvas**, no nó **Pagamentos**, ou a partir dos provedores de pagamento disponíveis depois que a integração estiver instalada.
O ponto exato pode variar conforme você iniciou a instalação pelo Marketplace, Jelou Agent, nó Pagamentos no Canvas ou um template.
Conecte o nó do Conekta depois que o fluxo já tiver o valor e a confirmação de compra.
Selecione o nó para abrir o painel lateral direito e completar os **inputs** e revisar as **saídas** disponíveis.
***
## Configurar o nó
### Dados do pagamento
Ative para definir as mensagens que acompanham o botão de pagamento na conversação.
Se estiver desativada, o Brain Studio usa os textos padrão da mensagem de cobrança.
Título da mensagem do botão de pagamento.
Exibido quando **Personalização** está ativa. Aparece na visualização prévia da mensagem.
Texto principal da mensagem do botão de pagamento.
Exibido quando **Personalização** está ativa. Aparece na visualização prévia da mensagem.
Texto de encerramento da mensagem do botão de pagamento.
Exibido quando **Personalização** está ativa. Aparece na visualização prévia da mensagem.
Texto descritivo da cobrança. Exemplos: número do pedido, produto, serviço ou referência interna.
Você pode mapeá-lo a partir de variáveis do fluxo, por exemplo `{{$memory.paymentBreakdown.summary}}`.
Valor sobre o qual se aplica IVA. Apenas números.
Você pode mapeá-lo a partir de variáveis do fluxo.
Valor isento de impostos. Se não se aplicar, use `0`. Apenas números.
Você pode mapeá-lo a partir de variáveis do fluxo.
Com **Personalização** desativada, o painel mostra diretamente os campos da cobrança. O nó no Canvas expõe as saídas **Pagamento bem-sucedido**, **Pagamento pendente**, **Mensagem de pagamento enviada**, **Pagamento falhou** e **Erro**.
### Avançado
O bloco **Ambiente** mostra se o Conekta opera em **Desenvolvimento** ou **Produção**.
Se a integração estiver em **Desenvolvimento**, a partir daí você pode iniciar o fluxo **Passar para produção**.
Se a integração estiver em **Produção**, o bloco reflete que o Conekta já opera com credenciais produtivas.
O ambiente depende das credenciais instaladas. Não passe para produção sem preparar credenciais produtivas.
Indica que o checkout do Conekta abre como **WebView incorporado** dentro da experiência conversacional.
Define por quanto tempo o botão de pagamento permanece válido após ser enviado.
Os valores disponíveis dependem da configuração visível no Brain Studio.
Define a moeda da cobrança.
Para Conekta México, normalmente você usará `MXN`.
Define o percentual de IVA aplicado à operação de cobrança.
Campo opcional para guardar referência interna como ID do pedido, correlativo, user ID ou booking ID.
Define o nome da variável de memória onde o Brain Studio armazenará a resposta do nó.
A resposta ficará disponível em nós posteriores do fluxo, por exemplo `{{$memory.paymentResponse}}`.
Útil para rastreabilidade, validações posteriores ou decisões do fluxo.
Ativa quando o Conekta confirma que a transação foi aprovada.
**Recomendações:**
* confirmar o pedido
* emitir comprovante ou atualizar status em sistemas externos
Ativa quando a transação fica em processo ou requer confirmação posterior.
**Recomendações:**
* informar o usuário com clareza
* evitar criar uma segunda cobrança enquanto o status é resolvido
* aguardar atualização por evento quando corresponder
Ativa quando a mensagem com o botão de pagamento é enviada corretamente na conversação.
Esta saída **não** confirma o pagamento. Indica apenas que a mensagem com o botão de pagamento foi enviada corretamente na conversação.
Você pode conectar esta saída a um **AI Agent de suporte pós-envio da mensagem de pagamento** para assistir o usuário enquanto decide abrir o checkout ou se tiver dúvidas antes de pagar.
**Recomendações:**
* resolver dúvidas sobre como abrir o botão de pagamento
* ajudar se o WebView não carregar ou se o usuário não entender a etapa
* evitar criar uma nova cobrança sem contexto
* não confirmar pagamentos a partir desta saída
**Exemplo de prompt (referencial):**
```txt theme={null}
INTERRUPÇÃO IMEDIATA:
- Se a última mensagem do usuário contiver a estrutura de um recibo de pagamento (inclui elementos como "Pago aprobado", "N° de operación", "Pagamento aprovado", "Operação", o símbolo ✅ seguido de dados de transação, separadores ━━━, ou padrões como "Monto:", "Valor:", "Medio de pago:", "Método:"), NÃO responda absolutamente nada. Execute end_function imediatamente com status "payment_completed".
Você é "Suporte de Pagamento", um assistente de ajuda para concluir pagamentos de teste dentro do WhatsApp. Contexto: o usuário acabou de receber um botão (CTA) para realizar um pagamento de teste junto com os dados de um cartão fictício. Seu papel NÃO é vender nem recalcular valores: apenas ajudar a concluir o pagamento ou resolver problemas do botão.
COMPORTAMENTO-CHAVE
- Este agente pode ser executado sem que o usuário tenha escrito nada.
- Se NÃO houver uma pergunta ou problema explícito do usuário na última mensagem, envie SOMENTE esta mensagem proativa (uma única vez) e depois fique em modo reativo: "Se tiver qualquer dúvida com seu pagamento, escreva aqui que eu te ajudo."
- Se o usuário ESCREVER (pergunta/problema), responda direto, breve e claro.
- Não reinicie o processo. Não recalcule valores. Não gere novos links. Não invente informações.
- Máximo 1 emoji por mensagem.
O QUE VOCÊ SUPORTA
- Como pagar a partir do botão.
- O botão não abre / erro ao carregar.
- Dúvidas sobre os dados do cartão de teste.
- Pagamento pendente ou recusado.
- Problemas com o formulário de pagamento.
Se o usuário relatar um problema:
1) Peça uma descrição curta.
2) Se ajudar, peça captura de tela (pode enviar imagens).
3) Sugira tentar novamente ou indique que a consulta pode ser escalada.
CONTEXTO DO DEMO
- Os dados do cartão que o usuário recebeu são fictícios e seguros, não geram cobranças reais.
- O formulário de pagamento abre a partir do botão CTA que ele já recebeu.
- Este é um ambiente de teste para demonstrar como funcionam os pagamentos no Brain Studio.
ENCERRAMENTO / FIM DA TAREFA
Se o usuário disser que já pagou e não precisa de mais ajuda (ex.: "listo", "gracias", "ya pagué", "era eso", "todo bien"), responda curto e encerre:
Espanhol: "Perfecto. Si necesitas algo más, aquí estaré."
Português: "Perfeito. Se precisar de algo mais, estarei por aqui."
Depois execute end_function com status "completed".
## TERMINAÇÃO
Execute end_function nestes casos:
- WHEN: A mensagem contém estrutura de recibo de pagamento (✅, ━━━, "Pago aprobado", "Pagamento aprovado", "N° de operación", "Operação") → status: "payment_completed", message: "" (vazio, não responda nada)
- WHEN: O usuário indica que terminou ou não precisa de mais ajuda → status: "completed", message: ""
## Regras Operacionais
- Sempre execute end_function com este formato:
{
"output_schema": "{\"status\": \"payment_completed|completed\", \"message\": \"...\"}"
}
- Para payment_completed: message DEVE ser string vazia "". Não gere nenhum texto de resposta antes de executar end_function.
```
Ativa quando a transação foi rejeitada, recusada, negada ou não é concluída.
**Recomendações:**
* permitir nova tentativa controlada
* oferecer suporte ou um caminho alternativo
Ativa diante de erros técnicos, erros do provedor ou falhas de comunicação durante a criação ou o processamento do pagamento.
**Recomendações:**
* registrar o erro
* mostrar mensagem de contingência
* tentar novamente de forma controlada e escalar se persistir
***
## Testar pagamentos em ambiente de teste
Se o Conekta estiver conectado com credenciais de **teste**, você pode testar o checkout com os dados de teste publicados pelo Conekta.
Em ambiente de teste, o pagamento é fictício e não move dinheiro real.
Verifique se o Conekta está instalado com credenciais do ambiente de teste.
Na aba **Avançado**, verifique se o ambiente corresponde a desenvolvimento/teste.
Dispare o fluxo a partir do WhatsApp, abra o checkout WebView do Conekta e selecione um método de pagamento de teste.
Verifique por qual saída o fluxo continua:
* **Pagamento bem-sucedido**
* **Pagamento pendente**
* **Pagamento falhou**
* **Erro**
***
## Passar para produção
Se você instalou o Conekta com credenciais de **desenvolvimento/teste**, pode iniciar a passagem para produção na aba **Avançado** do nó Conekta no **Canvas** ou na página do **Conekta** no **Marketplace**.
Em ambos os casos abre-se o mesmo modal para inserir credenciais produtivas e confirmar a configuração correspondente.
Antes de operar com pagamentos reais:
* Certifique-se de ter credenciais de **produção** completas: chave pública e chave privada.
* Use o fluxo **Passar para produção** descrito em [Conectar no Brain Studio](/pt/guias/integracoes/pagamentos/provedores/conekta/conectar-no-brain-studio).
* Substitua no nó qualquer dado de teste por dados reais do fluxo.
* Execute um teste real de baixo valor antes de escalar.
***
## Considerações importantes
Se instalou o Conekta com credenciais de teste, teste com dados de teste. Se instalou com credenciais de produção, use dados reais.
Em cenários pendentes ou falhos, informe com clareza antes de iniciar outra tentativa de cobrança. Mantenha novas tentativas controladas.
Cartões e métodos de teste aplicam-se apenas em ambiente de teste. Em produção o usuário deve usar dados reais.
***
## Próximo passo
Revise disponibilidade, moeda, métodos de pagamento e considerações comerciais do Conekta.