Disponibilitat de calendaris open source amb Cal.com
Es que el títol és complicat i poc aclaridor… Cal.com ens permet muntar en la nostra infraestructura una eina fabulosa per quan volem donar disponibilitat del nostre calendari. Una web on els nostres clients puguin accedir i seleccionar una disponibilitat sense el mareig de correus tipus quan et va bé?
Com diu el seu eslògan “Concèntre's a reunir-se, no a fer reunions“, més clar l'aigua 🙂 Així que en aquest document veurem com en un momentet muntem el nostre servidor de Cal.com. Té moltes coses interessants, se sincronitza amb qualsevol tipus de calendari per veure disponibilitats i agendar les cites, a més permet realitzar videotrucades o integrar l'eina que usem en l'organització, com sigui el Jitsi, Discord, Element, Google meet, Zoom, Teams…
Desplegant el contenidor de Cal.com
Comencem en una màquina amb un linux i Docker instal·lat, ens descarregarem els contenidors que necessiti Cal.com, retocarem el fitxer de configuració i llest!
mkdir calcom cd calcom git clone https://github.com/calcom/docker.git cd docker cp .env.example .env
Editamos el fichero .env al menos con la siguiente información: (i) si tenemos un FQDN público para usarlo y lo vamos a proteger con un proxy inverso, (ii) el secreto y las claves de autenticación las generamos cómo nos indica y (iii) las notificaciones de correo para recibir las citas:
... NEXT_PUBLIC_WEBAPP_URL=https://FQDN_PUBLICO ... # Use `openssl rand -base64 32` to generate a key NEXTAUTH_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ... # Encryption key that will be used to encrypt CalDAV credentials, choose a random string, for example with `dd if=/dev/urandom bs=1K count=1 | md5sum` CALENDSO_ENCRYPTION_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ... EMAIL_FROM=re*******@co****.eso EMAIL_SERVER_HOST=mail.correo.eso EMAIL_SERVER_PORT=465 EMAIL_SERVER_USER=ens*****@co****.eso EMAIL_SERVER_PASSWORD=CONTRASEÑA ...
Descarreguem i arrenquem els contenidors amb:
docker compose pull
docker compose up -d
Configurando Cal.com
Si no hemos tocado nada, por defecto en el docker-compose.yml publicaremos Cal.com por el puerto 3000 del Docker, así que abrimos un navegador a http://DIRECCION_IP_DOCKER:3000 y damos de alta nuestro primer usuario, el que será el administrador. Introducimos nuestros datos, “Siguiente paso”,
Seleccionamos el modo de licenciamiento, podremos usar la versión open source o adquirir algún plan de suscripción personalizado para empresas, “Next Step”,
Nos muestra todas las aplicaciones que se integran con Cal.com, la verdad que el listado es increible, “Finish”,
Un cop finalitzat l' assistent, ahora sí nos pide crear una cuenta para usar como un usuario más. El registro de usuarios por defecto está permitido y se podrían denegar una vez tengamos todos los usuarios dados de alta.
El proceso es sencillo, escribimos la URL que queremos generar, para la web de reserva de citas, el nombre y la zona horaria local. “Next Step”,
Como paso 2 nos indica que debemos asociar al menos un calendario para hacer las reservas, ver disponibilidades… En mi caso usaré un standard, un CalDav de Radicale.
Como veis se integra con un montón de calendarios, tipo Google Calendar, calendarios Exchange, Outlook, Zoho, Apple…
Pegamos la URL con la dirección CalDAV y los credenciales si los tuviera, “Guardar”,
En mi caso dispongo de 3 calendaris, unicamente marcamos el que nos interesa. A partir d'ara, quien quiera reservarme una cita, podrá ver la disponibilidad de ese calendario y agendar libremente citas. “Continue”,
Podremos conectarlo con la solución que nos interese para realizar las video llamadas, en mi caso elegiré Jitsi Video.
Como paso 4 nos pide la disponibilidad, qué días y en qué horario se pueden coger reservas, “Next Step”,
I finalment, aquí añadiremos nuestra foto y una breve descripción nuestra. “Finish”.
Una vez acaba el asistente nos llevará a la web de gestión, muy simplona, donde deberemos habilitar 2FA, podremos crear distintos tipos de eventos, reserves, definir disponibilidad, equips, integración de aplicaciones…
Probando Cal.com
Bo, pues una vez hayamos configurado básicamente nuestro Cal.com, ya podremos compartir la URL de nuestro perfil, quien acceda a él verá las opciones que le damos para citarnos.
Una vez elija el tipo de evento y su duración, ya podrá ver el calendario donde podrá seleccionar las horas que estén disponibles en nuestro calendario.
I així de fàcil, una vez elegido cuando, podremos hacerle un pequeño formulario para obtener información como, nombre y apellidos, correo electrónico, alguna nota, posibilidad de añadir otras personas, opciones para el evento. Así como si es una llamada telefónica al organizador, al asistente o una video llamada, incluso podemos añadir un campo para que nos peguen la URL de su sistema de videoconferencia, si es que lo prefieren, vagi.
Y este sería el resumen de la cita, por supuesto llegará por mail y podrán reprogramar o cancelar la cita en todo momento.
Y por supuesto se añadirá la cita al calendario automáticamente!!
Una maravilla, una herramienta muy sencilla a la par de potente, donde nos da esa libertad a la hora de organizar reuniones, evitar pérdidas de tiempo con correos para arriba, para abajo… Espero us hagi resultat interessant.
Com sempre, enviaros un abrazo a los que os portáis bien y sé que soy un pesado pero, ¡cuidar-vos molt!
