Agendar Visitas
El bot agenda visitas automáticamente consultando la disponibilidad del agente en Google Calendar.
Agendar Visitas
Cuando un cliente muestra interés en visitar una propiedad, el bot puede ofrecerle horarios disponibles y confirmar la cita automáticamente, sin necesidad de intervención humana. Todo se sincroniza con Google Calendar.
Cómo funciona el flujo
El cliente pide una visita
El cliente envía un mensaje como "Quiero ver la propiedad", "Puedo visitarla mañana?" o "Cuándo podemos coordinar una visita?". El bot reconoce esto como una intención de agendar visita.
El bot busca al agente asignado
El bot verifica si la conversación tiene un agente asignado. Si no hay agente asignado, el bot escala la conversación a un humano para que primero se asigne un agente.
Consulta de disponibilidad
El bot consulta la disponibilidad del agente asignado. Para esto, utiliza dos fuentes de información:
- Google Calendar (si el agente lo tiene conectado): Consulta la API FreeBusy de Google para obtener los bloques ocupados del agente en los próximos 7 días
- Visitas existentes en Trochai: Revisa las visitas ya programadas en la plataforma para evitar conflictos
Los horarios disponibles se calculan basándose en el horario laboral del agente, la duración de visita configurada (por defecto 60 minutos) y un tiempo de descanso entre citas (por defecto 30 minutos).
Presentación de horarios
El bot envía un mensaje interactivo de WhatsApp con hasta 3 botones, cada uno representando un horario disponible. Los botones muestran la fecha y hora en formato corto, por ejemplo: "Lun 3 Mar 10:00".
El cliente selecciona un horario
El cliente toca uno de los botones para seleccionar su horario preferido. No necesita escribir nada.
Confirmación automática
Al seleccionar un horario, el bot automáticamente:
- Crea un evento en Google Calendar del agente con los detalles de la visita
- Registra la visita en Trochai con estado "confirmada"
- Envía un mensaje de confirmación al cliente con la fecha, hora y el nombre del agente
- Etiqueta la conversación como "visita agendada" para fácil seguimiento
Qué información se incluye en la cita
Cuando se crea el evento en Google Calendar, incluye:
- Título: "Visita - [Nombre del cliente]"
- Descripción:
- Método de contacto: WhatsApp
- Nombre y teléfono del cliente
- Propiedad de interés (si se identificó durante la conversación)
- Nombre de la organización
- Duración: Según la configuración del agente (por defecto 60 minutos)
- Zona horaria: America/Costa_Rica
- Asistentes: El agente recibe la invitación en su calendario
Si el agente tiene Google Calendar conectado, recibirá una notificación automática del evento. No necesita revisar Trochai para enterarse de la cita.
Requisitos previos
Para que el agendamiento de visitas funcione completamente, se necesita:
1. Un agente asignado a la conversación
La conversación debe tener un agente asignado. El bot consulta la disponibilidad de ese agente específico. Si no hay agente asignado, el bot escalará la conversación en lugar de intentar agendar.
Vea Asignaciones para más información sobre la asignación de agentes.
2. Google Calendar conectado (recomendado)
Para que el bot tenga acceso a la disponibilidad real del agente, el agente debe conectar su cuenta de Google Calendar en los ajustes de su perfil. Esto permite:
- Ver los bloques ocupados reales del agente
- Crear eventos directamente en su calendario
- Evitar conflictos con reuniones existentes
3. Horario laboral configurado
Cada agente puede configurar su horario laboral en Trochai. El bot solo ofrece horarios dentro de estos rangos. Si no se ha configurado, se usan los valores por defecto:
| Día | Horario por defecto |
|---|---|
| Lunes a Viernes | 9:00 AM - 5:00 PM |
| Sábado | Deshabilitado |
| Domingo | Deshabilitado |
4. Duración y descanso entre visitas
Cada agente puede configurar:
- Duración de la visita: Cuánto tiempo se reserva para cada visita (por defecto: 60 minutos)
- Tiempo de descanso: Tiempo entre visitas para traslados (por defecto: 30 minutos)
Por ejemplo, con duración de 60 minutos y descanso de 30 minutos, el bot ofrecerá horarios con separación de 90 minutos.
Qué pasa si no hay horarios disponibles
Si el bot no encuentra horarios disponibles en los próximos 7 días (por ejemplo, el calendario del agente está lleno), automáticamente:
- Escala la conversación a un agente humano
- Incluye la razón: "Lead de alta intención: schedule_visit (sin horarios disponibles)"
- El agente humano puede coordinar la visita manualmente
Qué pasa si no hay Google Calendar conectado
Si el agente no ha conectado Google Calendar:
- El bot calcula la disponibilidad basándose únicamente en el horario laboral configurado y las visitas existentes en Trochai
- La visita se registra en Trochai pero no se crea un evento en Google Calendar
- El agente deberá revisar sus visitas pendientes en Trochai
Recomendamos que todos los agentes conecten su Google Calendar para una experiencia completa. Sin Google Calendar, el bot no puede detectar reuniones externas del agente, lo que podría causar conflictos de horario.
Seguimiento de visitas
Las visitas agendadas por el bot se pueden consultar y gestionar desde la página de Eventos, accesible desde la barra lateral. Ahí puede:
- Filtrar visitas por pestañas: próximas, pasadas o todas
- Filtrar por estado usando el selector desplegable
- Editar una visita: cambiar la fecha, hora, duración o agregar notas
- Marcar como completada o no asistió directamente desde la tabla
- Cancelar una visita con diálogo de confirmación
La conversación se etiqueta automáticamente como "visita agendada" para fácil seguimiento desde la bandeja de entrada.
Los estados posibles de una visita son: pendiente, confirmada, completada, cancelada o no asistió.
Si el agente tiene Google Calendar conectado, los cambios de estado (completada, cancelada) se sincronizan automáticamente con el evento del calendario.
Limitaciones
- El bot ofrece un máximo de 3 horarios por solicitud (límite de botones de WhatsApp)
- Los horarios se ofrecen dentro de los próximos 7 días
- Los títulos de los botones tienen un máximo de 20 caracteres (formato: "Lun 3 Mar 10:00")
- Si el cliente no selecciona un horario, la solicitud expira y el cliente debe pedir una nueva visita
Siguientes pasos
- Escalamiento -- Qué pasa cuando el bot no puede agendar
- Asignaciones -- Cómo asignar agentes a conversaciones
- Configuración del bot -- Ajustes generales del bot