Ir al contenido

Herramientas

Las 137 herramientas del Conector MCP, por dominio. Las marcadas ✍️ Escritura exigen credencial con acceso completo (full); las que cambian datos del tenant piden además confirmación: sin confirmar=true devuelven una vista previa y no guardan nada. El resto son de lectura y funcionan con read. Todo opera solo sobre tu tenant.

Lo que no se hace por MCP, a propósito: cargar credenciales (tokens, claves de correo, OAuth), instalar o activar integraciones, y crear o invitar usuarios. Eso se hace desde el panel.

Edita el borrador del Prompt Builder (merge parcial: solo los campos que envías). No afecta al bot hasta publicar_config_bot.

ParámetroTipoDescripción
cambiosobjeto{ variable: valor } con los campos del wizard a cambiar
esperado_actualizadotexto (opcional)control de concurrencia optimista
// entrada
{ "cambios": { "tone": "cercano", "greeting": "¡Hola! Bienvenido a La Espiga 🥖" } }
// salida → confirma qué quedó en el borrador (no publicado)
{ "estado": "borrador_actualizado", "campos": ["tone", "greeting"] }

Crea una entrada de KB. Inmediata (no requiere publicar).

ParámetroTipoDescripción
preguntatextola consulta (FAQ) o la situación (protocolo)
respuestatextola respuesta o la regla imperativa
tipo"faq" | "protocol"por defecto faq — ver FAQ vs Protocolo
{ "pregunta": "¿Hacen envíos?", "respuesta": "Sí, a todo el país en 48h.", "tipo": "faq" }

Encola un mensaje outbound a un lead (respeta pacing anti-ban y ventana de 24h).

ParámetroTipoDescripción
lead_idtextoel lead destinatario
cuandotextomomento del envío (ej. fecha/hora)
mensajetextoel contenido
confirmarbooltrue para aplicar (sin él, devuelve preview)

Crea un prospecto de venta saliente: una ficha de contacto + un lead en estado NEW para hacerle seguimiento en el funnel, en un solo paso. Pensado para prospección en frío (sin conversación previa). No le envía ningún mensaje al negocio — solo lo carga para gestionarlo. Deduplica por teléfono/email: si el contacto ya existe y tiene un lead abierto, no lo duplica (devuelve el existente).

ParámetroTipoDescripción
nombretextonombre del negocio o persona
telefonotexto (opcional)teléfono o WhatsApp (se normaliza)
emailtexto (opcional)email
webtexto (opcional)sitio web
instagramtexto (opcional)usuario o URL de Instagram
direcciontexto (opcional)dirección física
senal_fittexto (opcional)evidencia de por qué encaja como cliente
scorenúmero (opcional)fit 0-100 (qualification_score)
verticaltexto (opcional)rubro (ej. dentales)
zonatexto (opcional)comuna o ciudad
confirmarbooltrue para crear (sin él, devuelve preview)

Requiere al menos telefono o email. Los datos de contacto (web/instagram/dirección) quedan en la ficha del contacto; la señal de fit y el score, en el lead.

// entrada
{ "nombre": "Clínica Dental Sonríe", "telefono": "+56 9 5781 6940",
"web": "https://clinicasonrie.cl", "senal_fit": "agenda 100% por WhatsApp, sin bot",
"score": 80, "vertical": "dentales", "zona": "Providencia", "confirmar": true }
// salida → contacto + lead NEW creados (o el existente si ya estaba)
{ "ejecutado": true, "creado": true, "reusado": false,
"contacto": { "id": "…", "nombre": "Clínica Dental Sonríe", "telefono": "56957816940" },
"lead": { "id": "…", "estado": "NEW", "etapa": "NEW", "score": 80 } }

¿Cargas prospectos desde un script o sistema, sin un cliente MCP? Puedes hacer lo mismo con una llamada HTTP normal: ver Crear prospectos por REST.

