Glossary
Términos clave usados en Fynex. Las definiciones son consistentes con el producto y la documentación.
Conceptos centrales
| Término | Definición |
|---|---|
| Agente de IA | Agente conversacional que contacta deudores por WhatsApp, voz, email o SMS, sigue las reglas de la estrategia, registra interacciones y promesas, y escala cuando se cumplen los criterios. |
Accounts & Contacts
| Term | Definition |
|---|---|
| Account | Un registro de deuda en tu portfolio. Contiene el monto adeudado, fecha de vencimiento, estado y contacto asociado. |
| Contact | La persona asociada a una cuenta — nombre, email, teléfono, número de WhatsApp. |
| Reference | Tu identificador interno de la cuenta (número de factura, case ID, etc.). |
| Portfolio | La colección de todas las cuentas en tu organización. |
Statuses
| Status | Applies to | Meaning |
|---|---|---|
| New | Account | Recién importada, aún no contactada. |
| Pending Contact | Account | Programada para primer outreach. |
| Auto Management | Account | Gestionada por agentes de IA. |
| Active Conversation | Account | El agente está en medio de una conversación con el deudor. |
| Promise Active | Account / Promise | El deudor se comprometió a pagar, dentro de la fecha de vencimiento. |
| Promise Overdue | Account / Promise | Promesa de pago vencida. |
| Paid | Account | Deuda resuelta. |
| Escalated | Account | Requiere intervención humana. |
| Paused | Account | Temporalmente excluida de contactos automatizados. |
Strategy & Campaigns
| Term | Definition |
|---|---|
| Strategy | Un conjunto de reglas que definen cómo los agentes contactan a los deudores: canales, secuencia, frecuencia, criterios de escalación. |
| Action Sequence | La lista ordenada de pasos de contacto en una estrategia (ej. email día 1, SMS día 3, llamada día 7). |
| Campaign | Agrupación operativa de cuentas bajo una estrategia y período de tiempo. El motor de ejecución respeta el estado de la campaña (draft/active/paused/completed) y el rango de fechas. Las campañas activas se pueden encolar manual o automáticamente. |
| Escalation | Cuando una cuenta pasa a la cola humana porque se cumplen criterios (máximo de intentos, días sin respuesta) o el agente lo solicita. |
| Escalation Criteria | Condiciones que disparan revisión humana: máximo de intentos alcanzado o días sin respuesta. |
Channels
| Term | Definition |
|---|---|
| Channel | Un método de comunicación: email, SMS, WhatsApp o voz. |
| Modo de apertura de voz | En llamadas con IA, si habla primero el contacto (el agente espera el descuelgue y sigue el guion del prompt) o habla primero el agente (saludo inmediato por TTS). Se resuelve según la elección en la llamada manual → estrategia y paso → default del canal Voice en la organización → default del producto. |
| Credential Mode | Si se usan las credenciales de Fynex ("platform") o las propias ("self-managed") para un proveedor. |
| Dispatch | El acto de enviar un mensaje o iniciar una llamada a un deudor. |
| Template | Mensaje predefinido con placeholders de variables, usado por los agentes al contactar deudores. |
Interactions & Promises
| Term | Definition |
|---|---|
| Interaction | Un evento de contacto (mensaje enviado, llamada hecha) con su canal, resultado y timestamp. |
| Promise | Compromiso del deudor de pagar un monto específico para una fecha específica. |
| Modality | Si la promesa cubre la deuda total o un monto parcial. |
| Opt-out | Cuando el deudor solicita no ser contactado. Todo dispatch futuro a ese contacto se bloquea. |
| Disposición (Disposition) | Clasificación detallada del resultado de una llamada de voz (ej. promesa de pago, callback agendado, rechazo, número equivocado). |
| Resultado de contacto | Si se contactó a la persona correcta en una llamada (conectado, sin respuesta, buzón de voz, número equivocado, desconectado, etc.). |
| Callback | Llamada de retorno agendada a pedido del deudor. El paso de estrategia queda pausado hasta que se ejecute. |
| Preferencia de canal | El canal de comunicación preferido del deudor, capturado durante llamadas y usado para dirigir futuros contactos. |
| Rotación de teléfonos | Selección automática del mejor número telefónico para una llamada, considerando resultados previos (números equivocados, desconectados) y alternativos. |
Ejecución y Pagos
| Término | Definición |
|---|---|
| Cola de Ejecución | La cola de trabajo donde el motor coloca las acciones de despacho pendientes. Los items progresan: pending → processing → completed/failed/skipped. |
| Pago | Una transferencia de dinero registrada de un deudor. Reduce automáticamente el saldo de la cuenta y puede cumplir una promesa. |
| Disputa | Una objeción formal planteada por un deudor. Mientras está abierta, se rastrea con estado, razón y notas de resolución. |
| Notificación | Una alerta dentro de la app para eventos importantes: promesas vencidas, escalaciones, errores de canal, fallos de lote. |
Integración y API
| Término | Definición |
|---|---|
| API Key | Un token secreto usado para autenticación máquina a máquina con la API REST de Fynex. Se crea en Settings > Integrations. |
| Webhook | Un callback HTTP que Fynex envía a tu servidor cuando ocurren eventos específicos (ej. cuenta creada, promesa incumplida). |
| External ID | Un identificador único de tu sistema de origen, almacenado en cuentas y contactos para habilitar el mapeo entre sistemas. |
| Source System | Una etiqueta que identifica de qué sistema externo se importó una cuenta o contacto (ej. "core_banking", "crm"). |
| Scope | Un nivel de permisos asignado a una API key, controlando qué recursos puede leer o escribir. |
| Upsert | Operación crear-o-actualizar: si existe un registro con el mismo external_id, lo actualiza; sino crea uno nuevo. |
| Firma HMAC | Un hash criptográfico usado para verificar que los payloads de webhooks fueron enviados por Fynex y no fueron alterados. |
| Import Job | Una operación asíncrona que procesa un lote de cuentas vía la API, rastreando progreso y errores. |
Idioma
| Término | Definición |
|---|---|
| Locale | Una variante regional del idioma (ej. es-AR, pt-BR, en-US). Determina dialecto, reglas de cumplimiento, voz y plantillas del contenido saliente. |
| Cascada de idioma | El orden de prioridad que Fynex usa para elegir el idioma de cualquier interacción saliente: override manual → idioma del contacto → locale de la organización → default por país → es. |
| Idiomas soportados | Español (es — Argentina, México, Colombia), portugués (pt — Brasil) e inglés (en — EE.UU.). Configurá el locale de la organización en Settings; el idioma por contacto en la carga del Portfolio. |
Compliance
| Term | Definition |
|---|---|
| Frequency Limits | Máximo de contactos por día y por semana, configurado en Settings. |
| Allowed Hours | La ventana horaria diaria durante la cual se permiten contactos. |
| Audit Log | Registro inmutable de todos los eventos del sistema, acciones y cambios de configuración. |
| Dispatch Validation | Verificaciones pre-envío (opt-out, frecuencia, horarios, estado paused) que deben pasar antes de cualquier contacto. |