Dos cosas distintas se llaman «herramienta» en esta documentación. Las de
esta página son las del agente: las acciones que ejecuta mientras habla con
un cliente por WhatsApp. Las de la
Referencia de herramientas son las del puente: lo que
Claude, ChatGPT o Codex pueden hacer sobre tu negocio si los conectas. Son
listas separadas y no se mezclan.
Tres cosas que conviene saber antes
1. No hay nada que «encender». Las herramientas están disponibles para todos los agentes desde el primer día. Las excepciones son las que dependen de algo que tú tienes que preparar: un catálogo con productos, una sede con dirección, una app activa. La tabla de abajo lo dice herramienta por herramienta. 2. Hay dos familias, y se piden de forma distinta. Unas se escriben en el manual, en el punto exacto del guion donde deben ocurrir («aquí registra la venta», «si no responde, recuérdaselo mañana»). Otras el agente las usa solo cuando la conversación lo pide —buscar un precio, mandar la ubicación, consultar la agenda— y no se nombran en el manual: si las escribes, el Doctor te lo marcará. 3. Puedes ver cada vez que corrió una. En el hilo del chat, cada acción deja un chip ⚡ con su nombre y su resultado, y en Resultados hay un número que las resume: Éxito de herramientas. Más abajo, en Cómo saber si funcionó.Todas las herramientas, de un vistazo
La nota de voz está apagada. Existe una herramienta que convierte texto en
audio con la voz del agente, pero hoy está desactivada para todos los negocios.
Si un manual antiguo pide «responde con una nota de voz», el agente responderá
con texto.
Cómo se escriben en el manual
Una herramienta del manual se pide con una frase exacta, en la línea del guion donde debe ocurrir. No la teclees: en el editor del Manual, escribe@, elige el
grupo Herramientas y pulsa la que quieras. Si la herramienta lleva datos, se
abre un formulario de una línea que te los pide, y la frase queda escrita bien
y teñida como una mención: un clic la cambia, ⌫ la borra.
La frase que queda en el texto tiene siempre esta forma:
- Recordatorio, Programar una acción y Avisar a un tercero exigen el dato. Sin él, el botón Insertar se queda apagado: una frase con el hueco vacío no serviría de nada.
- Activar Modo Manual y Consultar conocimiento van sin datos. No se les dice a quién avisar ni qué: el traspaso avisa a tu equipo por Slack, si lo tienes conectado, y el agente sabe solo qué consultar.
- Los datos van dentro de la frase, no al lado. Si el Doctor te dice «los argumentos están escritos como prosa al lado de la herramienta», es que alguien tecleó a mano el plazo o el número fuera de las comillas; acepta el arreglo que te propone.
Las que se escriben en el manual
Avanzar de capítulo
Es la herramienta más importante del producto y por eso tiene su propia sección en la guía del manual: Hacer que el embudo avance. En corto: se inserta con@ → Capítulos, la frase literal es
Llama a la herramienta advance_chapter con el capítulo 3, y escribir «pasa al
siguiente» en prosa no mueve nada.
Registrar una venta / conversión
En el manual se ve como «Registrar Conversion Tool», y su dato es qué se registra:venta, cita, lead calificado o servicio.
- Una venta lleva siempre monto. El agente lo toma del catálogo (precio por cantidad, más el envío si lo cobras). Es lo que vale el pedido, no lo que ya se cobró: una venta contra entrega sin adelanto se registra igual, por el precio del producto.
- En una venta de productos, abre el pedido. Con la app Órdenes activa, esa misma llamada crea el pedido de la conversación con sus líneas, el plan de pago acordado (todo por adelantado, contra entrega, o adelanto y saldo), el costo de envío y la dirección. Si el chat ya tenía un pedido abierto, lo reemplaza entero con las líneas finales.
- No cobra nada. El pago se confirma cuando tu equipo verifica el comprobante. Ver Pedidos y métricas.
- Te avisa. Si en Ajustes del agente elegiste números para Ventas, cada venta registrada llega al instante por WhatsApp con un 💰, con el producto, el total y los datos capturados del cliente.
Activar Modo Manual
En el manual se ve como «Activar Modo Manual Tool» y se escribe sin datos. Al correr, apaga el piloto automático de esa conversación: el agente deja de responder y la conversación queda esperando a una persona —igual que si tú mismo apagaras el interruptor desde la bandeja, como cuenta Tomar tú la conversación. El agente la ejecuta en tres situaciones:
Cada traspaso avisa a tu equipo por el canal de traspasos, si tienes Slack
conectado, y queda en el hilo como un chip ⚡ Activar Modo Manual.
Guardar un dato · Leer un dato del cliente
En el manual se ven como «Actualizar Datos Tool» y «Leer Datos Tool»; el dato es qué guardar o qué leer:Recordatorio / seguimiento
En el manual se ve como «Recordatorio Tool» y su dato es el plazo y qué retomar:- El texto es una nota para el agente, no un mensaje para el cliente. Al vencer el plazo, el agente redacta el mensaje a partir de esa nota, con todo el contexto del chat. Y nunca le dice al cliente que está «creando un recordatorio».
- Solo vive uno por conversación. Si el agente programa otro, el anterior se cancela. Por eso la cadencia de seguimientos se encadena —cada seguimiento programa el siguiente— en vez de apilarse.
- Si no pones plazo, son 24 horas.
- Puede caducar si el cliente escribe antes. Para un «reenganche» a quien no contesta, tiene sentido que se cancele solo si el cliente responde; para un «llámame el lunes», no. El agente lo decide por el sentido del texto.
- Puede llevar archivos. Si dentro del texto va un marcador
###SEND_FILES: promo###, ese archivo se adjunta solo al vencer, no ahora. - Si la conversación pasa a modo manual, lo programado se cancela al vencer en vez de salir: una persona está atendiendo y el agente no se cruza.
Programar una acción
En el manual se ve como «Programar Accion Tool» y su dato es el plazo y la tarea:
Si la tarea cambia de capítulo, puede además decir desde qué PASO de ese
capítulo continuar. Y al igual que el recordatorio, el agente nunca le anuncia
al cliente que está programando algo.
Avisar a un tercero
En el manual se ve como «Enviar Mensaje A Tercero Tool». El formulario del menú@ te pide a qué número y qué avisarle, y arma la frase:
Consultar conocimiento
En el manual se ve como «Memoria A Largo Plazo Tool» y se escribe sin datos. Busca en los archivos que el agente estudió: los que en la Librería tienen el permiso Memoria del agente (políticas, garantías, tiempos de envío, fichas técnicas). Ver La Librería de archivos. No hace falta escribirla para que funcione: el agente la usa solo cada vez que el cliente pregunta algo que no está en el capítulo ni en sus datos. Y si lo que encuentra no responde a la pregunta, no lo usa: le dice al cliente que se lo confirma y sigue el guion. Escribirla en un capítulo sirve para forzarla en un punto concreto («antes de responder sobre garantías, consulta»).Enviar un archivo
No es una frase sino un marcador con el apodo del archivo, y tiene su propia sección: Mandar un archivo desde el guion.Las que el agente usa solo
Estas no se escriben en el manual. El agente las tiene a mano y decide cuándo llamarlas según lo que pregunte el cliente. Si las nombras en un capítulo, el Doctor te lo marca; lo que sí puedes hacer es prepararles lo que necesitan.Buscar en el catálogo
Cada vez que el cliente pregunta por un producto o un precio, el agente busca en tu catálogo y responde con el precio exacto; si el cliente dijo cuántas unidades quiere, recibe el total ya calculado, con precio por cantidad y promociones. Tiene prohibido inventar precios y calcular totales por su cuenta. Solo existe si tu negocio tiene productos activos en el catálogo: sin catálogo, el agente ni la ve. La misma búsqueda le da el identificador de cada variante, que es lo que Registrar una venta usa para ligar la venta al producto correcto.Enviar la ubicación
Cuando el cliente pregunta dónde están o cómo llegar, el agente manda la sede como pin de mapa de WhatsApp. Las direcciones y coordenadas salen de lo que tú guardaste en Librería → Ubicaciones; el agente nunca escribe una dirección por su cuenta, solo elige cuál sede mandar si tienes varias («la de Surco», «el almacén»). Sin ubicaciones guardadas, no la tiene.Consultar stock
Antes de prometer unidades, cantidades grandes o plazos de entrega, el agente consulta cuánto hay de verdad en el inventario, por variante, y no ofrece lo que no hay. No la usa para dar precios: eso es del catálogo. Es la única con tres condiciones: la app Inventario activa en tu negocio, el interruptor «Consultar stock» encendido en los Ajustes de ese agente (sección Herramientas, que solo aparece con Inventario activo) y un catálogo con productos. Falla una y el agente no la ve.Citas: ver la agenda, reservar, mover y cancelar
Con la app Calendario activa, el agente recibe cuatro herramientas de golpe: consultar disponibilidad (los servicios agendables y los horarios libres reales), reservar, reprogramar y cancelar la cita del cliente. Tiene prohibido proponer un horario sin consultar antes, y el precio, la duración y la seña salen de tus servicios, no de su cabeza. Si el servicio lleva seña, la cobra por comprobante y tu equipo la confirma. Ver Las apps de DarkFunnels.Avisar al equipo por Slack
Si conectaste Slack en Personalizar → Canales, el agente publica en el canal que elegiste cuando registra una venta, detecta un lead caliente o traspasa un chat a una persona. Sin Slack, la herramienta no existe y nada más cambia: los avisos por WhatsApp de Ajustes (Ventas, Alertas, Reportes) son independientes.Video del avatar
Si la persona del agente tiene cara y voz configuradas, el agente puede generar un video corto del avatar diciendo un texto y mandarlo cuando esté listo; tarda unos minutos y la conversación sigue mientras tanto. Es la única que se pide en prosa («en el saludo, mándale un video de bienvenida») y solo si tu negocio lo amerita. Ver La persona del agente.Tus propias herramientas (MCP)
Si tu negocio tiene un sistema propio —un ERP, un sistema de reservas, un CRM— que expone un servidor MCP, puedes conectarlo y tu agente lo usará como una herramienta más. Está en Personalizar → Herramientas: «Añadir servidor MCP», con un nombre, la URL del servidor y, si lo pide, su clave.1
Conecta el servidor
Personalizar → Herramientas → Añadir servidor MCP. La tarjeta queda con
su estado (Activo / Inactivo) y una etiqueta Con credencial si
guardaste la clave.
2
Escríbela en el manual
En el menú El agente elige, entre las herramientas que publica tu servidor, la que
cumple esa instrucción.
@ → Herramientas, la entrada «Otra herramienta» es la
genérica para todo lo que venga de un servidor MCP. Su dato es la
instrucción: qué tiene que hacer, nombrando tu sistema si tienes varios.3
Pruébala en un chat
El agente descubre solo las herramientas del servidor; un servidor recién
añadido puede tardar unos minutos en aparecerle. Abre un chat de
prueba desde la bandeja y mira el chip ⚡ para ver si corrió y qué
devolvió.
- Límites: hasta 5 servidores por negocio y 20 herramientas en total. Lo que pase de ahí no se carga.
- Si el servidor está caído, se salta. El agente sigue atendiendo sin esa herramienta; nunca se cae la conversación por un servidor ajeno.
- Lo que devuelve tu servidor es texto de un tercero. El agente lo trata como información, no como órdenes; y ninguna herramienta MCP puede cobrar ni mover dinero, porque el agente no tiene forma de hacerlo.
- La URL tiene que ser pública (
https://…). Los servidores en redes privadas no se admiten.
Cómo saber si funcionó
Cada vez que el agente ejecuta una herramienta, en el hilo del chat aparece un chip ⚡ con su nombre —Recordatorio, Conversión registrada, Aviso a tercero…— y, si algo se desvió, una palabra al lado:
Si un chip te sorprende, pulsa sobre él: se despliega con los datos que el
agente le pasó y lo que la herramienta devolvió. Es la forma más rápida de
entender por qué hizo lo que hizo.
El resumen de todo esto vive en Resultados, en la línea Éxito de
herramientas: de todas las acciones que el agente intentó, cuántas salieron
bien. Lo cuenta
Pedidos y métricas.