HerramientaQué hace
estado_conexionVerifica la credencial y devuelve tu tenant.Lectura
resumen_negocioResumen de actividad (leads, conversaciones, métricas) de N días.Lectura
metricas_agenteNúmeros duros: tasa de handoff, preguntas sin responder, leads por etapa, conversión, mensajes promedio.Lectura
estado_agenteChecklist de preparación del bot (rol, KB, canal) + addons activos y avisos de coherencia (ej. objetivo agendar sin agenda conectada, addon en modo prueba, agenda activa sin objetivo de venta).Lectura
ver_addonsTus integraciones/addons y su estado: si están activos y su configuración con los secretos ocultos (tokens/keys se muestran como *** si están cargados).Lectura
configurar_addonCambia ajustes operativos de un addon ya instalado (por ejemplo, en una agenda: máximo de horarios a ofrecer, recordatorios, modo prueba). Sin cambios devuelve los campos editables con su valor actual.✍️ Escritura
listar_usuariosMiembros del equipo (id, email, rol) — usa el id para asignar leads.Lectura
uso_del_planConsumo del plan del tenant.Lectura
listar_leadsLista leads, filtrable por etapa del funnel.Lectura
conversaciones_atencionConversaciones que requieren atención humana (handoffs).Lectura
listar_conversacionesTodas las conversaciones recientes (con nº de mensajes), para tomar una muestra representativa.Lectura
leer_conversacionHistorial de mensajes de una conversación.Lectura
limpiar_conversaciones_apiBorra las conversaciones de prueba del negocio (las del Canal API, identidad api:<session_id>, o las del chat de prueba del panel). No toca WhatsApp ni webchat. Con incluir_leads=true borra también los leads y contactos de prueba. Irreversible: revisa la vista previa antes de confirmar.✍️ Escritura
HerramientaQué hace
ver_prompt_efectivoEl system prompt final que usa el bot (rol + Prompt Builder + capas + bloques v2), no el borrador del wizard.Lectura
probar_botManda un mensaje de prueba efímero y devuelve la respuesta real del bot (mismo pipeline que prod) sin crear conversación/lead/memoria ni enviar nada. Consume cuota de LLM → tope diario. Devuelve un session_id: vuelve a pasarlo para continuar el mismo hilo multi-turno (máx 20 turnos, 30 min) y reproducir bugs que solo aparecen a varios turnos.✍️ Escritura

Una entrevista corta en vez de un formulario técnico: el asistente hace seis preguntas simples y con las respuestas arma la configuración mínima.

HerramientaQué hace
guia_configuracionPunto de partida: devuelve las seis preguntas de la entrevista inicial (con sus opciones) y los datos básicos a pedir.Lectura
recomendar_configuracionCon las respuestas de la entrevista, devuelve la configuración mínima recomendada lista para aplicar: campos del bot, textos a redactar con su largo máximo, integración de agenda, pocos protocolos y directivas, guion de prueba y pasos en orden. No aplica nada.Lectura
guion_de_pruebaConversaciones de prueba para dar una configuración por buena: qué mensajes enviar y qué se espera en cada escenario.Lectura
auditar_configuracionQué sobra en la configuración: reglas repetidas, reglas que duplican lo que ya hace una integración, frases demasiado amplias, textos enormes pegados en el prompt y reglas fuera de los límites. No usa IA ni cambia nada.Lectura

Para saber cómo está funcionando el agente y por qué, antes de tocar la configuración.

