Saltar al contenido

Integración con Cal.com

Conecta Cal.com y tu agente de IA reserva reuniones en el chat

Pega una API key de Cal.com, elige un tipo de evento y tu agente de intoCHAT muestra horas libres reales bajo su respuesta. El visitante elige una, escribe su nombre y su email, y la reserva se crea en Cal.com, que envía su confirmación habitual.

Crea tu agente gratis Ver la documentación

Última actualización:

Cómo funcionan juntos intoCHAT y Cal.com

intoCHAT se comunica con la API de Cal.com (versión 2, en api.cal.com) con una API key de tu cuenta de Cal.com. Con esa clave hace tres cosas y nada más: lista tus tipos de evento para que elijas uno, lee las horas libres de ese tipo de evento y crea una reserva cuando un visitante confirma una hora. Tus reglas de disponibilidad, tus márgenes entre reuniones y tus calendarios conectados siguen en Cal.com, que es de donde salen las horas libres. El modelo de IA nunca se inventa una hora. El agente decide cuándo mostrar el selector de horas, guiado por un texto breve que escribes tú: When to offer booking. Cuando la conversación encaja, por ejemplo si un visitante pide una demo o quiere saber cuándo hay alguien disponible, muestra las horas libres bajo su respuesta. No enumera las horas en su texto ni pide el nombre o el email en el chat: el visitante los escribe en el selector. Justo antes de reservar, intoCHAT vuelve a preguntar a Cal.com si la hora sigue libre. Si otra persona la ha cogido mientras tanto, se pide al visitante que elija otra y nada se reserva dos veces. Si tu tipo de evento exige que confirmes las reservas, la confirmación en el chat empieza por «Solicitado:» en lugar de «Reservado:» y dice que la reunión aún debe confirmarse. Esta página trata de la conexión con Cal.com en sí: configuración, qué se sincroniza y los límites. Para ver cómo se ve la reserva en el chat para los visitantes y cómo usarla en conversaciones de ventas y soporte, consulta la página de la funcionalidad de reserva de citas.

Conecta Cal.com a tu agente de intoCHAT

  1. Crea una API key en Cal.com

    En Cal.com, abre Settings, Developer, API keys y crea una clave. Empieza por cal_. También necesitas al menos un tipo de evento, como una llamada de presentación de 30 minutos.

  2. Abre la tarjeta Booking

    En intoCHAT, abre tu agente y ve a la pestaña Actions. La tarjeta Booking está debajo de tus acciones y formularios. En Calendar, elige Cal.com.

  3. Pega la clave y haz clic en Connect

    Pégala en el campo Cal.com API key. intoCHAT comprueba la clave cargando tus tipos de evento, la guarda cifrada y a partir de ahí solo muestra cal_… y sus cuatro últimos caracteres.

  4. Elige el tipo de evento que reservan los visitantes

    Cada tipo de evento muestra su título y su duración. Uno marcado «(hidden in Cal.com)» está oculto en tu página pública de reservas, pero los visitantes pueden reservarlo igualmente desde el chat.

  5. Indica cuándo ofrecer la reserva y guarda

    Si quieres, rellena When to offer booking, hasta 1.000 caracteres: lo lee el agente y los visitantes nunca lo ven. Haz clic en Save: la reserva queda activa en cuanto guardas.

  6. Reserva una reunión de prueba

    Pide una reunión en el Playground y reserva una hora. Las reservas del Playground son reales: crean la reunión en Cal.com y disparan sus emails, así que cancela después las reservas de prueba en Cal.com.

When to offer booking, si dejas el campo vacío

When the visitor wants to book a meeting, call, demo or appointment, or asks when the team is available.

El campo muestra este texto predeterminado en inglés. Escribe el tuyo para acotarlo, por ejemplo solo después de que el visitante haya dicho qué producto le interesa.

