Ir al contenido

Fuentes de datos

Resumen

El área de Fuentes de datos es el plano de control para las integraciones entrantes. Una fuente puede ser:

  • una fuente de CRM, como Bitrix24
  • una fuente de telefonía directa, como Streamtelecom
  • la API pública (desde Starter) — sin conexión a ningún proveedor: envías tú mismo los datos de llamadas y chats mediante una clave de API

La gestión de Fuentes de datos se encuentra en Configuración -> Fuente de datos.

Pestañas

La sección actualmente utiliza dos pestañas:

Conexión

Usa esta pestaña para:

  • ver la fuente conectada actualmente
  • revisar los metadatos de la conexión, como proveedor/dominio/fecha de instalación
  • cambiar la fuente
  • desconectar la fuente

Cambiar o desconectar una fuente usa cuadros de diálogo de confirmación porque afecta el comportamiento de ingesta.

Desconectar una aplicación de CRM (Bitrix24, Uspacy) detiene la ingesta y cancela la suscripción del portal a los eventos de llamadas que enviaba. La aplicación sigue instalada en tu portal: elimínala allí si también quieres quitarla de la interfaz. Los registros y análisis existentes se conservan.

Los registros que ya habían llegado pero no terminaron de procesarse al desconectar quedan como No aplicable: ya no hay nada con lo que analizarlos, y esto no se considera un fallo.

Una aplicación de CRM desconectada puede volver a activarse desde la misma pestaña: en la pestaña «Conexión» aparece como Desconectado, con un botón Volver a conectar que suscribe de nuevo el portal a los eventos de llamadas. Si mientras tanto la autorización del portal ha caducado, al volver a conectar te indicaremos que hay que instalar la aplicación en el portal otra vez.

El interruptor Comentario sobre el estado de la negociación de una fuente Bitrix24 o Uspacy conectada no está en esta pestaña, sino en Configuración del análisis → Actualización del CRM: activado por defecto, planes Pro y superiores (en Uspacy, que no tiene asignación de campos, el paso aparece solo en esos planes), lo cambian el Propietario y el Administrador. Tras cada conversación analizada de un negocio o lead, Aelo añade al historial del CRM un comentario aparte con el estado del negocio, solo en el CRM activo de la organización (el que recibe los informes de llamadas) y solo con conversaciones de hasta 7 días. El interruptor no depende de los interruptores del comentario y de la nota del informe de llamada. Consulta Negocios.

Importar

Usa esta pestaña para activar una importación inicial o de actualización cuando la fuente lo admite.

Notas:

  • Bitrix24 admite flujos de importación orientados a CRM
  • Streamtelecom y Binotel admiten importación de telefonía directa mediante historial CDR
  • otros proveedores de telefonía pueden exponer ingesta por Webhook antes de exponer un cliente de importación completo

Una importación consume tu saldo por registro, así que es una acción de dos pasos: elige el alcance y el rango de fechas, pulsa Calcular coste y Aelo indica cuántos registros contiene el rango, cuántos minutos facturables son y cuánto se cobrará teniendo en cuenta los minutos incluidos de tu plan y tu monedero. Iniciar se desbloquea solo después de eso, y cambiar el rango exige un nuevo cálculo: el importe que apruebas corresponde siempre al rango que vas a importar. Si la estimación supera tu saldo puedes continuar, pero tendrás que escribir el importe para confirmarlo.

Las importaciones de telefonía por CDR cubren como máximo 30 días por ejecución — es el límite de la API del propio proveedor. Importa un historial más largo en ejecuciones consecutivas.

El mapeo de campos del CRM (entregar los resultados del análisis de vuelta al CRM) ya no es una pestaña de esta sección — se configura por separado, en «Configuración del análisis → Actualización del CRM», y el mapeo de campos solo está disponible para organizaciones con Bitrix24. El paso en sí se muestra a las organizaciones con Bitrix24 y Uspacy: en Uspacy solo contiene el interruptor Comentario sobre el estado de la negociación, y se muestra solo en los planes que incluyen el estado del negocio (Pro y superiores). Los controles de Smart Process son específicos de Bitrix24.

Asistente de fuente

Cuando no hay ninguna fuente activa conectada, Aelo muestra un asistente de fuente de varios pasos:

  1. Seleccionar fuente
  2. Configurar credenciales/ajustes
  3. Probar la conexión
  4. Importar datos iniciales (cuando sea compatible)

La tarjeta «API pública» del paso de selección de fuente es una cuarta vía que se salta por completo los pasos 2-4: te lleva directo a Configuración → Claves API para emitir una clave, en lugar de guiarte por las credenciales de un proveedor. Consulta API pública para la referencia completa. La tarjeta solo aparece cuando tu organización puede acceder a esa sección; en el plan gratuito la sección sigue siendo visible, pero muestra una explicación sobre la necesidad de un plan de pago en lugar del formulario de creación de claves.