HerramientaQué hace
salud_agenteSalud operativa de los últimos 7 días: mensajes y respuestas, tasa de derivación a personas, leads estancados y preguntas sin responder, con semáforo y avisos.Lectura
diagnosticar_respuestaExplica por qué el bot respondió lo que respondió en un mensaje concreto: filtros que modificaron la respuesta, herramientas llamadas, conocimiento usado, reemplazos aplicados, modelo y latencia. Recibe el mensaje_id del bot (lo entrega leer_conversacion).Lectura
presupuesto_promptCuánto peso de instrucciones carga el agente (directivas, memorias, protocolos), con nivel ok / alto / crítico. Sobre el nivel alto las instrucciones compiten y la obediencia baja: conviene depurar antes que agregar.Lectura
verificar_contradiccionRevisa en seco si una instrucción nueva contradice directivas o memorias activas, antes de guardarla. Consume una llamada de IA.✍️ Escritura
historial_cambios_configHistorial de cambios de configuración (quién, qué, cuándo): directivas, memorias, conocimiento, config del bot, workflows, campañas, horarios, catálogo.Lectura
HerramientaQué hace
ver_definicion_prompt_builderLos 9 pasos del wizard, sus campos y opciones válidas.Lectura
listar_roles_agenteRoles (cargos) válidos para el tenant.Lectura
ver_config_botConfig publicada hoy + si hay borrador pendiente.Lectura
actualizar_config_botEdita el borrador (merge parcial). No afecta al bot aún.✍️ Escritura
publicar_config_botAplica el borrador — regenera el prompt (destructivo).✍️ Escritura
HerramientaQué hace
listar_conocimientoLista FAQs y protocolos, con filtro y búsqueda.Lectura
cargar_conocimientoCrea una FAQ (faq) o un protocolo (protocol).✍️ Escritura
editar_conocimientoEdita una entrada existente.✍️ Escritura
activar_desactivar_conocimientoActiva o pausa una entrada.✍️ Escritura
borrar_conocimientoElimina una entrada.✍️ Escritura
preguntas_sin_responderPreguntas de usuarios que el bot no supo responder.Lectura
responder_pregunta_pendienteResponde una pendiente y la agrega al KB.✍️ Escritura
descartar_pregunta_pendienteDescarta una pendiente.✍️ Escritura
HerramientaQué hace
listar_fuentes_conocimientoFuentes conectadas (Google Sheets, documentos).Lectura
conectar_google_sheetConecta una hoja de Google como fuente de KB.✍️ Escritura
sincronizar_conocimientoRe-sincroniza una fuente.✍️ Escritura
desconectar_fuenteDesconecta una fuente (quita sus entradas).✍️ Escritura
agregar_documento_conocimientoCarga un lote de entradas como un documento.✍️ Escritura
agregar_web_al_conocimientoDescarga una web pública y devuelve su texto limpio para estructurarlo en FAQs (la carga real se hace con agregar_documento_conocimiento). Solo URLs públicas.✍️ Escritura
HerramientaQué hace
listar_reemplazos · crear_reemplazo · borrar_reemplazoReemplazos de palabras/patrones en la salida del bot.Lectura / ✍️ / ✍️
listar_frases_prohibidas · crear_frase_prohibida · borrar_frase_prohibidaFrases que el bot nunca debe decir.Lectura / ✍️ / ✍️
listar_directivas_estilo · crear_directiva_estilo · borrar_directiva_estiloDirectivas de estilo (positivas/negativas).Lectura / ✍️ / ✍️
HerramientaQué hace
listar_memoriaMemoria aprendida, filtrable por estado/fuente.Lectura
aprobar_memoria · rechazar_memoriaAprueba o rechaza un ítem de memoria.✍️ Escritura
editar_memoria · borrar_memoriaEdita o elimina un ítem.✍️ Escritura
aprobar_sugerencia_kb · rechazar_sugerencia_kbGestiona sugerencias de KB derivadas de la memoria.✍️ Escritura
HerramientaQué hace
crear_prospectoCrea un prospecto saliente: contacto + lead NEW (dedup por teléfono/email). No envía mensajes. Ficha detallada arriba.✍️ Escritura
crear_prospectosCrea varios prospectos de una (bulk, máx 50). Mismos campos que crear_prospecto.✍️ Escritura
ver_leadDetalle de un lead.Lectura
ver_timeline_leadHistorial de eventos del lead (etapas, notas, asignaciones).Lectura
etiquetar_leadAgrega/quita etiquetas.✍️ Escritura
agregar_nota_leadAgrega una nota interna.✍️ Escritura
cambiar_etapa_leadMueve el lead en el funnel.✍️ Escritura
asignar_leadAsigna el lead a un usuario del equipo (o lo desasigna).✍️ Escritura
editar_leadEdita datos de venta: valor del deal, probabilidad, score, próxima acción, nombre/email/tel.✍️ Escritura
buscar_contactos · ver_contactoBusca y ve contactos.Lectura
etiquetar_contacto · agregar_nota_contactoEtiqueta un contacto o le agrega una nota.✍️ Escritura
HerramientaQué hace
listar_seguimientosSeguimientos programados.Lectura
programar_seguimientoPrograma un mensaje outbound a un lead (a futuro).✍️ Escritura
enviar_mensajeEnvía un mensaje ahora a un contacto — por session_id (Canal API) o telefono (WhatsApp, respeta anti-ban: opt-out, ventana 24h, tope y pacing). Pide confirmar=true.✍️ Escritura
cancelar_seguimientoCancela un seguimiento.✍️ Escritura
configurar_tope_enviosTope diario de mensajes proactivos por WhatsApp (recordatorios, seguimientos y campañas; las respuestas a quien escribe no cuentan). Sin parámetros muestra el tope vigente, lo enviado hoy y el máximo permitido. 0 vuelve al valor por defecto.✍️ Escritura

