Saltar para o conteúdo principal

Pagamentos com SumUp, Mercado Pago, Flow e Wompi

Com a Ação Pagamento, o seu agente do ChatNorris cobra dentro da conversa. Você configura um catálogo fechado de itens com os seus valores, e o agente:
  • monta um carrinho com um ou vários itens do catálogo, com o total;
  • pede ao visitante uma confirmação explícita antes de cobrar;
  • gera um link de pagamento pelo total com o provedor que você escolher;
  • avisa no chat quando o provedor confirma o pagamento.
O agente nunca inventa um valor: ele só pode cobrar os valores exatos que você configura. As cobranças são processadas na sua própria conta do provedor. Funciona no widget web, WhatsApp, Instagram, Messenger, Telegram, Email e na API.

Requisitos

  • Uma conta do ChatNorris com plano Standard ou Premium. Você pode ver os planos em chatnorris.ai/pricing.
  • Pelo menos um agente criado no ChatNorris. Se você ainda não tiver um, siga Criar um agente.
  • Uma conta em pelo menos um dos provedores (SumUp, Mercado Pago, Flow ou Wompi) e acesso às credenciais de API dela.
  • Função Owner ou Admin na sua organização do ChatNorris.

Conectar um provedor

Conecte pelo menos um provedor no agente. Você pode conectar vários e escolher na Ação com qual a cobrança é feita.
1

Abra o hub de Integrações do agente

No ChatNorris, acesse Agentes → [seu agente] → Integrações e escolha SumUp, Mercado Pago, Flow ou Wompi.
2

Cole as credenciais e conecte

Cada provedor pede dados diferentes: você os encontra mais abaixo, na seção de cada um. Clique em Conectar.
3

Teste a conexão

Use Testar conexão para confirmar que as credenciais funcionam antes de usá-las na Ação.
O hub mostra apenas os últimos 4 caracteres de cada chave. Se você trocá-la no provedor, use Substituir chave no menu ··· da linha: a conexão continua sendo a mesma e a Ação não é alterada.

SumUp

Pede o Merchant code (você o vê no dashboard da SumUp, por exemplo MH4H92C7) e a API key, que você gera em me.sumup.com/settings/api-keys. O visitante paga na página de pagamento da SumUp (Hosted Checkout).

Mercado Pago

Pede a Public Key e o Access Token, que você encontra na sua conta do Mercado Pago, em Suas integrações → Credenciais (começam com APP_USR-). O visitante paga na página do Mercado Pago (Checkout Pro). Uma única conexão serve para toda a América Latina. O link expira em 30 minutos; se vencer, o visitante pode pedir um novo.

Flow (Chile)

Pede a API Key e a Secret Key da sua conta do Flow, que você encontra em Flow → Mis datos, aba Integraciones. O ChatNorris as valida no Flow ao salvá-las e detecta se são de testes (sandbox) ou de produção: produção e sandbox são contas diferentes, com chaves diferentes. Com chaves de sandbox, a conexão mostra a etiqueta Sandbox e os pagamentos são de teste, sem dinheiro real. Se você escolher Flow como gateway na Ação:
  • Os itens precisam estar em pesos chilenos (CLP), com valores inteiros e de pelo menos 350 CLP (o mínimo do Flow). Se algum item habilitado não cumprir essas regras, a Ação pede que você o corrija ou desabilite antes de ativá-la.
  • Antes de gerar o link, o agente pede o email do visitante, se ainda não o tiver: o Flow o exige para enviar o comprovante. Se o Flow recusar esse email, o agente pede outro.
  • O visitante paga na página do Flow com Webpay (crédito, débito e pré-pago), Khipu (transferência) ou os demais meios que você tiver habilitados na sua conta do Flow.
  • O link expira em 30 minutos; se vencer, o visitante pode pedir um novo.

Wompi (Colômbia)

