Integraciones

Las integraciones conectan tu clínica con servicios externos. Cada una se activa o desactiva por clínica y guarda sus credenciales sensibles cifradas (no se vuelven a mostrar una vez guardadas). Es una sección de administrador.

Pantalla de Integraciones de la clínica.

En una frase, qué hace cada una:

WhatsApp (Evolution) — envía las confirmaciones automáticas de citas y conecta la bandeja de Mensajes al número de la clínica.
Amazon SES (correo) — envía los correos del sistema: recordatorios de cita, invitaciones de cuenta y avisos.
IA (Anthropic) — habilita las funciones de inteligencia artificial: Resumen IA, Escriba, Captura de cobros y el chat de ayuda del personal.
Tipo de cambio (Banxico) — trae el dólar oficial para cobrar en USD en el POS.
Stripe y Mercado Pago — cobran en línea con tarjeta (y OXXO/transferencia, en el caso de Mercado Pago).
WhatsApp Business — la conexión con la API oficial de Meta (alternativa a Evolution).
Otra integración — para conectar cualquier API externa por clave.

Cómo llegar

Menú lateral → Configuraciones → tarjeta Integraciones → Ver integraciones.

Verás una tabla con cada proveedor disponible y, por cada uno, su Estado (No configurada / Configurada / Activa / Pausada / Error), si está Activo, si las Credenciales están Guardadas o Pendientes, y la fecha de Actualizado. A la derecha tienes dos accesos: Asistente de configuración y Configuración avanzada.

Las dos formas de configurar

Cada integración se puede configurar de dos maneras y ambas guardan en el mismo lugar:

Asistente de configuración (recomendado): un flujo guiado de cuatro pasos.
Configuración avanzada: una sola pantalla con todo (interruptor, estado actual, último error y los campos), útil para ajustes puntuales o para activar y desactivar sin volver a pasar por el asistente.

El asistente paso a paso

Introducción — te muestra los beneficios, los requisitos y el tiempo estimado. Pulsa Comenzar.
Instrucciones — los pasos del lado del proveedor, con enlaces directos a sus consolas.
Credenciales — capturas la configuración y las claves; los valores sensibles se cifran al guardar. Pulsa Guardar y continuar.
Activar — el paso final depende del proveedor: vincular el número por QR, probar la conexión, o una confirmación de “listo”.

Confirmaciones de citas (WhatsApp)

Envía un recordatorio automático antes de cada cita y el cliente confirma, cancela o reagenda respondiendo por WhatsApp (típicamente 1, 2 o 3); la agenda se actualiza sola. El estado de confirmación se ve en la Agenda y en el Dashboard.

Capturas la URL e instancia de Evolution, las horas de los recordatorios y los textos del mensaje. La credencial cifrada es la Evolution API Key. Para que opere, además de capturar lo anterior, activa la integración y vincula la instancia a un número de WhatsApp.

Esta misma conexión hace mucho más que confirmar citas:

QR de vinculación — conectas (o reconectas) el número escaneando un código QR desde la propia pantalla. El botón Re-vincular (QR) lo genera cuando cambias de teléfono o se cae la sesión.
Doble recordatorio — puedes definir dos avisos antes de la cita (por defecto 24 h y 3 h antes). Deja el segundo vacío si prefieres uno solo.
Mensaje posterior de seguimiento — un mensaje automático que sale un tiempo después de la cita (por ejemplo, 24 h después) para preguntar cómo sigue la mascota.
Modo de respuesta — eliges entre una encuesta tocable o solo texto 1/2/3; el texto 1/2/3 siempre se incluye como respaldo.
Envío de recibos y cotizaciones — desde ventas, cotizaciones y facturas puedes mandar el PDF al cliente por este mismo WhatsApp.
OTP de la app del cliente — cuando el tutor entra a la app del cliente, su código de acceso puede llegarle por WhatsApp usando esta conexión.

Webhook entrante

Para recibir las respuestas del cliente, Evolution necesita saber a dónde entregarlas. PixelVet registra ese webhook automáticamente al guardar la integración: no tienes que copiar ni pegar ningún token. La tarjeta Webhook entrante te muestra la URL pública (de solo lectura, con un botón Copiar) y un chip que indica si está Registrado. El botón Registrar / reparar webhook sirve para volver a registrarlo si cambiaste de servidor o el número se reconectó.

Esta misma conexión alimenta la bandeja de Mensajes: mientras no esté activa, lo que el personal envíe desde ahí queda marcado como simulado (no sale de verdad).

IA (Anthropic)

Una sola API Key de Anthropic habilita todas las funciones de inteligencia artificial del sistema:

Resumen IA — el botón de la ficha de mascota que resume el expediente.
Escriba — el botón Dictar consulta del expediente, que convierte tu dictado por voz en un borrador de la consulta.
Captura de cobros — el botón Sugerir cobros desde una consulta, que propone los ítems a cobrar según el SOAP.
Chat de ayuda del personal — responde dudas de uso del sistema.

Guardas tu API Key, eliges el modelo (Opus para máxima calidad, Sonnet equilibrado, Haiku el más rápido y económico) y activas la integración; la pantalla incluye un botón de probar conexión. Sin API key, en pruebas, responde un modo simulado sin costo.

Tipo de cambio (Banxico)

Para cobrar en dólares en el POS, PixelVet consulta el tipo de cambio FIX oficial de Banxico (pesos por dólar). Guardas un token de la API SIE de Banxico (es gratuito) y activas la integración; la pantalla incluye una prueba de conexión que trae el valor y la fecha del último FIX publicado.

La venta siempre se registra en pesos; el tipo de cambio solo traduce el importe cuando cobras en USD, y el sistema rechaza valores que se alejen demasiado del FIX vigente.

Correo (Amazon SES)

Envía correos transaccionales: confirmaciones y recordatorios de cita e invitaciones de cuenta. Capturas la Región, el Correo remitente (debe estar verificado en SES), el Nombre del remitente y un interruptor de Recordatorios de cita por correo (24 h antes), que convive con el de WhatsApp. Como credenciales van el Access Key ID y Secret Access Key.

Pagos: Stripe y Mercado Pago

Stripe: pagos con tarjeta. Eliges el Modo (test para pruebas, live para cobros reales) y capturas Publishable Key, Secret Key y Webhook Secret.
Mercado Pago: tarjeta, OXXO, transferencia y más. Eliges el Modo (sandbox o production) y capturas Public Key, Access Token y Webhook Secret.

Video para teleconsulta (Jitsi)

La videollamada de las teleconsultas usa Jitsi autohospedado por clínica. A diferencia de las integraciones anteriores, no se configura desde este panel: es un servidor que se levanta como parte de tu infraestructura y PixelVet lee su dominio (y, opcional, un secreto de acceso) de la configuración de la clínica.

Mientras no esté configurado, el botón Entrar a la videollamada de una cita de teleconsulta avisará que falta configurar el servidor de video.

Visor de imágenes (PACS / Orthanc)

Para ver estudios de imagen (rayos X, ultrasonido) en un visor DICOM, PixelVet abre un Orthanc + OHIF autohospedado por clínica. Igual que Jitsi, se configura fuera de este panel (es infraestructura propia) y PixelVet solo guarda la referencia del estudio y abre el visor. No interpreta la imagen.

Mientras no esté configurado, el botón Ver en visor DICOM avisará que falta configurar el visor de imágenes.

Google Calendar

Conexiones personalizadas (Otro)

Para conectar cualquier API externa por clave. Capturas la URL base del API y unas Notas internas, y como credencial la API Key.