Herramientas del agente
Las herramientas son pasos que permiten al agente actuar sobre otras partes de Makia: agendar citas, guardar contactos, consultar chatbots, programar campañas o crear publicaciones. Se agregan igual que cualquier paso (botón + > Agregar paso, categoría Agentes).
DisponibilidadCada herramienta aparece solo si esa función está activa en tu cuenta (por ejemplo, el CRM o Bookflow). Si no ves un paso, consulta con tu administrador.
Cómo funcionan todas las herramientas
- Agrega el paso de la herramienta.
- En Evento de acción elige qué operación realizar. Los campos del panel cambian según la operación.
Captura pendiente: Selector de Evento de acción de una herramienta
img/herramientas-evento-accion.png - Completa los campos. Puedes escribir valores fijos o variables entre llaves, como
{sender_id}. - En las operaciones que consultan datos, el Formato de salida permite elegir JSON (datos estructurados completos), Markdown (tabla o resumen) o Texto plano (más fácil de usar dentro de un mensaje o una pregunta a la IA).
- El resultado se guarda en una variable; úsala en los pasos siguientes con el botón { }.
Bookflow (citas)
Conecta el agente con tu agenda de citas de Bookflow. Si Bookflow no está conectado verás el aviso «Bookflow aún no está conectado» con un enlace para conectarlo.
| Operación | Qué hace | Datos que pide |
|---|---|---|
| Listar servicios | Devuelve los servicios disponibles. | Ninguno |
| Listar proveedores | Devuelve los profesionales o recursos. | Servicio (opcional, para filtrar) |
| Verificar disponibilidad | Devuelve los horarios libres de un día. | Servicio, proveedor y fecha (AAAA-MM-DD) |
| Crear cita | Agenda una cita. | Servicio, proveedor, fecha y hora de inicio (AAAA-MM-DD HH:MM), nombre, teléfono y correo del cliente, notas (opcional) |
| Listar citas del cliente | Devuelve las citas de un cliente. | Correo o teléfono del cliente |
| Reprogramar cita | Cambia la fecha y hora de una cita. | ID de la cita y nueva fecha y hora |
| Cancelar cita | Cancela una cita. | ID de la cita |
Captura pendiente: Paso Bookflow con la operación Crear cita
img/herramientas-bookflow.pngEvita dobles reservasBookflow no rechaza por sí solo un horario ya ocupado. Llama primero a Verificar disponibilidad y usa el horario devuelto al crear o reprogramar la cita.
Al crear una cita, Makia busca al cliente por teléfono o correo y, si no existe, lo crea con el nombre que indiques.
CRM
Trabaja con los contactos, empresas y negocios del CRM de Makia.
| Operación | Qué hace |
|---|---|
| Listar contactos / empresas / negocios | Busca registros (por nombre o correo; para negocios, también por etapa) con un límite de resultados. |
| Crear contacto | Nombre, apellido, correo, teléfono, puesto, empresa y estado (Lead, Cliente o Inactivo; por defecto Activo). El estado solo se aplica si el contacto es nuevo. |
| Crear empresa | Nombre, industria, sitio web, ciudad y país. |
| Crear negocio | Título, valor, moneda, etapa (por defecto la primera del embudo), contacto o empresa relacionados y fecha de cierre esperada. |
| Mover etapa del negocio | Cambia un negocio a otra etapa del embudo, indicando el negocio (por título o elegido de la lista) y la etapa de destino. |
| Crear tarea | Título, descripción, prioridad (baja, media, alta, urgente) y fecha de vencimiento. |
| Agregar nota | Asocia una nota (tipo nota, llamada, reunión o correo) a un contacto o negocio. |
| Obtener analíticas del CRM | Devuelve un resumen del embudo. |
Captura pendiente: Paso CRM Agent con la operación Crear contacto
img/herramientas-crm.pngDatos que vienen de la IAUn patrón habitual es: un paso Preguntar al agente con salida estructurada extrae nombre, correo y teléfono del mensaje, y luego el paso CRM crea el contacto usando esas variables. Si un dato no está, el campo queda vacío en lugar de inventarse.
Variables sin valorSi un campo del CRM usa una variable que ningún paso anterior produce (por ejemplo un título de negocio vacío), la ejecución falla en lugar de guardar un registro con el texto
{variable}. Solo los vínculos opcionales (contacto, empresa, negocio, etapa) se aceptan sin valor.Chatbot (External Chatbot)
Consulta y gestiona tus chatbots de IA desde un agente.
| Operación | Qué hace |
|---|---|
| Listar chatbots | Devuelve tus chatbots (opción de solo activos y máximo de resultados, de 1 a 50). |
| Obtener analíticas del chatbot | Estadísticas; puedes limitarlas a un chatbot. |
| Listar conversaciones del chatbot | Las conversaciones, filtrables por chatbot, canal (por ejemplo whatsapp, telegram, livechat) y estado del ticket (nuevo o cerrado). |
| Obtener conversación / conversaciones del chatbot | Trae los mensajes de una conversación, o de las más recientes (por defecto 5, máximo 50), filtrando por remitente (usuario, administración o todos). |
| Cerrar ticket del chatbot | Marca el ticket de una conversación como cerrado. |
| Generar respuesta (con la personalidad propia de un chatbot) | Redacta una respuesta usando la personalidad, el entrenamiento y el modelo de IA del chatbot que elijas. |
En Generar respuesta, las llamadas repetidas de la misma conversación (mismo {sender_id}) reutilizan la misma conversación del chatbot, por lo que mantiene memoria entre mensajes igual que un chat real.
Marketing (Marketing Bot)
| Operación | Qué hace |
|---|---|
| Listar campañas de marketing | Filtra por tipo de canal (Telegram o WhatsApp) y estado (pendiente, programada, en curso, publicada, fallida). |
| Obtener estadísticas de marketing | Para un periodo: hoy, últimos 7 días o últimos 30 días. |
| Listar conversaciones de marketing | Filtra por canal (Telegram o WhatsApp). |
| Crear campaña de marketing | Nombre de la campaña, canal y mensaje (por ejemplo {ai_response} para usar la respuesta de la IA). Con Programar para la fecha queda fijada; en blanco se guarda como pendiente. |
| Programar campaña de marketing | Programa una campaña existente (ID de la campaña); en blanco se programa de inmediato. |
Redes sociales (Social Media Agent)
| Operación | Qué hace |
|---|---|
| Listar agentes de redes sociales | Devuelve tus agentes de redes sociales. |
| Listar publicaciones sociales | Filtra por agente y estado (borrador, pendiente de aprobación, aprobada, programada, publicada, fallida). |
| Crear publicación social | Agente, tipo (texto, imagen única, carrusel, video) y contenido. En blanco en la fecha se guarda como borrador. |
| Obtener analítica de publicaciones | Con un número de días de historial a incluir. |
| Aprobar publicación social | Aprueba una publicación (debe estar pendiente de aprobación). |
| Crear agente de redes sociales | Nombre, cuentas conectadas, tono (profesional, casual, humorístico, inspirador, educativo, promocional), idioma, tipo de plan (diario, semanal, mensual), publicaciones por día, cantidad de hashtags, URL del sitio y descripción de la marca. |
Captura pendiente: Paso Social Media Agent con la operación Crear publicación social
img/herramientas-redes-sociales.pngEjemplo: del mensaje a la cita
- Disparador: Mensaje del canal (tu chatbot de WhatsApp).
- Preguntar al agente: extrae con salida estructurada el servicio, la fecha y el nombre del cliente.
- Bookflow > Verificar disponibilidad: consulta los horarios libres de esa fecha.
- Preguntar al agente: redacta la propuesta de horarios con la respuesta del paso anterior.
- Enviar mensaje: responde en la misma conversación con la propuesta.
Solución de problemas
| Problema | Qué hacer |
|---|---|
| El paso no aparece en el catálogo | La función no está activa en tu cuenta; consulta con tu administrador. |
| «Bookflow aún no está conectado» | Usa el enlace «Conéctalo aquí» del paso. |
| La cita se crea en un horario ocupado | Agrega siempre Verificar disponibilidad antes de Crear cita. |
| La ejecución falla por una variable sin resolver | El paso que produce el dato debe estar antes y su variable debe coincidir con la que usas. |