Status de transações e recebimento de Pix

“Já chegou?” Consulte o status antes de responder.

Conecte sua API de transações somente de leitura para consultar transferências, incluindo Pix quando seu sistema fornecer esses dados. Explique o status, o motivo e a previsão informados pela fonte, sem movimentar valores.

Começar teste grátis

Dados de exemplo · fictícios

Recebimento de Pix

Cliente

A transferência DEMO-TX-028 já chegou?

Ferramenta somente de leitura

get_transfer({ transfer_id: "DEMO-TX-028" }) → status: "em processamento", reason: "aguardando confirmação", expected_by: "próximo dia útil"

Resposta da IA

A transferência está em processamento, aguardando confirmação. O sistema informa previsão para o próximo dia útil; ainda não consta como concluída.

A identidade vem da sessão autenticada e é inserida pelo servidor. Apenas consulta de status, sem alterar transações.

Consulta de transferência vinculada à sessão

Nome da ferramenta: get_transfer
Descrição: Leia o status, o motivo e a previsão de chegada da transferência do cliente autenticado.
URL do endpoint: GET https://api.example.com/transfers/{transfer_id}
Autenticação: Authorization: Bearer {{TRANSFER_API_SECRET}}
Mapeamento de entrada: transfer_id ← input.transfer_id customer_id ← server.session.customer_id
Mapeamento de saída: status ← $.transfer.status reason ← $.transfer.reason expected_by ← $.transfer.expected_by

Configuração de exemplo para sua API de transações somente de leitura. Não representa um conector nativo de pagamentos.

Só transfer_id vem da pergunta. O servidor insere a identidade da sessão autenticada; seu endpoint deve verificar a titularidade da transferência.

Leia o status registrado no seu sistema

Configure get_transfer para consultar o status da transação e a previsão de chegada. Retorne status, reason e expected_by da sua API. Se não houver previsão, informe isso sem inventar um prazo.

Use a identidade da sessão autenticada

O servidor insere a identidade do cliente a partir da sessão, não do que ele escreve no chat. Seu endpoint deve verificar se a transferência pertence àquele cliente antes de retornar dados.

Explique claramente o que ainda está pendente

Use o motivo retornado para explicar o status no idioma do cliente. Apresente a previsão de chegada como uma estimativa da fonte, nunca como confirmação de que o valor já chegou.

Dê contexto à equipe para acompanhar o caso

Se o status exigir investigação, encaminhe a conversa à equipe. As ferramentas só leem o status; não iniciam, cancelam nem revertem transferências.

Dúvidas antes de conectar

Quais dados o assistente pode ler?

Os campos de status, motivo e previsão de chegada expostos pela API somente de leitura que você configurar. Incorporar o Ouviro ao site não dá acesso automático a um sistema de pagamentos.

Alguém pode informar o ID de outro cliente no chat?

Uma mensagem não é uma fonte de identidade. O servidor insere a identidade da sessão autenticada, e sua API deve verificar a autorização para a transferência solicitada.

O assistente pode movimentar valores ou alterar uma transação?

Não. Essas ferramentas só consultam o status da transação e a previsão de chegada. Solicitações que exigem uma ação devem seguir o processo da sua equipe.

E se não houver previsão de chegada?

A resposta deve informar que a fonte não fornece uma previsão. A conversa pode ser encaminhada à equipe para acompanhamento, sem inventar um prazo.

O cliente pergunta. A IA consulta seu sistema.

Conecte sua base de conhecimento e APIs somente de leitura para consultar pedidos, transferências, faturas e planos no idioma do cliente.

Começar teste grátis