Avisos y conexiones

Su equipo ve todas las citas en el panel. Esta sección es para lo demás: que le llegue un WhatsApp o un correo cuando se agenda una cita, o que su propio sistema se entere sin que nadie tenga que copiar nada.

Se configura en Configuración → Avisos y conexiones.

Qué avisos hay

Puede suscribirse a todos o elegir cuáles. Si elige todos, los avisos que agreguemos en el futuro le llegarán automáticamente.

Por correo

La opción simple, y la que sirve para la mayoría de clínicas.

Cada aviso llega como un correo que se entiende solo: paciente, teléfono, fecha y hora en la zona horaria de su clínica, doctor y procedimiento. No hay que entrar al panel para saber qué pasó.

Dos detalles pensados para una recepción real:

• Los correos de una misma cita se agrupan. La reserva, el cambio de hora y la cancelación quedan en la misma conversación de su bandeja, en vez de ser tres correos sueltos que hay que cruzar a mano.
• Traen un archivo de calendario adjunto (.ics). Al abrirlo, la cita entra en Google Calendar, Outlook o el calendario del teléfono. Si esa cita se reagenda después, el nuevo correo actualiza la entrada existente en vez de duplicarla.

Puede poner varias direcciones: una para recepción, otra para el consultorio. Cada una es un aviso aparte, y cada una elige a qué se suscribe.

Por WhatsApp

Para la clínica que no vive en el correo. Pone un número —el de recepción, el suyo— y le llega un WhatsApp por cada aviso que haya elegido:

Novedad de agenda en Clínica Demo.

Se canceló una cita.

👤 Paciente: María Pérez 📅 Fecha: lunes 12 de octubre, 10:30 👨‍⚕️ Profesional: Dra. Pazmiño 📞 Teléfono: 593991112233

Lo que conviene saber antes de activarlo:

• El número no tiene que ser de un paciente. Es el teléfono de alguien de su equipo. Puede escribirlo como quiera (0991112233, +593 99 111 2233); nosotros lo normalizamos.
• Puede poner varios números, igual que con el correo: cada uno es un aviso aparte y elige a qué se suscribe.
• Si alguien responde a ese mensaje, el bot no le contesta. Sabemos que ese número es de su equipo, no de un paciente, así que no recibe el mensaje de "necesitas estar registrado". Tampoco es un canal para escribirnos: lo que se responda ahí no le llega a nadie.
• El cuestionario de admisión no viaja por WhatsApp. El aviso le dice que un paciente lo completó, pero las respuestas no van en el mensaje: son datos de salud y un WhatsApp termina en un teléfono personal. Las respuestas están en el panel, y en el correo si tiene ese canal activo.
• Necesita su número de WhatsApp ya conectado. Si su clínica todavía no tiene WhatsApp configurado con nosotros, la pantalla no le deja crear el aviso: no tendríamos desde dónde enviarlo.

Hacia su propio sistema (HTTPS)

Si su clínica tiene historia clínica electrónica, un sistema de facturación o cualquier software propio, puede recibir los avisos ahí directamente.

Le enviamos un POST con el contenido en JSON. Dos cosas que su proveedor de software va a querer saber:

• La dirección tiene que ser https://. No aceptamos http://: los avisos llevan el nombre y el teléfono del paciente y no viajan sin cifrar.
• Cada envío va firmado. Generamos un secreto por conexión y mandamos la firma en la cabecera X-Signature (HMAC-SHA256 sobre el cuerpo exacto). Su sistema puede así comprobar que el aviso viene de nosotros y no de un tercero que descubrió la dirección.

Autenticación: las dos direcciones

Son dos cosas distintas y conviene no confundirlas:

Si su endpoint es abierto y solo quiere comprobar el origen, le basta la firma. Es el modelo de GitHub o Stripe: el endpoint no pide credenciales, pero rechaza todo lo que no traiga una firma válida.

Para verificarla necesita el secreto: está en la propia conexión, en Ver secreto de firma, con botones para copiarlo y regenerarlo. Regenerarlo invalida el anterior de inmediato, así que actualícelo en su sistema en el mismo momento.

Si su endpoint exige autenticación —lo habitual en historias clínicas y sistemas de facturación— configure la cabecera de credencial en la misma pantalla: el nombre que su sistema espera (Authorization, X-Api-Key, …) y su valor.

Guardamos el valor cifrado y no volvemos a mostrarlo: puede reemplazarlo o quitarlo, nunca leerlo. Si más adelante ve •••••••• (sin cambios) es que hay una credencial guardada y no la está tocando.

Sin esto, un endpoint que pida autenticación responderá 401 a cada envío y el aviso se dará por perdido tras seis intentos.

Probar antes de confiar

Cada conexión tiene un botón de envío de prueba. Manda un aviso de mentira —con el mismo formato exacto que uno real, pero marcado como ping— y le dice al instante si llegó o qué falló.

Úselo al configurar, y otra vez si su proveedor cambia algo. Es la diferencia entre saber que funciona y suponerlo.

Si un envío falla

Los reintentamos solos: a 1, 2, 4, 8 y 16 minutos. Si después de seis intentos sigue sin entrar, lo damos por perdido.

En Ver envíos recientes están los últimos envíos de cada conexión, con la hora, el resultado y el código que devolvió su sistema. Los fallidos tienen un botón de Reintentar para volver a mandarlos a mano.

Los avisos se borran a las 24 horas, porque llevan datos del paciente y esta no es una segunda copia de su historia clínica. Por eso "envíos recientes" es corto: es un panel de control, no un archivo.

Lo que esto no es

• No reemplaza al panel. Si un aviso no llega, la cita igual está agendada y visible en Pingclínica. Nunca se pierde una cita porque un correo, un WhatsApp o un webhook haya fallado.
• Los avisos por WhatsApp son para su equipo, no para el paciente. Cuando su equipo agenda, mueve o cancela una cita desde el panel, el paciente no recibe un WhatsApp automático: hoy eso se avisa por teléfono como siempre. Los avisos de esta sección van a los números de su clínica.
• No es un canal de ida y vuelta. Si alguien de su equipo responde al aviso, ese mensaje no llega a nadie. Para hablar con un paciente, use el WhatsApp de la clínica como lo hace normalmente.