> ## 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.

# Cobranças com AI Agent

> Adicione as ferramentas de um gateway de pagamento ao nó AI Agent para que o agente gere o link de pagamento e consulte o status durante a conversa.

O nó **AI Agent** pode cobrar com os gateways de pagamento que você tem instalados: ele gera o link de pagamento dentro da conversa e consulta se o cliente já pagou, sem sair do agente.

Diferente do nó de pagamento, em que você monta a cobrança no fluxo, aqui o agente cria o pedido a partir do que conversou com o cliente. Você decide quais valores ficam fixos e quais o agente preenche.

![Nó AI Agent com a aba Ferramentas aberta, os gateways Stripe, Payphone e Wompi adicionados e a configuração da ferramenta de link de pagamento da Wompi com o valor no modo Estático](https://mintcdn.com/jelouai/COkfMM80RSibEN2U/assets/images/integraciones/pagos/ai-agent-herramientas-pasarela.png?fit=max\&auto=format\&n=COkfMM80RSibEN2U\&q=85\&s=b790344a554454d34941e7d47fb8c197)

Ferramentas da Wompi no nó AI Agent, com o valor fixo

***

## Antes de começar

O gateway precisa estar **instalado e conectado**, com o imposto (IVA) configurado, seja pelo Marketplace ou pela habilitação assistida da equipe Jelou. Veja como o seu [provedor](https://docs.jelou.ai/pt/guias/integracoes/pagamentos/provedores.md) é instalado.

O agente usa as credenciais dessa instalação. Ele não as vê, e você não precisa informá-las de novo no nó.

Gateways disponíveis: **Wompi**, **Kushki**, **Nuvei**, **Mercado Pago**, **Payphone**, **DeUna**, **PayPal**, **Datafast**, **Stripe** e **Conekta**. Placetopay, Niubiz, Culqi e Jelou Pay não têm ferramentas para o agente: para cobrar com eles, use o nó de pagamento.

> [!WARNING]
>
> Stripe e Conekta funcionam apenas com as chaves próprias do comerciante. Se a instalação usa Stripe Connect ou Conekta Connect, a cobrança pelo AI Agent é recusada.

***

## Ferramentas disponíveis

Cada gateway traz duas ferramentas. O nome inclui o gateway, então você pode adicionar vários gateways ao mesmo agente sem confundi-los.

| Ferramenta | O que faz |
| - | - |
| **Gerar link de pagamento `<gateway>`** | Cria o pedido e envia ao cliente o meio de pagamento: um link ou um código, conforme o gateway. Para o agente, devolve o número do pedido e o total. |
| **Consultar status do pagamento `<gateway>`** | Consulta se um pedido foi pago, está pendente ou falhou, a partir do número do pedido. |

> [!NOTE]
>
> O meio de pagamento não passa pelo agente: o sistema o envia diretamente ao cliente. O agente só recebe o número do pedido para usar como referência.

***

## Adicionar as ferramentas ao agente

**1. Abrir as ferramentas do nó**

No Canvas, abra o nó **AI Agent** e vá para a aba **Ferramentas**.

**2. Adicionar o gateway**

Clique em **Adicionar tool**, filtre por **Marketplace** e escolha o gateway. Ele aparece na lista de ferramentas do agente.

**3. Configurar a ferramenta de cobrança**

Clique no ícone de configuração do gateway e abra **Gerar link de pagamento**. Ali você define como cada parâmetro é preenchido e o comportamento depois da execução.

Para cobrar, use **Continuar**: o agente recebe o número do pedido e segue a conversa para informá-lo ao cliente.

**4. Testar a cobrança**

Teste a conversa no tester antes de publicar. Cada cobrança cria um pedido real no gateway, então use uma instalação em [modo de teste](https://docs.jelou.ai/pt/guias/integracoes/pagamentos/modo-teste.md) ou com credenciais de teste. O modo de teste permite até 10 testes por configuração, e a DeUna não tem esse modo.

***

## Fixar o valor e outros dados

Cada parâmetro de **Gerar link de pagamento** pode ser preenchido de duas formas:

* **IA**: o agente obtém o dado da conversa.
* **Estático**: o valor fica fixo. O agente não pede e não pode alterá-lo, mesmo que o cliente diga outro valor no chat.

Fixe o valor e o conceito quando o preço não depende da conversa, por exemplo uma mensalidade ou um serviço com tarifa única.

| Parâmetro | O que é |
| - | - |
| `amount` | Valor antes dos impostos, na moeda do gateway. |
| `concept` | O que o cliente está pagando. Aparece no pedido. |
| `tax_percentage` | Porcentagem de IVA (0 a 30). Se você não definir ou deixar 0, é usado o IVA da instalação. |
| `without_tax` | Se for `true`, o valor é o total e não se soma IVA. |

> [!WARNING]
>
> `amount` é cobrado **mais IVA**. Se você fixar um preço que já inclui o IVA, ative `without_tax`; caso contrário, o cliente paga o imposto duas vezes. Para cobrar sem IVA use `without_tax: true`: um `tax_percentage` em 0 não remove o imposto, porque usa o IVA da instalação.

> [!TIP]
>
> Configure `tax_percentage` e `without_tax` como **Estático**. O cliente não deve decidir o imposto da cobrança.

O total que o cliente paga é o valor mais o IVA, a menos que `without_tax` esteja ativo. O agente recebe esse total na resposta da ferramenta.

***

## Dados do cliente por gateway

Além do valor e do conceito, cada gateway exige alguns dados do pagador. O agente só pede os dados que o gateway exige e que ele ainda não conhece. Os opcionais ele envia se o cliente já os informou.

| Gateway | Dados obrigatórios | Dados opcionais |
| - | - | - |
| **Wompi** | — | E-mail, nome, sobrenome |
| **Kushki** | — | E-mail, nome, sobrenome |
| **PayPal** | — | E-mail, nome, sobrenome |
| **Stripe** | — | E-mail |
| **DeUna** | — | E-mail |
| **Mercado Pago** | E-mail | — |
| **Nuvei** | E-mail, nome, sobrenome | — |
| **Payphone** | E-mail, nome, sobrenome, telefone | — |
| **Conekta** | E-mail, telefone | — |
| **Datafast** | E-mail, nome, sobrenome, documento de identidade, telefone | — |

> [!NOTE]
>
> No WhatsApp o telefone vem da conversa, então o agente não o pede.

***

## O que o cliente vê

Quando o agente gera a cobrança, o cliente recebe a mesma mensagem de pagamento que o nó de pagamento envia, com o botão **Proceder al pago**. Com WhatsApp Business verificado, o [checkout](https://docs.jelou.ai/pt/guias/integracoes/pagamentos/experiencias/checkout-webview.md) abre como WebView sem sair do WhatsApp; se a conta não estiver verificada, abre no navegador do dispositivo.

Depois ele pode perguntar ao agente se o pagamento foi registrado, e o agente consulta com **Consultar status do pagamento**.

![Conversa no tester em que o cliente recebe a mensagem de pagamento com o botão para pagar, o agente informa o total e o número do pedido e depois confirma que o pagamento foi aprovado](https://mintcdn.com/jelouai/COkfMM80RSibEN2U/assets/images/integraciones/pagos/ai-agent-cobro-chat.png?fit=max\&auto=format\&n=COkfMM80RSibEN2U\&q=85\&s=ef7dd3419965ea680a2d05625db29984)

Cobrança e confirmação do pagamento, testadas no tester

> [!NOTE]
>
> O agente só consulta pedidos gerados para o mesmo contato, mesmo que sejam de outra conversa. Assim o cliente pode voltar outro dia para perguntar pelo pagamento, mas não pode consultar pedidos de outros contatos.

***

## Limites atuais

* **Vencimento do link.** No Mercado Pago, Stripe, Conekta e DeUna o link vence em 30 minutos. Na Kushki, a sessão de pagamento dura 15 minutos a partir da abertura do link. Nos demais gateways não há um vencimento comum; enquanto o cliente não paga, o pedido fica pendente.
* **Cada cobrança é um pedido novo.** Se o agente gera outra cobrança, é criado outro pedido, mesmo que haja um pendente.
* **Não há valor máximo.** Se `amount` está no modo **IA**, o valor é definido pela conversa. Quando o preço é conhecido, deixe-o como **Estático**.

***

## Recomendações para o prompt

* **Confirme antes de cobrar.** Cada chamada cria um pedido real. Peça ao agente que mostre o conceito e o valor e espere a confirmação do cliente.
* **Verifique se há um pedido pendente.** Antes de gerar outra cobrança, o agente deve consultar o status do pedido anterior.
* **Não peça o que já está fixo.** Se o valor ou o conceito são estáticos, evite instruções como "confirme o valor com o cliente": o agente não pode alterá-lo.
* **Não cole o link.** O cliente já recebe a mensagem de pagamento. O agente só deve mencionar o número do pedido.

***

## Solução de problemas

> [accordion] O agente pede um dado que eu já fixei
>
> Verifique se o parâmetro está no modo **Estático** na ferramenta e se o prompt não pede ao agente que confirme esse dado com o cliente.

> [accordion] A cobrança é recusada pelo valor mínimo
>
> Cada gateway tem um valor mínimo por moeda. Se o total fica abaixo, a ferramenta responde com uma mensagem como "`<gateway>` no acepta cobros menores a `<mínimo>` `<moeda>`". Aumente o valor ou revise o IVA aplicado.

> [accordion] A cobrança é recusada com Stripe ou Conekta
>
> A instalação usa Stripe Connect ou Conekta Connect. Conecte o gateway com as chaves próprias do comerciante.

> [accordion] O gateway recusa os dados do cliente
>
> Alguns gateways exigem e-mail, nome, sobrenome ou telefone. Confira a tabela de [dados do cliente por gateway](#dados-do-cliente-por-gateway) e se o agente não envia valores vazios.

> [accordion] O agente diz que não conseguiu gerar a cobrança
>
> Revise a execução no debugger para ver a mensagem real que a ferramenta devolveu.

***

## Próximos passos

> [card] [Provedores de pagamento](https://docs.jelou.ai/pt/guias/integracoes/pagamentos/provedores.md)
>
> Como instalar e conectar cada gateway.

> [card] [Modo de teste](https://docs.jelou.ai/pt/guias/integracoes/pagamentos/modo-teste.md)
>
> Teste um gateway sem credenciais próprias.

> [card] [Experiências de pagamento](https://docs.jelou.ai/pt/guias/integracoes/pagamentos/experiencias/tipos-de-experiencia.md)
>
> Diferenças entre checkout, pagamento nativo e confirmação externa.

> [card] [Comissões e custos](https://docs.jelou.ai/pt/guias/integracoes/pagamentos/comissoes-e-custos.md)
>
> Quanto cada gateway cobra por transação.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.