So che il titolo è complicato e poco chiarificatore… Cal.com ci permette di montare uno strumento favoloso nella nostra infrastruttura per quando vogliamo rendere disponibile il nostro calendario. Un sito web in cui i nostri clienti possono accedere e selezionare una disponibilità senza le vertigini delle e-mail, come ad esempio quando stai andando bene?

Cómo dice su eslogan “Concéntrese en reunirse, no en hacer reuniones“, más claro el agua 🙂 Así que en este documento veremos cómo en un momentito montamos nuestro servidor de Cal.com. Tiene muchas cosas interesantes, se sincroniza con cualquier tipo de calendario para ver disponibilidades y agendar las citas, además permite realizar video conferencias o integrar la herramienta que usemos en la organización, como sea el Jitsi, Discordia, Element, Google meet, Zoom, Squadre…

Desplegando el contenedor de Cal.com

Comenzamos en una máquina con un linux y Docker instalado, nos descargaremos los contenedores que necesite Cal.com, retocaremos el fichero de configuración y listo!

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: (io) 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=ri*******@co****.esotto
EMAIL_SERVER_HOST=mail.correo.eso
EMAIL_SERVER_PORT=465
EMAIL_SERVER_USER=NOI*****@co****.esotto
EMAIL_SERVER_PASSWORD=CONTRASEÑA
...

Scarichiamo e avviamo i container con:

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, “Passaggio successivo”,

Nos muestra todas las aplicaciones que se integran con Cal.com, la verdad que el listado es increible, “Finire”,

Al termine della procedura guidata, 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.

Il processo è semplice, escribimos la URL que queremos generar, para la web de reserva de citas, el nombre y la zona horaria local. “Passaggio successivo”,

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, Prospettiva, Zoho, Apple…

Pegamos la URL con la dirección CalDAV y los credenciales si los tuviera, “Salvare”,

En mi caso dispongo de 3 Calendari, unicamente marcamos el que nos interesa. A partir de ahora, quien quiera reservarme una cita, podrá ver la disponibilidad de ese calendario y agendar libremente citas. “Continuare”,

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, “Passaggio successivo”,

E infine, aquí añadiremos nuestra foto y una breve descripción nuestra. “Finire”.

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, riserve, definir disponibilidad, Attrezzatura, integración de aplicaciones…

Probando Cal.com

Bene, 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.

Ed è così facile, una vez elegido cuando, podremos hacerle un pequeño formulario para obtener información como, nombre y apellidos, E-mail, 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, andare.

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 meraviglia, 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… Spero che tu l'abbia trovato interessante.

Come al solito, enviaros un abrazo a los que os portáis bien y sé que soy un pesado pero, ¡cuidaros mucho!