Programación de reuniones
Integración con Cal.com
Cuando uno de tus contactos reserva una reunión con Cal.com, arteemis la registra en el contacto y mueve su oportunidad a la etapa que elijas. Al entrar en el pipeline se detienen las secuencias del contacto, así que nadie recibe un seguimiento después de reservar. Cal.com se conecta con una clave de API de tu cuenta, en cal.com o en tu propio Cal.com.
Qué hace
Qué hace arteemis con una reserva
- Cada asistente se asocia a un contacto de tu espacio de trabajo por su dirección de email y, si no, por una dirección desde la que ha escrito. No se crea a nadie para una dirección que el espacio de trabajo no conoce.
- La reserva se registra en la actividad del contacto, con el nombre y la hora de la reunión.
- La oportunidad del contacto pasa a la etapa elegida (al principio, la etapa de reunión), nunca hacia atrás ni más allá. Un contacto que no está en el pipeline entra en él en esa etapa, lo que detiene sus secuencias en curso.
- Una reunión reprogramada cuenta como una reserva. Una cancelación se registra y no mueve nada.
Qué configura arteemis en Cal.com
- Un webhook para las reservas creadas, canceladas y reprogramadas, firmado con un secreto propio.
La clave de API se comprueba y luego se cifra: arteemis solo la usa para leer tu cuenta y para crear o eliminar su webhook. Cada llamada de Cal.com se comprueba con el secreto del webhook antes de registrar nada.
Requisitos
- El rol de propietario o administrador de tu espacio de trabajo de arteemis: solo quien tiene ese rol conecta las integraciones.
- Una clave de API de Cal.com, creada en Cal.com en Settings > Developer > API keys (empieza por cal_).
- Un Cal.com autoalojado debe ser accesible por https en una dirección pública.
Configuración
Crear una clave de API
- 1En Cal.com, abre Settings > Developer > API keys, crea una clave y cópiala.
Conectar
- 1Inicia sesión en arteemis y abre Ajustes > Integraciones.
- 2En Reserva de reuniones, elige Conectar en la tarjeta de Cal.com.
- 3Pega la clave en Clave de API. Para un Cal.com autoalojado, indica su dirección en Dirección autoalojada; déjalo vacío para cal.com. Luego elige Conectar.
- 4arteemis comprueba la clave y crea su webhook. La tarjeta indica Conectado a, seguido de tu cuenta de Cal.com.
Elegir la etapa
- 1Elige Configuración en la tarjeta de Cal.com.
- 2En Cuando se reserve una reunión, mover la oportunidad a, mantén la etapa de reunión, elige otra o elige No moverla para solo registrar la reserva. El cambio se guarda al instante.
Datos intercambiados
| Datos | Sentido | Detalles |
|---|---|---|
| Webhook | De arteemis a Cal.com | Se crea al conectar, para las reservas creadas, canceladas y reprogramadas; se elimina al desconectar. |
| Reservas | De Cal.com a arteemis | Direcciones de email de los asistentes, nombre de la reunión, hora de inicio, si se trata de una reprogramación o de una cancelación. |
| Cuenta | De Cal.com a arteemis | Tu usuario de Cal.com, para comprobar la clave y dar nombre a la conexión. |
Desconexión
- En Ajustes > Integraciones, elige Configuración en la tarjeta de Cal.com, luego Desconectar abajo, y confirma.
- arteemis elimina su webhook en Cal.com y luego la conexión, su clave y su configuración. Las reservas ya registradas se quedan en los contactos.
- La clave en sí sigue siendo válida en Cal.com: elimínala allí en Settings > Developer > API keys.
Solución de problemas
- Se rechaza la clave
- Comprueba que has copiado la clave entera, que no se ha eliminado en Cal.com y, en un Cal.com autoalojado, que la dirección es correcta y accesible por https.
- No se ha registrado una reserva
- Ninguna dirección de email de los asistentes es la de uno de tus contactos, ni una dirección desde la que hayan escrito. arteemis no crea a nadie a partir de una reserva.
- Una cancelación no ha hecho retroceder la oportunidad
- Es intencionado: nada en arteemis hace retroceder una oportunidad. La cancelación se registra en el contacto.
Ayuda
romain@arteemis.xyz
¿Una pregunta sobre esta integración, o algo que no funciona como se describe aquí? Escríbenos. Recibes una respuesta en un día laborable como máximo, en francés o en inglés.
Enviar un email