Por enquanto, funciona com contas do Wompi Colômbia. Pede quatro dados que você encontra no seu painel do Wompi, em Desarrolladores (“Llaves del API” e “Secretos para integración técnica”): Os quatro precisam ser do mesmo ambiente. Com chaves de teste (pub_test_…, prv_test_…, test_integrity_… e test_events_…), a conexão mostra a etiqueta Sandbox e os pagamentos são simulados, sem dinheiro real. Se uma chave não funcionar, o formulário diz qual. Para atualizar a conexão, cole as quatro novamente.
Depois de conectar, o ChatNorris mostra a URL de eventos. Copie-a em Wompi → Desarrolladores → URL de Eventos, no mesmo ambiente das suas chaves, para que os pagamentos sejam confirmados mesmo que o visitante feche a aba do pagamento. O Wompi aceita uma única URL de eventos por ambiente, então substitua a que você tiver configurada ali: se outro sistema a usava (por exemplo, a sua loja on-line), ele deixa de receber esses avisos.
Se você escolher Wompi como gateway na Ação:
  • Os itens precisam estar em pesos colombianos (COP), com valores inteiros e de pelo menos 1.500 COP. O carrinho com vários itens funciona igual ao dos demais provedores.
  • O visitante paga na página do Wompi com cartão, Nequi, Daviplata, PSE, Transferencia Bancolombia ou SU+ Pay, de acordo com os meios que você tiver habilitados na sua conta do Wompi.
  • O link expira em 30 minutos; se vencer, o visitante pode pedir um novo.

Configurar a Ação

Conectar o provedor ainda não ativa nada. Para que o agente cobre:
1

Crie a Ação Pagamento

Acesse Agentes → [seu agente] → Ações, clique em Nova ação e escolha Pagamento.
2

Escolha o gateway de pagamento

O campo Gateway de pagamento decide com qual provedor conectado o link é gerado. Alterá-lo não apaga o catálogo de itens nem as conexões: só decide qual é usado.
3

Configure o catálogo de itens

Em Catálogo de itens, adicione cada item cobrável com Adicionar item: nome, descrição (opcional), valor e moeda. A moeda é por item; o campo Moeda da Ação só define a moeda padrão dos itens novos. O agente só pode cobrar os valores exatos configurados aqui.
4

Personalize a mensagem de sucesso e a página de retorno

A Mensagem após o pagamento é enviada no chat quando o provedor confirma a cobrança. A Página de retorno (opcional) é para onde o visitante volta depois de pagar; se ficar vazia, ele vê a tela de sucesso do próprio provedor.
5

Ative a Ação e salve

Com Ação habilitada ativa, clique em Salvar. Enquanto ela estiver desabilitada, o agente nunca oferece nem gera links de pagamento.
Em Quando usar esta ação, você pode ajustar as instruções que o agente segue, turno a turno, para decidir se é o caso de gerar um link de pagamento. Com Restaurar texto padrão, você volta ao texto original.
Recomendamos usar Claude Sonnet ou um modelo superior como principal em agentes com esta ação (Configurações → IA). Criar um link de pagamento é uma cobrança real. Em testes, modelos mais econômicos (por exemplo, Haiku) às vezes confirmam um pagamento ou inventam um número de comprovante sem ter gerado nenhum checkout, mesmo com instruções explícitas para não fazer isso. O formulário da Ação mostra esse aviso com um link para a configuração de IA.
O agente sempre pede uma confirmação explícita do visitante antes de gerar o link de pagamento: isso não pode ser desativado. Veja quais respostas contam como confirmação em Ações do agente.As cobranças são processadas na sua própria conta do SumUp, Mercado Pago, Flow ou Wompi: o ChatNorris nunca recebe o dinheiro nem vê dados de cartão. Ele só gera o link e fica sabendo da confirmação, que sempre verifica com o provedor antes de avisar o visitante.
Um agente monta compras a partir de uma única fonte. Se ele já tiver ativo o recurso Montar compra de uma loja conectada (por exemplo, Jumpseller ou Odoo), desligue-o antes de habilitar a Ação Pagamento, e vice-versa.

Importar itens de um CSV

Se você tem muitos itens, use Importar CSV no catálogo. A primeira linha do arquivo deve ter os cabeçalhos; as colunas são reconhecidas em qualquer ordem: Antes de importar, você vê quantos itens foram detectados e quantas linhas foram omitidas: uma linha sem nome ou sem um valor válido é descartada, nunca se inventa um preço. Os itens importados são somados aos que você já tinha. O catálogo aceita até 50 itens.

