1️⃣ Gestión de Plantillas de WhatsApp
¿Cuál es la diferencia entre una plantilla "Utility" y una "Marketing"?
La categorización de las plantillas la realiza directamente WhatsApp (Meta) y es crucial para la facturación y el tipo de contenido permitido.
Utility (Utilidad): Se usan para enviar información importante y esperada por el cliente en el contexto de una transacción o interacción existente (ej. recordatorios de citas, confirmaciones de reserva).
Marketing: Se usan para enviar mensajes promocionales, ofertas o anuncios (ej. descuentos, lanzamiento de nuevos servicios).
Importante: Si una plantilla es categorizada como “Marketing”, puede tener un coste adicional. Es fundamental que el contenido sea claro y específico para que WhatsApp la apruebe como “Utility”.
¿Cómo puedo crear una plantilla con variables personalizadas?
Sí, puedes personalizar tus plantillas usando las variables disponibles en la sección "Campos Disponibles" dentro del editor de plantillas. Sigue estos pasos:
Navega a la sección de creación de plantillas.
Localiza la sección "Campos Disponibles".
Inserta las variables que necesites en el cuerpo de tu plantilla, siguiendo el formato exacto.
¿Cómo creo una plantilla de escritura libre?
Para crear una plantilla que te permita escribir contenido personalizado al enviarla, debe incluir la variable {{motivo}}. Recuerda estos requisitos:
La plantilla no puede empezar ni terminar con una variable.
Debe haber texto antes y después de la variable (un saludo y una despedida son suficientes).
¿Cuánto tiempo tarda WhatsApp (Meta) en aprobar mis plantillas?
El proceso de aprobación lo realiza directamente Meta y no tiene un tiempo fijo. Puede variar desde unos pocos minutos hasta varias horas. Un tiempo de espera de 30 minutos a 1 hora es completamente normal. Mientras la plantilla está en revisión, su estado será "Enviada".
¿Por qué no puedo editar una plantilla aprobada?
Una vez que una plantilla ha sido aprobada por Meta, no se puede editar por motivos de seguridad. Para hacer cualquier cambio, debes crear una nueva plantilla con un nombre diferente y enviarla a aprobación. Solo las plantillas en estado "Borrador" pueden ser modificadas.
Mi plantilla fue aprobada pero da error al enviarla, ¿qué hago?
Si una plantilla aprobada te da un error de “inválido”, puede deberse a varias razones:
Problema con variables: Asegúrate de que las variables se están llenando correctamente.
Contenido del logo: Si has añadido un logo recientemente, verifica que cumple con las políticas de WhatsApp.
Prueba desde recordatorios: Intenta enviarte la plantilla a ti mismo desde el apartado de recordatorios con una cita de prueba.
Si el problema persiste, contacta con soporte indicando el nombre exacto de la plantilla.
¿Qué pasa si Meta rechaza mi plantilla?
Sí, puedes corregirla y volver a enviarla. Si Meta rechaza tu plantilla, contacta con soporte y proporciona la siguiente información:
Nombre exacto de la plantilla.
El contenido de la plantilla.
Cualquier mensaje de error de Meta.
Las razones más comunes de rechazo son el uso incorrecto de variables, el formato de los botones o contenido que parece promocional.
¿Cómo evito que mis plantillas sean categorizadas como "Marketing"?
Para aumentar la probabilidad de que tus plantillas sean categorizadas como "Utility", sigue estas buenas prácticas:
Evita el lenguaje promocional: No utilices palabras como "gratis", "oferta", "descuento" u "oportunidad".
Modera el uso de signos de exclamación y mayúsculas.
Revisa el contenido: Si un recordatorio ha sido categorizado como "Marketing", revisa el texto. A veces, una simple palabra puede ser la causa.
2️⃣ Envío y Recepción de Mensajes
Algunos de mis pacientes no reciben los mensajes, ¿qué puedo hacer?
Si notas que algunos pacientes no reciben tus mensajes, sigue estos pasos:
Verifica la conexión del paciente: Confirma que tiene conexión a internet y la app de WhatsApp actualizada.
Pide que te agreguen a contactos: Para asegurar la entrega, pide al paciente que agregue el número de la clínica a sus contactos y que envíe un mensaje inicial.
Revisa el estado del mensaje en Kokuai: Un check (enviado), doble check (entregado), doble check azul (leído).
Si el problema persiste, solicita a nuestro agente virtual que te pase con un agente y te resolveremos la duda personalmente.
¿Cómo evito que pacientes duplicados reciban varios mensajes?
Esto ocurre cuando un paciente aparece en varias agendas. La solución recomendada es unificar las fichas duplicadas para que solo exista un perfil, aunque tenga citas en diferentes agendas.
¿Qué significa el símbolo del hexágono en mis mensajes?
El símbolo del hexágono indica que hay un problema con la entrega del mensaje. Esto puede deberse a que el paciente no tiene conexión, ha bloqueado el número o no ha aceptado las políticas de comunicación de WhatsApp.
Tengo un paciente con dos números de teléfono, ¿cómo aseguro que el mensaje se envía al correcto?
Actualmente, el sistema puede tener dificultades para seleccionar el número correcto. Para asegurar el envío, deja únicamente el número principal en la ficha del paciente y elimina temporalmente los secundarios.
3️⃣ Configuración de Automatizaciones y Bots
¿Por qué el calendario no se actualiza cuando un paciente responde?
La sincronización automática del calendario (confirmar, cancelar, reagendar) requiere que el Bot de Gestión de Recordatorios esté activo. Para que funcione, es imprescindible que añadas este bot al enviar los recordatorios de cita.
Si el bot está añadido: La respuesta del paciente actualizará la agenda automáticamente.
Si el bot NO está añadido: La respuesta del paciente se enviará a la bandeja de entrada para que la gestione un agente humano, y el estado de la cita deberá actualizarse manualmente en la agenda.
¿Cómo puedo configurar el bot para que responda a acciones específicas?
La configuración de respuestas personalizadas del bot (por ejemplo, confirmar o reprogramar una cita) es una funcionalidad avanzada. Si deseas añadir más bots o automatismos personalizados, es necesario solicitar un presupuesto al equipo de Kokuai para ampliar tu plan.
¿Puedo solicitar modificaciones puntuales en los envíos?
No es posible crear automatismos tan puntuales o específicos (ej. enviar mensajes solo a una agenda en un día concreto). El sistema está diseñado para seguir reglas generales. Para este tipo de cambios, la gestión debe hacerse manualmente.
4️⃣ Gestión de Contactos y Pacientes
Tengo problemas al importar mis contactos con un archivo CSV, ¿qué puedo hacer?
La importación puede fallar por problemas de formato. Se recomienda:
Usar la plantilla de Kokuai: Descárgala y no modifiques los encabezados.
Probar primero con una sola línea: Antes de subir toda la base de datos.
Revisar el formato de las celdas: Teléfonos con formato internacional y sin caracteres extraños.
Si después de esto sigues teniendo errores, solicita a nuestro agente virtual que te pase con un agente y envía el archivo CSV para que te solucionemos el problema personalmente.
5️⃣ Sincronización, Agenda y Citas
¿Por qué no se actualiza el estado de la cita en mi agenda cuando un paciente confirma su asistencia?
Esto puede ocurrir por dos razones principales: que el paciente haya respondido de forma incorrecta o que se haya interrumpido la conexión con tu software de gestión. Te recomiendo que verifiques el estado de la cita en el apartado de Recordatorios de Kokuai. Si el estado aparece como "Pendiente", significa que el paciente todavía no ha respondido. Si el estado es diferente pero no se refleja en tu agenda, probablemente sea un problema de sincronización y deberías contactar con nuestro equipo técnico.
¿Cómo puedo verificar si un paciente ha confirmado o cancelado su cita a través de la plataforma?
Es muy sencillo. Dirígete al apartado de Recordatorios en Kokuai y revisa la columna Estado. Si el estado es "Pendiente", significa que el paciente todavía no ha respondido. Si muestra "Confirmado" o "Cancelado", podrás ver la respuesta del paciente. También puedes comprobar directamente desde la conversación con el paciente para ver su respuesta.
El estado de una cita no ha cambiado en mi agenda después de que el paciente respondió. ¿Qué debo hacer?
En primer lugar, dirígete al apartado de Recordatorios y comprueba el estado de la cita. Si aparece como "Pendiente", significa que el paciente todavía no ha respondido. Revisa que el recordatorio se haya enviado correctamente, que el paciente haya respondido y que el bot haya gestionado la respuesta adecuadamente. Si el estado en Kokuai es diferente de "Pendiente" pero no aparece actualizado en tu software de gestión, ponte en contacto con nosotros para que lo revisemos.
¿Existe algún retraso conocido en la sincronización de estados entre la plataforma y mi software de agenda?
No, no hay retrasos conocidos. Cualquier retraso que experimentes puede deberse a una interrupción en la sincronización. Los tiempos de actualización no deberían superar los específicos de cada sincronización. Si experimentas retrasos superiores a los esperados, contacta con nuestro equipo técnico.
¿Por qué las citas de mi agenda de Gesden no se están sincronizando correctamente con la plataforma?
Primero, comprueba que el servidor esté encendido y que tengas acceso a Internet. Si utilizas una extensión del navegador, verifica que esté activa. Si todo parece estar correcto, ponte en contacto con nosotros para que podamos revisar el problema en detalle.
¿La sincronización de la agenda es bidireccional? Si hago un cambio en la plataforma, ¿se reflejará en mi agenda externa?
La respuesta depende del software de gestión que utilices. Si trabajas con Gesden G5, tienes el módulo de Agenda activado y cuentas con la versión más actualizada del conector, entonces sí: la agenda será bidireccional y podrás realizar modificaciones desde ambas agendas. Si utilizas otro software, la bidireccionalidad puede variar.
He notado un retraso en la actualización de las citas entre la plataforma y mi agenda. ¿Es normal?
Sí, es normal. La sincronización no es instantánea. El tiempo de actualización depende del software con el que trabajes. Aquí te muestro los tiempos aproximados:
Gesden G5: 1 minuto en ambas direcciones
Gesden One: 10 minutos de Gesden a Kokuai, instantáneo de Kokuai a Gesden
Klinikare: 10 minutos de Klinikare a Kokuai, instantáneo de Kokuai a Klinikare
Nubimed: Instantáneo en ambas direcciones, excepto desde el portal online (se sincroniza a las 10:00, 12:00, 15:00, 18:00, 20:00 y 22:00)
AgendaBox / Softgam: 1 minuto en ambas direcciones
Si los tiempos de espera superan estos valores, ponte en contacto con nosotros.
¿Qué debo hacer si una cita específica no se sincroniza o desaparece de la agenda?
Si solo una cita no se sincroniza o desaparece, comprueba primero el estado o situación de esa cita en tu software de gestión. Si el problema persiste, contacta con nosotros. Si el problema afecta a todas las citas, definitivamente debes ponerte en contacto con nuestro equipo técnico.
¿Cómo puedo forzar una resincronización completa de mi agenda si sospecho que hay errores?
No es posible que lo hagas directamente. Tendrás que comunicarte con nuestro equipo técnico para que realicen la resincronización completa de tu agenda.
¿Cómo funciona exactamente la vinculación de las cancelaciones y confirmaciones de citas con mi software de agenda?
Se establece una relación entre los estados de Kokuai (Confirmado, Cancelado, Pendiente) y los estados o situaciones de las citas en tu software de gestión. Cuando un paciente responde a un recordatorio, el estado se actualiza en Kokuai y, posteriormente, se sincroniza con tu software de agenda.
Estoy teniendo problemas para que las cancelaciones realizadas por los pacientes se reflejen correctamente en mi agenda. ¿Qué pasos debo seguir?
Dirígete al apartado de Recordatorios y comprueba que la columna de recordatorio indique que el mensaje se ha enviado. Si se ha enviado, verifica el estado de la cita:
Si el estado es Pendiente: dirígete a la conversación y comprueba si el paciente ha respondido o no.
Si el estado es Cancelada: si ha superado los tiempos establecidos de sincronización, ponte en contacto con nosotros.
6️⃣ Mensajería y Automatización
Estoy recibiendo reportes de que mis mensajes no se están entregando a los pacientes. ¿Cuál podría ser el problema?
Para saber exactamente por qué no se están entregando, necesito que hagas clic en el icono rojo junto al mensaje fallido. Allí verás el detalle del error. Uno de los errores más comunes es "Not Suitable Device", que significa que el paciente no ha aceptado las políticas de privacidad y comunicación de WhatsApp. La forma más sencilla de solucionarlo es que el paciente te envíe un mensaje. De este modo, acepta automáticamente recibir comunicaciones por tu parte. Si el error es diferente, cuéntame exactamente qué dice y te ayudaré a resolverlo.
¿Cómo puedo hacer un seguimiento para confirmar que un mensaje ha sido entregado y leído por el paciente?
En el apartado de Recordatorios de Kokuai puedes comprobar fácilmente si los mensajes se han enviado, recibido o leído. Funciona exactamente como WhatsApp: verás los checks de verificación. Cuando envíes la plantilla, enseguida empezarás a ver, a la derecha de cada cita del paciente de ese día, los checks que te indicarán en qué punto está el proceso.
Varios de mis pacientes no están recibiendo los mensajes de recordatorio. ¿Hay algún problema general con el servicio de entrega?
Para saber por qué no están recibiendo el mensaje, necesito ver qué error aparece. Puedes revisarlo abajo a la derecha del mensaje: al pasar el cursor por encima del círculo rojo, se muestra la descripción del error. Los errores más comunes son "not suitable device" o "invalid params". Si me dices exactamente qué pone, lo revisaremos. Si lo prefieres, puedes decirme el nombre del paciente y revisaremos nosotros la conversación.
¿Qué debo hacer si sospecho que hay un problema con la entrega de mensajes a un grupo específico de pacientes?
Hay dos situaciones que nos ayudan a identificar el problema:
Si la plantilla se envía pero no le llega al paciente: Aparecerá un error. Los más habituales son "Not Suitable Device" o "Invalid Params", y suelen ser fáciles de solucionar.
Si la plantilla no se envía: Hay que revisar que las variables de la plantilla estén correctamente configuradas. Que una plantilla esté aprobada no significa que no pueda dar error al enviarse.
Lo más práctico es que me indiques el nombre de la plantilla que quieres enviar y lo revisaremos juntos.
¿Por qué el bot responde automáticamente a conversaciones que preferiría gestionar manualmente?
El bot está configurado para responder a una plantilla que incluye botones. Si el paciente, en lugar de responder mediante uno de esos botones, inicia una conversación, el bot interviene. Para evitar que se convierta en una conversación a tres, simplemente debes desactivar el bot haciendo clic en la X que aparece a la derecha de la conversación.
¿Es posible desactivar las respuestas automáticas del bot para ciertos tipos de conversaciones o pacientes?
No, esto no es posible. El bot no diferencia por pacientes, sino que responde a una plantilla concreta que lleva un tipo de botones determinado. Si envías una plantilla con un bot asociado, siempre responderá lo mismo, independientemente del paciente. Si tienes algún grupo de pacientes a los que no te interesa que responda el bot, simplemente debes enviar la plantilla sin añadir el bot.
El bot no parece entender la consulta de mi paciente. ¿Cómo puedo hacer para que la conversación sea transferida a un agente humano?
Si ves que el bot no está respondiendo correctamente a lo que solicita el paciente, simplemente debes eliminar el bot de esa conversación. Puedes hacerlo desde el apartado que aparece a la derecha de la conversación. De esta forma, podrás continuar la conversación directamente con el paciente.
¿Cómo puedo configurar o personalizar el comportamiento del bot para que se ajuste mejor a las necesidades de mi clínica?
La configuración del bot la realiza únicamente nuestro equipo técnico. Debes indicarnos exactamente cómo deseas que se comporte el bot, y nuestros técnicos lo revisarán y evaluarán para determinar si lo solicitado es viable.
Los recordatorios de cita no se están enviando como estaban programados. ¿Cómo puedo solucionar este problema?
Si crees que los mensajes no se están enviando según lo solicitaste, debes indicarme qué comportamiento incorrecto está ocurriendo. Esta tarea debe ser gestionada por nuestro equipo técnico. Lo revisarán y procederán a corregirlo.
¿Podrían guiarme en la configuración correcta de los recordatorios automáticos para asegurar que se envíen en el momento adecuado?
Por supuesto. Para que nuestro equipo técnico pueda configurar correctamente los automatismos, necesito que rellenes la siguiente información:
Nombre del automatismo: ¿Cómo quieres llamarlo?
¿Cuándo se envía?: Por ejemplo, 24 horas antes de la cita
¿A qué hora?: La hora exacta
¿Qué plantilla se utiliza?: El nombre de la plantilla
¿A quién se envía?: Pacientes, doctores, etc.
¿Qué agendas incluye?: Todas o solo algunas
Con esta información, podremos crear los automatismos exactamente como los necesitas.
Cuando falla el envío de recordatorios, ¿por qué suele ser?
La causa más común por la que falla el envío de un recordatorio es que se haya eliminado la plantilla con la que se había creado. Si la plantilla se borra, el automatismo no puede ejecutarse. Si la plantilla no se ha borrado, tendremos que revisar con nuestro equipo técnico qué ha podido fallar.
¿Cómo puedo asegurarme de que el envío de recordatorios no falla/da error?
Puedes comprobar si un automatismo se ha ejecutado correctamente desde el apartado de Automatismos en la plataforma de Kokuai. Desde allí, podrás ver la fecha y la hora de la última ejecución de ese automatismo y verificar si el envío se realizó correctamente.
Necesito ayuda para configurar un nuevo automatismo para recordatorios de citas (recalls). ¿Podrían guiarme?
Claro. Para crear un automatismo, necesitamos que nos proporciones la siguiente información:
Nombre del automatismo
¿Cuándo se envía?
¿A qué hora?
¿Qué plantilla se utiliza?
¿A quién se envía?
¿Qué agendas incluye?
Una vez que nos proporciones estos datos, nuestro equipo técnico creará el automatismo para ti.
Mi automatismo de recordatorios no parece estar funcionando. ¿Cómo puedo diagnosticar el problema?
La razón más habitual por la que un automatismo no se ejecuta es que se haya borrado la plantilla que debía enviar. Comprueba si la plantilla todavía existe. Si no fuera así, tendremos que revisar internamente cuál es el motivo del fallo.
¿Es posible crear un automatismo para contactar a pacientes que no han venido en mucho tiempo?
No, para eso no se utiliza un automatismo. Tendrías que hacer una difusión puntual. Debes subir el listado de pacientes con los que quieres contactar y crear una plantilla para enviarles. Esto se puede hacer desde el apartado de Marketing, creando una nueva difusión.
¿Cómo puedo modificar un automatismo que ya está activo?
Para cualquier modificación de un automatismo, debes ponerte en contacto con nosotros y explicarnos qué tipo de cambio deseas. Desde soporte, lo remitiremos al equipo técnico para que realice los ajustes que solicites.
7️⃣ Configuración de la Cuenta
¿Cómo cambio la foto de perfil de mi número de WhatsApp?
La foto de perfil se gestiona desde tu Facebook Business Manager. Kokuai no puede cambiarla directamente. Debes acceder a la configuración de WhatsApp Business desde Facebook.
¿Por qué desaparecen los agentes que añado a mi equipo?
Si los agentes desaparecen después de añadirlos, puede tratarse de un comportamiento inesperado del sistema. Esto no es normal. En ese caso, por favor contacta con el equipo de soporte técnico para que puedan investigar el problema en tu cuenta.