Una campaña lleva una promoción a un segmento de la base. Hay dos modos: pasiva (passive), donde el bot menciona la promoción dentro de conversaciones que ya están activas, y activa (active), donde la campaña escribe primero. Una campaña activa nunca envía sin que una persona apruebe antes la muestra de mensajes.

HerramientaQué hace
listar_campanasCampañas del tenant, filtrables por status (draft, awaiting_approval, active, paused, paused_auto, completed) y modo.Lectura
crear_campanaCrea una campaña en borrador (no envía nada). Define nombre, promoción, modo y segmento (funnel_stages, tags, y para activas: tope diario y rango de inactividad del lead).✍️ Escritura
editar_campanaEdita nombre, promoción, segmento o configuración. No cambia el estado.✍️ Escritura
iniciar_campanaPrepara una campaña activa: congela el segmento y genera la muestra de mensajes. No envía: queda en awaiting_approval. Si ya estaba ahí, regenera la muestra.✍️ Escritura
ver_muestra_campanaLas variaciones generadas y a cuántos clientes les llegarían.Lectura
aprobar_campanaAprueba la muestra: empieza a enviar mensajes reales, en horario hábil y con topes.✍️ Escritura
pausar_campanaFreno de mano: detiene los envíos de inmediato, sin confirmación. Los pendientes quedan en cola.✍️ Escritura
reanudar_campanaReanuda una campaña pausada. Si se pausó sola (paused_auto, por muchas bajas o fallos), revisa el motivo antes.✍️ Escritura
metricas_campanaExposición y conversión; en activas, el detalle del envío (pendientes, enviados, respuestas, bajas).Lectura
borrar_campanaBorra una campaña y su historial. Irreversible. Una campaña que está enviando debe pausarse antes.✍️ Escritura
HerramientaQué hace
listar_gruposGrupos donde está el número del tenant, con su estado (muted silenciado, active habilitado, left ya no está) y su modo de respuesta. Con rescanear=true pide la lista completa al canal.Lectura
configurar_grupoActiva o silencia un grupo y define cómo responde el agente: mention_only (solo a menciones o citas; es el valor por defecto), all (a todo) o never (observa, nunca responde).✍️ Escritura

Un grupo nuevo nace silenciado: el agente no responde ahí hasta que lo actives.

Un ticket es una solicitud con número, estado, plazo y persona responsable. Puede nacer de una conversación o de un correo que llega a la casilla del negocio. Requiere que el negocio tenga el módulo de tickets habilitado.

HerramientaQué hace
listar_ticketsTickets del tenant, filtrable por estado.Lectura
ver_ticketDetalle de un ticket: estado, plazo, cliente, datos de la solicitud e historial (notas y cambios, con autor y fecha). Acepta el número (ej. SOP-00001) o el id.Lectura
actualizar_ticketCambia el estado, agrega una nota interna, asigna a una persona del equipo, cambia el vencimiento o cierra el ticket.✍️ Escritura
metricas_soporteNúmeros del período (por defecto 30 días, máximo 90): tickets creados, distribución por estado, abiertos con plazo vencido y conversaciones que no terminaron en ticket.Lectura
informe_ticketsRendimiento por persona asignada: recibidos, respondidos, sin respuesta, abiertos, vencidos, resueltos y cerrados, y tiempo hasta la primera respuesta. Fechas AAAA-MM-DD; máximo un año.Lectura

