Avisos y conexiones

Su equipo ve todas las citas en el panel. Esta sección es para lo demás: que le llegue 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.

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 o un webhook haya fallado.
• No hay avisos por WhatsApp. WhatsApp solo permite escribirle a alguien dentro de las 24 horas siguientes a su último mensaje, y su equipo no le escribe al bot. Un aviso que funciona a veces es peor que ninguno, así que no lo ofrecemos.