Flujo principal: PracticeHub a QuiroHiro
QuiroHiro sincroniza los datos de pacientes de PracticeHub como contactos en QuiroHiro CRM, incluyendo campos personalizados y tags.Polling automatico
Cada 30 segundos, el sistema consulta PracticeHub buscando pacientes modificados desde la ultima sincronizacion.
Buscar contacto
Para cada paciente, busca si ya existe un contacto equivalente en QuiroHiro (por ID, email, telefono o nombre).
Crear o actualizar
Si no existe, crea un nuevo contacto. Si ya existe, actualiza sus datos con los 103 campos (13 nativos + 90 personalizados).
Si tienes varias clinicas, el sistema procesa hasta 5 clinicas en paralelo para maximizar la velocidad sin saturar las APIs.
Datos que se sincronizan
| Categoria | Campos | Fuente |
|---|---|---|
| Datos de contacto | Nombre, email, telefono, direccion | Paciente PH |
| Citas | Primera, ultima, proxima cita, conteos por estado | PH appointments sweep |
| Planes de cuidado | Nombre, visitas, frecuencia, duracion | PH care plans |
| Paquetes | Nombre, tipo, visitas restantes, balance, precio | PH patient packages |
| Datos clinicos | Ocupacion, balance, fuente de referencia, estado | PH patient data |
| Tags | Etiquetas del paciente | Algolia / PH logs |
Proteccion anti-duplicados
El mayor reto al sincronizar contactos es evitar duplicados. QuiroHiro resuelve esto con un sistema de busqueda en cascada:| Prioridad | Estrategia | Descripcion |
|---|---|---|
| 1 | ID conocido | Si ya lo vinculamos antes, acceso directo |
| 2 | Campo QHPH | Busca por el custom field qhph_patient_id |
| 3 | Busqueda por email exacto | |
| 4 | Telefono | Busqueda por telefono (requiere coincidencia de nombre) |
| 5 | Nombre | Busqueda fuzzy como ultimo recurso |
| 6 | Crear nuevo | Solo si ninguna estrategia encontro coincidencia |
Latencia de la sincronizacion
| Operacion | Metodo | Latencia tipica |
|---|---|---|
| Sincronizacion de pacientes | Polling | 10 - 30 segundos |
| Importacion masiva de pacientes | Bulk sync | ~5 pacientes/segundo |
Tareas automaticas en segundo plano
Ademas del polling, QuiroHiro ejecuta varias tareas de mantenimiento:| Tarea | Frecuencia | Descripcion |
|---|---|---|
| Polling de pacientes | Cada 30 segundos | Sincroniza pacientes nuevos y modificados |
| Deteccion de eliminaciones | Cada 5 minutos | Detecta pacientes eliminados en PracticeHub |
| Renovacion de tokens | Cada 30 minutos | Renueva los tokens OAuth de QuiroHiro antes de que expiren |
| Reconciliacion | Cada 6 horas | Verifica la consistencia de todos los datos y repara discrepancias |
| Recordatorios de citas | Diaria (08:00 UTC) | Inscribe contactos con cita manana en el workflow de recordatorio |
| Avance de citas | Diaria (01:00 UTC) | Actualiza el campo de proxima cita cuando la actual ya paso |
| Limpieza de logs | Diaria (03:00 UTC) | Elimina registros antiguos |
Todas estas tareas son automaticas y no requieren intervencion.
Que necesitas para empezar
Siguiente: requisitos previos