Estado de transacciones y transferencias

«¿Ya ha llegado?» Consulta el estado antes de responder.

Conecta tu API de transacciones de solo lectura para que el cliente pregunte por una transferencia en la conversación. Explica el estado, el motivo y la llegada estimada que indique tu sistema.

Empezar prueba gratis

Datos de ejemplo · ficticios

Pagos y tecnología financiera

Cliente

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

Herramienta de solo lectura

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

Respuesta de la 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.

La identidad viene de la sesión autenticada y la incorpora el servidor. Solo se consulta el estado; no se modifican transacciones.

Consulta de transferencias vinculada a la sesión

Nombre de la herramienta: get_transfer
Descripción: Lee el estado, el motivo y la llegada estimada de la transferencia del cliente autenticado.
URL del endpoint: GET https://api.example.com/transfers/{transfer_id}
Autenticación: Authorization: Bearer {{TRANSFER_API_SECRET}}
Mapeo de entrada: transfer_id ← input.transfer_id customer_id ← server.session.customer_id
Mapeo de salida: status ← $.transfer.status reason ← $.transfer.reason expected_by ← $.transfer.expected_by

Configuración de ejemplo para tu API de transacciones de solo lectura. No representa un conector nativo de pagos.

Solo transfer_id viene de la pregunta. El servidor incorpora la identidad de la sesión autenticada; tu endpoint debe verificar a quién pertenece la transferencia.

Lee el estado registrado en tu sistema

Configura get_transfer para consultar el estado de la transacción y su llegada estimada. Devuelve status, reason y expected_by desde tu API. Si no hay estimación, indícalo sin inventar un plazo.

Usa la identidad de la sesión autenticada

El servidor incorpora la identidad del cliente desde la sesión, no desde lo que escribe en el chat. Tu endpoint debe comprobar que la transferencia pertenece a ese cliente antes de devolver datos.

Explica con claridad lo que sigue pendiente

Usa el motivo devuelto para explicar el estado en el idioma del cliente. Presenta la llegada prevista como una estimación de la fuente, nunca como confirmación de que el importe ya ha llegado.

Dale a tu equipo el contexto para el seguimiento

Si el estado requiere investigación, pasa la conversación al equipo. Las herramientas solo leen el estado; no inician, cancelan ni revierten transferencias.

Preguntas antes de conectar

¿Qué datos puede leer el asistente?

Los campos de estado, motivo y llegada estimada que exponga la API de solo lectura que configures. Incorporar Ouviro a tu web no da acceso automático a un sistema de pagos.

¿Alguien puede introducir el ID de otro cliente en el chat?

Un mensaje no es una fuente de identidad. El servidor incorpora la identidad de la sesión autenticada, y tu API debe comprobar la autorización para la transferencia solicitada.

¿Puede el asistente mover dinero o modificar una transacción?

No. Estas herramientas solo consultan el estado de la transacción y su llegada estimada. Las solicitudes que requieren una acción deben seguir el proceso de tu equipo.

¿Qué ocurre si no hay una llegada estimada?

La respuesta debe indicar que la fuente no proporciona una estimación. La conversación puede pasar al equipo para hacer seguimiento sin inventar un plazo.

El cliente pregunta. La IA consulta tu sistema.

Conecta tus conocimientos y API de solo lectura para consultar pedidos, transferencias, facturas y planes en el idioma del cliente.

Empezar prueba gratis