> For the complete documentation index, see [llms.txt](https://prometheo.gitbook.io/prometheo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prometheo.gitbook.io/prometheo/integraciones/agendapro.md). # Agendapro ## AgendaPro + Prometheo La integración entre AgendaPro y Prometheo permite que tu asistente pueda consultar disponibilidad real, ofrecer turnos y reservarlos automáticamente desde el chat. Esto significa que Prometheo no trabaja con horarios inventados ni genéricos: usa la disponibilidad que devuelve AgendaPro según los calendarios configurados. *** ### Qué podés hacer con esta integración Con AgendaPro conectado a Prometheo, el asistente puede: Consultar la disponibilidad real de tus profesionales. Ofrecer turnos disponibles automáticamente. Detectar si el cliente quiere atenderse con un profesional específico. Reservar en el calendario correcto. Bloquear el horario una vez confirmado el turno. Trabajar solo con los profesionales que dejes habilitados. Excluir profesionales si no querés que el asistente ofrezca turnos con todos. Enviar recordatorios, según el tipo de conexión de WhatsApp que tengas. *** ### Cómo funciona en una conversación real El flujo esperado es este: 1. Una persona escribe por WhatsApp o por el canal conectado. 2. El asistente identifica que quiere sacar un turno. 3. Prometheo consulta la disponibilidad disponible en AgendaPro. 4. El asistente ofrece horarios reales. 5. La persona elige un horario. 6. El asistente confirma la reserva. 7. El turno queda creado y bloqueado en AgendaPro. Ejemplo: Cliente:\ “Hola, quiero sacar turno con la doctora Martínez para la semana que viene.” Asistente:\ “Perfecto. Te paso los horarios disponibles con la doctora Martínez para la semana que viene.” Luego, el asistente ofrece opciones reales según la disponibilidad de AgendaPro. *** ### Requisito importante antes de avanzar Para usar AgendaPro con Prometheo, necesitás tener AgendaPro en plan Pro. El plan básico de AgendaPro no alcanza para esta integración. Antes de contratar o configurar la integración, validá este punto. Es el requisito principal para que Prometheo pueda conectarse correctamente y trabajar con la disponibilidad real. *** ### Qué necesitás para conectar AgendaPro Para conectar AgendaPro con Prometheo necesitás las credenciales de AgendaPro. Estas credenciales se obtienen desde tu cuenta de AgendaPro, ingresando a: Configuraciones > API Pública Luego, esas credenciales se cargan en Prometheo desde la sección de integraciones. *** ### Paso a paso para configurar AgendaPro #### Paso 1: Entrar a AgendaPro Ingresá a tu cuenta de AgendaPro con un usuario que tenga permisos para acceder a la configuración de la cuenta. #### Paso 2: Ir a Configuraciones Dentro de AgendaPro, buscá la sección Configuraciones. #### Paso 3: Buscar API Pública Dentro de Configuraciones, ingresá a API Pública. Desde ahí vas a obtener las credenciales necesarias para conectar AgendaPro con Prometheo. #### Paso 4: Entrar a Prometheo Ingresá a tu cuenta de Prometheo. #### Paso 5: Ir a Integraciones Desde el menú de Prometheo, entrá a la sección Integraciones. #### Paso 6: Elegir AgendaPro Buscá AgendaPro dentro de las integraciones disponibles. #### Paso 7: Cargar las credenciales Pegá las credenciales obtenidas desde AgendaPro. #### Paso 8: Definir qué profesionales estarán disponibles Configurá qué profesionales querés dejar habilitados para que el asistente pueda ofrecer turnos. También podés excluir profesionales si no querés que el asistente reserve en todas las agendas. #### Paso 9: Configurar la lógica del asistente Definí cómo querés que el asistente actúe frente a pedidos de turno. Por ejemplo: Si debe preguntar por profesional. Si debe ofrecer el primer horario disponible. Si debe pedir datos antes de reservar. Si debe mencionar condiciones de reserva. Si debe pedir una seña antes de confirmar. #### Paso 10: Configurar recordatorios, si aplica Si querés enviar recordatorios automáticos, también podés configurarlos según el tipo de conexión de WhatsApp que uses. *** ### Cómo elegir profesionales habilitados Esta parte es importante si trabajás con varias agendas. Prometheo puede trabajar con múltiples profesionales, pero no necesariamente tiene que ofrecer turnos con todos. Podés definir: Qué profesionales están habilitados. Qué profesionales quedan excluidos. Cómo debe actuar el asistente si el cliente pide un profesional específico. Qué hacer si ese profesional no tiene disponibilidad. Ejemplo: Si un cliente pide turno con “Laura”, el asistente debería buscar disponibilidad en la agenda de Laura, no en cualquier otra agenda. Esto evita reservas incorrectas y mejora la experiencia del cliente. *** ### Qué pasa cuando el cliente confirma un turno Cuando el cliente elige y confirma un horario, Prometheo genera la reserva usando AgendaPro. El resultado esperado es: El turno queda reservado. El horario queda bloqueado. La reserva se visualiza dentro de AgendaPro. El asistente puede continuar la conversación con la confirmación correspondiente. Ejemplo: “Listo, tu turno quedó confirmado para el martes 18 a las 15:30 con la doctora Martínez.” *** ### Señal o seña para reservar Si tu negocio requiere una seña para reservar, eso tiene que estar indicado explícitamente en el prompt del asistente. El asistente no debe asumir que hay una seña si no está escrito en sus instrucciones. Por ejemplo, si necesitás pedir seña, el prompt debería incluir algo como: “Para confirmar un turno, el cliente debe abonar una seña. No confirmes la reserva hasta que el cliente haya recibido las instrucciones de pago o haya completado el paso correspondiente.” Si esto no está indicado en el prompt, el asistente no debería decir que hay que pagar una seña. *** ### Recordatorios de turnos La integración también permite trabajar con recordatorios. El funcionamiento depende del tipo de conexión de WhatsApp que tengas en Prometheo. #### Si tu WhatsApp está conectado por QR El texto del recordatorio se define mediante prompt. Esto permite indicar cómo debe redactarse el mensaje, qué información debe incluir y en qué tono debe enviarse. #### Si tu WhatsApp está conectado por API oficial Los recordatorios se envían mediante plantillas configuradas. En este caso, el mensaje depende de las plantillas disponibles y aprobadas para la cuenta. Esto es importante porque con API oficial no se envía cualquier texto libre como recordatorio, sino que se trabaja con plantillas. *** ### Ejemplos de pedidos que puede resolver el asistente “Quiero sacar turno para mañana.” “¿Tenés disponibilidad con la doctora Pérez?” “Necesito un turno para limpieza facial esta semana.” “Quiero reservar con Juan el viernes por la tarde.” “¿Qué horarios hay disponibles para el lunes?” “Necesito cambiar mi turno.” “Quiero cancelar mi turno.” Según la configuración, el asistente podrá consultar disponibilidad, ofrecer horarios y avanzar con la reserva. *** ### Antes de contratar o activar la integración, revisá esto Antes de avanzar con AgendaPro + Prometheo, conviene validar: Que tu cuenta de AgendaPro tenga plan Pro. Que quieras automatizar reservas, no solo responder consultas. Que tus calendarios estén bien configurados en AgendaPro. Que sepas qué profesionales querés habilitar. Que tengas claro si vas a pedir seña o no. Que definas qué datos necesitás pedir antes de reservar. Que sepas si usarás recordatorios. Que tengas claro si tu WhatsApp está conectado por QR o por API oficial. *** ### Para qué negocios sirve especialmente bien Esta integración es útil para negocios que trabajan con turnos, reservas o atención por agenda. Por ejemplo: Centros de estética. Consultorios. Clínicas. Profesionales independientes. Centros médicos. Peluquerías. Barberías. Spas. Servicios con agenda previa. Equipos con varios profesionales. Es ideal cuando querés evitar que una persona tenga que responder manualmente cada consulta de disponibilidad. *** ### Qué no conviene asumir Hay algunas cosas que conviene tener claras desde el principio. Prometheo no inventa horarios. Prometheo consulta la disponibilidad que devuelve AgendaPro. La reserva debe verse dentro de AgendaPro una vez confirmada. Si querés pedir seña, debe estar indicado en el prompt. No cualquier plan de AgendaPro sirve: necesitás plan Pro. Si usás WhatsApp API oficial, los recordatorios funcionan con plantillas. Si tenés varios profesionales, hay que configurar correctamente cuáles estarán habilitados. *** ### Recomendación para configurar el prompt del asistente Para que la integración funcione bien, el prompt del asistente debería explicar claramente cómo manejar los turnos. Podés incluir instrucciones como: “El asistente debe usar la integración con AgendaPro para consultar disponibilidad real antes de ofrecer turnos.” “El asistente no debe inventar horarios.” “Si el cliente pide un profesional específico, debe buscar disponibilidad en la agenda de ese profesional.” “Si el profesional solicitado no tiene disponibilidad, debe ofrecer alternativas según la configuración del negocio.” “Antes de confirmar una reserva, debe validar los datos necesarios del cliente.” “Si la reserva requiere seña, debe informarlo antes de confirmar el turno.” “Una vez confirmado el turno, debe indicar día, horario, profesional y servicio reservado.” *** ### Como obtener clave API en Agenda Pro {% hint style="warning" %} El usuario y clave API sólo están disponibles a partir de los planes de AgendaPro. Si no tenés ese plan, no podrás acceder a esa funcionalidad. {% endhint %} ## Configurar AgendaPro en Prometheo Para conectar AgendaPro con Prometheo necesitás hacer dos cosas dentro de AgendaPro: 1. Obtener las credenciales de API. 2. Pegar la URL del webhook de Prometheo. Estas credenciales no son el mail y la contraseña que usás para entrar a AgendaPro. Son datos técnicos que AgendaPro genera para permitir que Prometheo se conecte con la cuenta. *** ## 1. Obtener las credenciales de API de AgendaPro ### Paso 1: ingresar con un usuario administrador Entrá a AgendaPro con un usuario que tenga permisos de administrador. Si entrás con un usuario limitado, puede que no veas las opciones de configuración, integraciones o API. *** ### Paso 2: entrar a Configuraciones Desde el panel de AgendaPro, hacé clic en el ícono de la tuerca o engranaje. Luego ingresá en: **Configuraciones** *** ### Paso 3: entrar a Integraciones / API Pública Dentro de Configuraciones, buscá una sección llamada: **Integraciones** o **Integraciones / API Pública** El nombre puede variar según la versión de la cuenta. *** ### Paso 4: buscar la sección API Dentro de Integraciones o API Pública, bajá hasta encontrar la sección llamada: **API** Ahí AgendaPro puede mostrar una de estas dos opciones: * Usuario API y Contraseña API. * API Key o botón para generar una API Key. *** ### Paso 5: copiar las credenciales correctas #### Caso 1: si AgendaPro muestra Usuario API y Contraseña API Copiá los datos que aparecen en la sección API: **Usuario API**\ **Contraseña API** Estos son los datos que hay que cargar en Prometheo. No uses el mail ni la contraseña normal de AgendaPro. *** #### Caso 2: si AgendaPro muestra una API Key Si aparece la opción para generar una API Key: 1. Hacé clic en **Crear API Key** o **Generar API Key**. 2. Colocale un nombre claro, por ejemplo:\ **Prometheo** 3. Generá la clave. 4. Copiá la API Key completa. 5. Guardala en un lugar seguro. Importante: en muchas plataformas, la API Key completa se muestra una sola vez. Si se pierde, probablemente haya que generar una nueva. *** ### Paso 6: cargar las credenciales en Prometheo Una vez que tengas las credenciales, entrá a Prometheo y cargalas en la integración de AgendaPro. Según el caso, Prometheo puede pedir: * Usuario API y Contraseña API. o * API Key. Copiá y pegá los datos exactamente como aparecen en AgendaPro, sin espacios extra y sin modificar nada. *** ## 2. Configurar el webhook de Prometheo en AgendaPro El webhook sirve para que AgendaPro le avise a Prometheo cuando ocurre un cambio importante, por ejemplo una reserva creada, modificada o cancelada. *** ### Paso 1: copiar la URL del webhook desde Prometheo Desde Prometheo, copiá la URL del webhook de AgendaPro. En este caso, la URL es: Debe copiarse completa y sin modificar nada. *** ### Paso 2: entrar a AgendaPro Ingresá nuevamente a AgendaPro con un usuario administrador. *** ### Paso 3: entrar a Configuraciones Hacé clic en la tuerca o engranaje. Luego ingresá en: **Configuraciones** *** ### Paso 4: entrar a API Pública Buscá la sección: **API Pública** o **Integraciones / API Pública** *** ### Paso 5: buscar la sección Webhooks Dentro de API Pública, buscá el apartado: **Webhooks** Si aparece un campo para pegar una URL, ese es el lugar correcto. *** ### Paso 6: pegar la URL del webhook En el campo de URL del webhook, pegá exactamente esta dirección: No agregues espacios.\ No modifiques la URL.\ No pegues el sitio web de la empresa.\ No pegues el link del panel de Prometheo. Tiene que ser la URL técnica del webhook. *** ### Paso 7: seleccionar eventos, si AgendaPro lo permite Si AgendaPro permite elegir qué eventos enviar por webhook, activá los eventos relacionados con reservas o turnos. Como mínimo, deberían quedar activos: * Reserva creada. * Reserva modificada. * Reserva cancelada o eliminada. Si AgendaPro no permite elegir eventos y solo muestra un campo de URL, simplemente pegá la URL y guardá. *** ### Paso 8: guardar los cambios Después de pegar la URL, presioná: **Guardar** o **Actualizar** Verificá que el webhook quede activo. *** ## 3. Probar la conexión Una vez cargadas las credenciales de API y configurado el webhook, hacé una prueba. ### Prueba recomendada 1. Crear un turno de prueba en AgendaPro. 2. Modificar ese turno. 3. Cancelar o eliminar ese turno. 4. Verificar que Prometheo reciba correctamente la información. Si Prometheo no recibe el evento, revisar: * Que la URL esté bien copiada. * Que no tenga espacios al principio o al final. * Que el webhook esté guardado y activo. * Que se hayan activado los eventos de reservas, si AgendaPro permite elegirlos. * Que la cuenta tenga habilitado el acceso a API/Webhooks. *** ## 4. Qué hacer si no aparece la sección API o Webhooks Si el cliente no ve la sección de API o Webhooks, debe revisar lo siguiente: 1. Que esté ingresando con el usuario administrador principal. 2. Que la cuenta tenga un plan compatible con API (a partir de planes Pro de AgendaPro) 3. Que esté dentro de la empresa correcta. 4. Que esté buscando en Configuraciones → Integraciones / API Pública. 5. Que AgendaPro tenga habilitado el acceso a API para esa cuenta. En ese caso, puede escribirle al soporte de AgendaPro este mensaje: “Hola. Tenemos una cuenta con acceso a API y necesitamos conectar AgendaPro con una integración externa. No encontramos la sección de API/Webhooks dentro de Configuraciones → Integraciones / API Pública. ¿Podrían ayudarnos a verificar si está habilitada para nuestra cuenta?” {% hint style="info" %} En caso que no figure la sección de usuario API, solicitar a AgendaPro que lo agreguen o que te generen un usuario y clave. {% endhint %} *** ## 5. Resumen rápido del recorrido ### Para obtener credenciales API AgendaPro\ → Tuerca / engranaje\ → Configuraciones\ → Integraciones / API Pública\ → API\ → Copiar Usuario API y Contraseña API o generar API Key\ → Cargar esos datos en Prometheo *** ### Para configurar webhook AgendaPro\ → Tuerca / engranaje\ → Configuraciones\ → API Pública o Integraciones / API Pública\ → Webhooks\ → Pegar la URL de Prometheo y seleccioná los permisos que debe tener (crear, visualizar, cancelar, etc)\ → Guardar\ → Probar creando o modificando un turno ### Resumen rápido AgendaPro + Prometheo permite automatizar la reserva de turnos desde el chat. Prometheo consulta la disponibilidad real de AgendaPro, ofrece horarios disponibles y, cuando el cliente confirma, reserva el turno en el calendario correspondiente. La integración soporta múltiples profesionales, agendas habilitadas o excluidas, reservas automáticas y recordatorios. Para usarla necesitás AgendaPro en plan Pro. Si querés pedir seña, esa condición debe estar indicada explícitamente en el prompt. Si usás recordatorios, el funcionamiento cambia según tu conexión de WhatsApp: por QR se define por prompt, y por API oficial se trabaja con plantillas.