Qué se sincroniza entre intoCHAT y Cal.com

  • Horas libres leídas en directo

    Las horas llegan de Cal.com cada vez que se abre el selector: hasta 5 días con horas libres y hasta 8 horas por día, 7 días por delante de forma predeterminada, o los días que pida el visitante, hasta un año por delante.

  • Reservas creadas en Cal.com

    Una hora confirmada se convierte en una reserva de Cal.com con el nombre, el email y la zona horaria del visitante. Cal.com envía sus emails e invitaciones de calendario habituales; intoCHAT no envía ningún email propio.

  • La zona horaria del visitante

    Las horas se muestran en la zona horaria del navegador del visitante, por ejemplo «Horas en Europe/Berlin», y escritas como su navegador escribe fechas y horas.

  • Una lista de reservas en intoCHAT

    La tarjeta Bookings de la pestaña Leads lista cada reunión reservada desde el chat, con el nombre, el email y la zona horaria del visitante y un enlace a la conversación.

  • Webhook y aviso en Slack

    Suscribe un webhook a Meeting booked para recibir booking.created con provider calcom y el ID de la reserva en Cal.com, o marca Booked meeting en Slack alerts.

  • Una clave solo para reservar

    La clave se guarda cifrada y no se vuelve a mostrar. intoCHAT la usa para leer tipos de evento y horas libres y para crear reservas, nada más en Cal.com.

Preguntas frecuentes

¿Qué plan de intoCHAT necesito para Cal.com?

Cualquiera, incluido Free: la reserva con Cal.com no depende de un plan de pago de intoCHAT. Reservar una hora no consume mensajes; la respuesta que muestra las horas cuenta como cualquier otra respuesta. Los procedimientos, desde Starter, también pueden indicar al agente que ofrezca la reserva tras unas preguntas de cualificación.

¿Una cancelación en Cal.com aparece en intoCHAT?

No. No hay sincronización de vuelta desde Cal.com. Si una reunión se cambia de hora o se cancela allí, la lista de reservas y la conversación siguen mostrando la reserva original, y no se envía ningún webhook. Los visitantes cancelan o cambian la hora mediante los emails de Cal.com, no en el chat.

¿Puedo conectar una instancia de Cal.com autoalojada?

Por ahora no. intoCHAT se conecta a la API alojada de Cal.com en api.cal.com, así que la API key tiene que venir de una cuenta allí.

¿Un agente puede ofrecer varios tipos de evento?

No. Cada agente reserva un tipo de evento de un calendario a la vez. Usa Change event type en la tarjeta Booking para cambiarlo. Para ofrecer una demo comercial y una llamada de soporte, crea dos agentes, cada uno con su propio tipo de evento.

¿Y si Cal.com rechaza mi clave?

La tarjeta dice «Cal.com didn't accept this API key.» Comprueba que has copiado la clave entera y que no ha caducado ni se ha eliminado en Cal.com. Si tu cuenta aún no tiene tipos de evento, crea uno y vuelve a hacer clic en Connect. Puedes comprobar claves hasta 10 veces en 10 minutos.

¿Qué pasa si alguien acaba de coger esa hora?

intoCHAT vuelve a preguntar a Cal.com justo antes de reservar. Si la hora ya no está libre, el visitante ve «Esa hora se acaba de reservar. Elija otra, por favor.» y esa hora desaparece de la lista.

¿Una reserva también se guarda como lead?

No. Una reserva tiene su propia lista, su propio webhook (booking.created) y su propio aviso en Slack. El nombre y el email del selector no crean un lead ni envían un aviso de lead, y las reservas no se cuentan en Outcomes en el panel.

¿Cómo pauso la reserva sin perder la configuración?

Usa el interruptor On / Off de la cabecera de la tarjeta Booking. Disconnect detiene la reserva y elimina la clave guardada; las reuniones ya reservadas siguen en Cal.com y en la lista de reservas. Un agente duplicado no copia la conexión con Cal.com, así que vuelve a conectarla en la copia.

Míralo responder con tu propia web

Pega la dirección de tu web y chatea con un agente creado a partir de tus páginas. Tarda alrededor de un minuto.

Crea tu agente gratis

Plan gratuito, sin tarjeta de crédito.