Carrinho: vários itens em uma mesma cobrança

O visitante pode montar um carrinho com vários itens do catálogo na mesma conversa: adicionar, alterar quantidades e remover itens, inclusive várias mudanças em uma única mensagem (“adicione um de 60 e tire um de 45”). O agente mostra o carrinho com o total e, quando o visitante confirma explicitamente que quer pagar, gera um único link de pagamento pelo total.
  • Os preços sempre vêm do catálogo da Ação e são revalidados a cada turno. Se um preço mudou, o agente pede novamente a confirmação do novo total.
  • Um carrinho nunca mistura moedas.
  • Se, na mesma mensagem em que pede para pagar, o visitante alterar o carrinho, o agente não gera o link: primeiro pede que ele confirme o novo total.
  • Quando o pagamento é confirmado, o carrinho é fechado. Se o visitante pedir de novo o link do mesmo carrinho, o agente reutiliza o que continua válido.
  • No Playground, nunca é criado um link de pagamento real.
Cada mudança do carrinho e do pagamento fica registrada na conversa como uma nota interna, que só a sua equipe vê.

Como o visitante vê, de acordo com o canal

  • Widget web: o carrinho aparece como um cartão Seu carrinho com cada linha (quantidade × item e subtotal), o Total e um botão Pagar com o valor, que abre a página de pagamento. Se o carrinho mudar, só o cartão mais recente mantém o botão.
  • Telegram e WhatsApp: o link de pagamento chega como um botão Pagar abaixo da mensagem, em vez da URL colada no fim do texto. Se o envio com botão falhar, o agente manda a mesma mensagem com o link no texto.
  • Demais canais: o link vai no texto da mensagem.

Depois do pagamento

  • Conversa resolvida: se uma conversa com um pagamento confirmado for encerrada por inatividade e o visitante não tiver voltado a escrever depois de pagar, ela passa para Resolvida. A mudança é aplicada uma vez por dia, então ela pode aparecer como encerrada durante algumas horas.
  • Onde ver os pagamentos: em Detalhes da conversa aparece a seção Pagamentos (só se a conversa tiver pagamentos confirmados). Em Leads, você tem a coluna Pagamento, o filtro Com pagamento e a seção Pagamentos no painel de cada lead. Veja Conversas e Leads.

Desconectar

Em Agentes → [seu agente] → Integrações → [provedor], clique em Desconectar (também está no menu ··· da linha). A Ação Pagamento que usa essa conexão é desabilitada, mas mantém a sua configuração, e o catálogo de itens não é apagado. A chave é apagada do ChatNorris. Para voltar a cobrar, conecte o provedor novamente e reative a Ação. Se você só quiser interromper as cobranças por um tempo, desligue a chave Ativa da integração: as credenciais são mantidas, e a Ação não pode gerar links até que você a reative. Excluir a Ação Pagamento não apaga a conexão nem o histórico de cobranças já realizadas.

Perguntas frequentes

Não. As cobranças são processadas na sua própria conta do SumUp, Mercado Pago, Flow ou Wompi. O ChatNorris não recebe o dinheiro nem vê dados de cartão: ele só gera o link de pagamento e fica sabendo da confirmação.
Sim. Você pode conectar mais de um em Integrações; o campo Gateway de pagamento da Ação decide com qual o link é gerado. Cada provedor aceita uma única conexão por agente.
Verifique os itens habilitados do catálogo: com Flow, eles precisam estar em CLP, com valores inteiros e de pelo menos 350 CLP; com Wompi, em COP, com valores inteiros e de pelo menos 1.500 COP. Corrija ou desabilite os que não cumprirem essas regras.
Verifique se você colou a URL de eventos da conexão em Wompi → Desarrolladores → URL de Eventos, no mesmo ambiente das suas chaves. Sem ela, o pagamento não é confirmado se o visitante fechar a aba do pagamento.
No Playground, nunca é criado um link de pagamento real. Com Flow e Wompi, você também pode conectar chaves de sandbox: a conexão mostra a etiqueta Sandbox e os pagamentos são de teste.
Não. Conectar e testar a integração não tem custo em créditos. Veja Modelos de IA e créditos.