Estados que acepta actualizar_ticket: NUEVO, ABIERTO, PENDIENTE, EN_ESPERA, RESUELTO. Cerrar exige dos campos juntos: resultado (realizada, rechazada, pedido_del_solicitante, duplicada u otro) y nota con el motivo. rechazada deja el ticket en RECHAZADO; los demás, en CERRADO. Al cerrar se le avisa al solicitante por correo si tiene uno registrado.

// cerrar un ticket
{ "ticket": "SOP-00042", "resultado": "realizada",
"nota": "Se despachó el repuesto el 12-oct.", "confirmar": true }
HerramientaQué hace
estado_modulo_ticketsSi el módulo está habilitado, los ajustes vigentes (prefijo del número, plazos), el formato de solicitud y qué hace la casilla con cada correo nuevo.Lectura
configurar_modulo_ticketsAjustes del módulo: prefijo (2 a 6 letras), plazo_horas, solo_horas_habiles, plazo_horas_por_etapa, cierre_automatico_horas, enviar_acuse, avisar_al_responsable, entre otros.✍️ Escritura
configurar_casilla_correoQué pasa con cada correo nuevo: agente (lo responde el agente), persona (queda en el inbox para el equipo) o ticket (cada correo que inicia un hilo crea un ticket).✍️ Escritura
configurar_formato_solicitudDefine qué datos trae cada solicitud por correo y cuáles son obligatorios. Con el formato activo, el agente lee el correo, guarda cada dato y pide los que falten; el ticket se genera cuando están todos. Hasta 25 datos.✍️ Escritura

Conectar la casilla de correo y cargar sus credenciales se hace desde el panel.

Las sucursales reparten el trabajo: cada una tiene una persona asignada, un reemplazo y una jefatura. Las usan los tickets y la derivación a ventas.

HerramientaQué hace
listar_sucursalesSucursales del negocio: persona asignada, reemplazo, jefatura, zonas que cubre y correo de ventas.Lectura
guardar_sucursalCrea una sucursal (con nombre) o cambia una existente (con sucursal = id, código o nombre). persona_ausente=true envía las solicitudes al reemplazo.✍️ Escritura
borrar_sucursalBorra una sucursal. Los tickets ya asignados no cambian.✍️ Escritura

Cuando una conversación termina en una solicitud comercial, o el agente la deriva a una persona, Overtaker envía un correo al ejecutivo de la sucursal que atiende la localidad del cliente, con sus datos de contacto. Si la localidad no corresponde a ninguna sucursal, el aviso va a un correo de respaldo. El agente sigue conversando igual que siempre: esto solo agrega el aviso. Requiere que el negocio tenga la función habilitada.

HerramientaQué hace
estado_derivacion_ventasSi la función está habilitada y activa, los ajustes vigentes y el resumen de 30 días (a sucursal, a respaldo, en cola, sin destinatario, con error).Lectura
configurar_derivacion_ventasCambia activa, correo_de_respaldo, datos_de_ubicacion (nombres de los datos capturados donde viene la ubicación, ej. ["comuna", "ciudad"]) y prefijo_del_asunto.✍️ Escritura
listar_derivacionesSolicitudes derivadas, de la más nueva a la más antigua: sucursal, correo de destino, regla aplicada y resultado del envío. solo_por_revisar=true trae las que fueron a respaldo, quedaron sin destinatario o fallaron.Lectura
reintentar_derivacionVuelve a poner en cola una derivación que falló o quedó sin destinatario. Una ya enviada no se reenvía.✍️ Escritura

La tabla que dice qué sucursal atiende cada localidad. Cada negocio tiene la suya y nace con el catálogo de su país (en Chile: región, provincia y comuna).

HerramientaQué hace
listar_localidadesSin filtros, el resumen por región y provincia (cuántas localidades hay y cuántas tienen sucursal). Filtros: region, provincia, buscar, sin_sucursal, sucursal.Lectura
asignar_localidadesAsigna a una sucursal todas las localidades de una region, de una provincia o de una lista. sucursal: "ninguna" las deja sin sucursal.✍️ Escritura
guardar_localidadAgrega una localidad que no está en el catálogo (un sector, un pueblo) o corrige una existente.✍️ Escritura
borrar_localidadQuita una localidad del territorio del negocio.✍️ Escritura
restaurar_localidadesVuelve a traer del catálogo las localidades que falten. No toca las existentes ni sus sucursales.✍️ Escritura

