Saltar al contenido principal
El step Google Calendar conecta tus agentes directamente con Google Calendar, permitiéndoles listar eventos de un período o crear nuevos eventos automáticamente. Con él, Tess ejecuta acciones reales en tu agenda sin necesidad de intervención manual.

​
¿Qué es este Step?

Esta integración ofrece dos acciones dentro de AI Studio:
  • Get Events: Lee los eventos de un período específico de la agenda y trae esta información al contexto del agente.
  • Create Event: Crea un nuevo evento en la agenda con todos los detalles: título, descripción, fecha, hora, invitados y notificaciones.
Image

​
Cómo funcionan los Steps en Tess: lee antes de configurar

Este es el punto más importante para usar la integración correctamente: Todos los steps de App Integration se ejecutan antes de cualquier interacción con el usuario. Esto significa que, cuando abres el chat y comienzas a hablar con el agente, los steps ya fueron ejecutados. Por lo tanto, el agente no puede:
  • Esperar tu aprobación para crear el evento
  • Usar información dada a mitad de la conversación para ejecutar el step
Lo que el agente sí puede hacer:
  1. Usar User Inputs que fueron completados antes de que la conversación comience
  2. Usar información fija preconfigurada en el step
  3. Usar User Decision, que también recopila los datos necesarios antes de la conversación

​
Resumen práctico:

EscenarioFunciona
El step crea evento con datos de User Inputs (completados antes del chat)SÍ
El step crea evento con URL o datos fijos configuradosSÍ
El step espera aprobación del usuario en el chat para actuarNO
El step usa una respuesta dada a mitad de la conversación para crear un eventoNO

​
Dónde encontrarlo

  1. Accede a AI Studio
  2. Haz clic en Add AI Step
  3. En Select Step Category, elige App Integration
  4. En Choose an App, selecciona Google Calendar
  5. En Select Step Type, elige Create Event o Get Events

​
Cómo usar (Quickstart)

Configura los siguientes campos:
CampoQué completar
Step NameNombre interno del step (ej: Crear reunión de onboarding)
Event TitleTítulo del evento (ej: variable {{nome_cliente}})
Event DescriptionAgenda o descripción de la reunión
Start Date / Start TimeFecha y hora de inicio (DD/MM/YYYY y HH:MM)
End Date / End TimeFecha y hora de fin
TimezoneZona horaria (ej: UTC-03:00 para Brasília)
Send NotificationsYes para enviar invitaciones por correo a los participantes
Calendar Owner EmailCorreo de la cuenta de Google que recibirá el evento
Guest EmailsCorreos de los invitados separados por comas
NOTA:Todos los campos marcados con User Decision pueden completarse dinámicamente mediante inputs o fijarse en la configuración del step.
Image
Configura los siguientes campos:
CampoQué completar
Step NameNombre interno del step (ej: Buscar agenda semanal)
Start DateFecha de inicio del período a consultar
End DateFecha de fin del período
TimezoneZona horaria de la agenda
Calendar Owner EmailCorreo de la agenda a consultar
Los eventos encontrados en este período estarán disponibles en el contexto del agente para usarse en la respuesta o en otros steps.
Image

​
Explicación más profunda

Como los steps se ejecutan antes de la conversación, la lógica de uso cambia. El agente no crea eventos “a mitad del chat” — inicia la conversación con el evento ya creado (o con los datos ya recopilados). El diseño correcto es: 
User Inputs (recopilados antes)
        ↓
   El step se ejecuta
(Create Event o Get Events)
        ↓
   El agente inicia la conversación
 ya con el evento creado o
  con los datos de la agenda
Combinando Get Events + Create Event:
Si quieres un agente que “revise la agenda y programe el mejor horario”, lo ideal es que ambos steps se ejecuten en secuencia con datos predefinidos — por ejemplo, consultando los eventos de la semana actual y luego creando el evento en el primer espacio disponible. Este tipo de lógica funciona bien en Agentes de Texto activados de forma programada o mediante integración con otra plataforma (ej: Zapier, Make o N8N).

​
Ejemplos prácticos

Agente de onboarding que agenda reunión automáticamente

  • Completas los datos al inicio (User Inputs): nombre, correo, fecha y horario disponibles.
  • El step Create Event usa estas variables y crea el evento antes de que el chat comience.
  • El agente inicia la conversación confirmando: “¡Hola! Tu reunión de onboarding fue agendada para [fecha] a las [hora]. Esto es lo que veremos…”

Resumen diario de agenda

  • Un Agente de Texto se activa automáticamente (vía Make, por ejemplo) cada mañana.
  • El step Get Events obtiene todos los eventos del día.
  • El agente genera un resumen estructurado de la agenda y lo envía por correo o Slack.

Disparo vía formulario externo

  • Una integración vía N8N o Zapier activa el Agente de Texto de Tess con los datos del formulario como inputs.
  • El step Create Event crea el evento y envía la invitación automáticamente.
  • No se requiere interacción humana en el proceso.
Buenas prácticas
  • User Inputs son tus aliados: Siempre que los datos del evento sean variables (nombre, fecha, correo), crea un User Input correspondiente y mapéalo en el step.
  • User Decision es para casos simples: Úsalo cuando necesites que el usuario proporcione el dato antes de que el agente inicie — ideal para Agentes de Texto.
  • Define siempre el Timezone: Eventos sin zona horaria correcta pueden crearse con horario incorrecto, especialmente si la agenda está en otro país o región.
  • Separa correctamente los correos en Guest Emails: Sin espacios después de la coma. Ejemplo: Ex: {{email_cliente}},gestor@empresa.com
  • Nombra bien tu step: Con múltiples steps en el agente, nombres claros evitan confusiones en el mantenimiento.

​
Ten en cuenta los siguientes puntos:

  • Autenticación obligatoria: Google Calendar debe estar integrado a tu cuenta en Tess antes de usar el step.
  • El step siempre se ejecuta: Independientemente del contexto de la conversación, el step se ejecutará al iniciar el agente. Asegúrate de que los datos estén disponibles.
  • Consumo de créditos: Cada ejecución del step consume créditos de tu plan.
Google Calendar convierte a Tess en un motor de agendamiento inteligente — pero la clave está en entender cuándo actúa. Con los datos correctos disponibles antes de que comience la conversación, tu agente crea eventos, consulta agendas y confirma reuniones sin intervención manual.