Modelo de soporte actual

Bitrix24

  • integración completa con CRM
  • compatibilidad con aplicación embebida
  • ingesta por Webhook
  • configuración de entrega
  • compatibilidad con Smart Process

Unitalk

  • fuente de telefonía directa, PBX en la nube / centro de contacto — beta
  • ingesta por Webhook
  • prueba/configuración a través del flujo de Fuente de datos
  • sin importación masiva de llamadas pasadas: las llamadas llegan por webhook, y Aelo además recoge cada pocos minutos las llamadas nuevas del historial de Unitalk, así que una llamada que el webhook perdió también llega
  • sin escritura de vuelta al CRM

Streamtelecom

  • fuente de telefonía directa
  • ingesta por Webhook
  • prueba/configuración a través del flujo de Fuente de datos
  • importación/backfill desde historial CDR
  • sin escritura de vuelta al CRM

Dos flujos de datos

Streamtelecom ofrece dos flujos independientes:

  1. Historial de llamadas (CDR) — se importa justo después de conectar con usuario, contraseña y clave API. La clave API está en la consola de Stream Telecom: Administración → Perfil de la empresa → API KEY.
  2. Llamadas en tiempo real — llegan mediante un webhook que solo el soporte de Stream Telecom puede activar (no se puede habilitar por cuenta propia). En el paso «Captura de llamadas en tiempo real» del asistente, copia tu webhook URL y envía el correo preparado a support@streamtele.com — esto te suscribe a los eventos de Stream CALL API v3.0. La activación suele tardar hasta 24 horas. El URL contiene un token secreto, así que envíalo solo al soporte de Stream Telecom; puedes volver a obtenerlo en Configuración → Fuentes de datos → Conexión con Mostrar dirección (propietario y administradores).

Binotel

  • fuente de telefonía directa
  • ingesta por Webhook (se aceptan llamadas desde las direcciones de Binotel)
  • importación/backfill desde historial CDR
  • también puede ser la fuente solo de audio para registros que llegan desde Bitrix24
  • sin escritura de vuelta al CRM

Ringostat

  • PBX en la nube, la misma categoría que Streamtelecom y Binotel — no es una herramienta de análisis de llamadas
  • beta: ingesta por Webhook a través del flujo de Fuente de datos — las llamadas llegan una vez configurado el webhook en Ringostat con la cabecera Authorization (cómo configurarlo)
  • el formato del webhook aún no se ha confirmado con datos reales de Ringostat, y la prueba de conexión no consulta a Ringostat: si tras la configuración no aparecen llamadas, contacta con soporte
  • sin importación masiva: no hay importación del historial de llamadas (CDR)
  • sin escritura de vuelta al CRM

Reglas de la fuente activa

  • una fuente de telefonía activa por rol (fuente de registros o fuente solo de audio), no por organización
  • cambiar la fuente activa desactiva la fuente de telefonía anterior
  • el estado de la conexión se lee desde el backend, no se estima localmente por la interfaz

Flujo de trabajo típico

  1. Abre Configuración -> Fuente de datos
  2. Inicia el asistente o abre Cambiar
  3. Selecciona el proveedor
  4. Ingresa las credenciales/configuración específicas del proveedor
  5. Ejecuta la prueba de conexión cuando esté disponible
  6. Inicia la importación inicial si la fuente lo admite
  7. Para fuentes de CRM, configura el mapeo de campos en Configuración del análisis → Actualización del CRM

Notas sobre la actualización del CRM

Para fuentes compatibles con CRM, el paso «Configuración del análisis → Actualización del CRM» puede incluir:

  • mapeo de campos
  • controles para entregar transcripción/resumen/puntuación
  • acciones de configuración o reparación de Smart Process cuando corresponda

Para fuentes de solo telefonía, Aelo trata la integración como solo ingesta, y el paso de Actualización del CRM no está disponible.

Solución de problemas

El asistente se abre aunque hay una fuente conectada

Esto generalmente significa que la interfaz no pudo resolver la consulta de la fuente activa. Verifica la conectividad de la API y vuelve a abrir la sección de Fuente de datos.

El paso Actualización del CRM no está disponible

Eso es lo esperado para fuentes de telefonía directa — el paso «Configuración del análisis → Actualización del CRM» existe solo para organizaciones con Bitrix24 y Uspacy. En Uspacy, además, solo se muestra en los planes que incluyen el estado del negocio (Pro y superiores); en un plan inferior, que falte el paso es lo esperado.

Faltan los controles de Smart Process

Smart Process es específico de Bitrix24. Si el proveedor activo no es Bitrix24, esos controles están ocultos intencionalmente.