Para decidir la sucursal de un cliente se busca primero su localidad; si no tiene sucursal asignada, se usa la de su provincia y luego la de su región.

// toda una región a una sucursal
{ "sucursal": "Temuco", "region": "La Araucanía", "confirmar": true }
HerramientaQué hace
listar_encuestas · ver_encuestaEncuestas del tenant.Lectura
listar_visitas · ver_visitaVisitas (respuestas), filtrable por estado/sucursal.Lectura
crear_encuestaCrea una plantilla de encuesta COMPLETA en un paso (template + secciones).✍️ Escritura
asignar_visitaAsigna una visita a un número de teléfono.✍️ Escritura

Lo que el negocio ofrece y agenda. Un servicio es lo que se reserva (ej. “Corte”); un recurso es quién/qué lo presta (profesional, box, sala). Se vinculan N–N.

HerramientaQué hace
ver_catalogoMuestra servicios (nombre, duración, precio), recursos y los vínculos entre ellos.Lectura
crear_servicioCrea un servicio del catálogo.✍️ Escritura
editar_servicioEdita un servicio existente (solo los campos que pases).✍️ Escritura
crear_recursoCrea un recurso (profesional, box, sala…) que presta servicios.✍️ Escritura
vincular_servicio_recursoVincula un servicio con un recurso que lo presta (necesario para que ese recurso pueda agendarse).✍️ Escritura

Define cuándo puede reservarse cada recurso. Requiere tener catálogo con al menos un servicio vinculado a un recurso.

HerramientaQué hace
ver_agendaDisponibilidad del tenant: reglas de horario (por día) y excepciones (bloqueos).Lectura
ver_reservasLista las reservas (con servicio, recurso y contacto), filtrable.Lectura
crear_regla_horarioCrea una franja disponible para un recurso (dia_semana 0=lunes … 6=domingo, horas HH:MM).✍️ Escritura
borrar_regla_horarioElimina una regla de horario (ids con ver_agenda).✍️ Escritura
crear_excepcionBloquea una fecha puntual para un recurso (feriado, vacaciones, cierre).✍️ Escritura
borrar_excepcionElimina un bloqueo de fecha.✍️ Escritura

Automatizaciones evento → condición → acciones: cuando pasa algo (un lead se escala, se crea un ticket, vence un recordatorio…), el motor ejecuta los pasos que definiste (enviar un mensaje, mover de etapa, etiquetar, avisar al equipo…). Modelo completo, paleta de triggers/acciones y ejemplos en Workflows.

HerramientaQué hace
listar_workflowsLista tus workflows y su estado (borrador / activo / pausado).Lectura
ver_instancias_workflowEjecuciones (instancias) de un workflow: activas, completadas, con error.Lectura
crear_workflowCrea un workflow estructurado: trigger_type + pasos (action / wait / branch). Queda en borrador.✍️ Escritura
crear_workflow_desde_textoCrea un workflow describiéndolo en lenguaje natural (ej. “cuando un lead se escala, avisa al equipo y muévelo a SALES_READY”); lo compila a pasos. Queda en borrador.✍️ Escritura
activar_workflowActiva un workflow en borrador o pausado — recién ahí empieza a correr ante sus eventos.✍️ Escritura
editar_pasos_workflowReemplaza los pasos de un workflow existente. Las ejecuciones en curso terminan con los pasos anteriores; las nuevas usan los nuevos.✍️ Escritura
pausar_workflowPausa un workflow activo: deja de tomar casos nuevos; las ejecuciones en curso terminan su camino.✍️ Escritura
borrar_workflowBorra un workflow, sus pasos y sus ejecuciones, incluidas las que están corriendo. Irreversible.✍️ Escritura
ver_horario_laboralHorario laboral del tenant, que define cuándo salen los mensajes de los workflows. Fuera de horario se difieren al próximo inicio hábil.Lectura
configurar_horario_laboralDefine el horario por día (0 = lunes … 6 = domingo, horas HH:MM). Con activo: false no hay restricción.✍️ Escritura