Herramientas, notificaciones y etiquetas automáticas

Para quién es: quien administra la cuenta.

Para qué sirve

Además de conversar, un agente puede ejecutar acciones. Eso lo convierte de un chatbot en un asistente que opera. Se configuran en el paso Herramientas.

💡

Tip:Describí bien cada herramienta: el agente decide cuándo usarla leyendo tu descripción. "Consulta el estado de un pedido a partir del número de orden" funciona mejor que "consulta pedidos".

Llamada a tu API (API externa)

El agente consulta un sistema tuyo (stock, precios, estado de un pedido). Configurás:

Nombre y descripción de la función.
URL y método (GET, POST, PUT, DELETE).
Headers (por ejemplo tu clave de API). Se guardan cifrados.
Parámetros que se envían.

➡️

Paso:Completá la herramienta con sus parámetros.

➡️

Paso:Tocá Probar tool y cargá valores de prueba para ver la respuesta real de tu API.

➡️

Paso:Guardá recién cuando la prueba devuelva lo que esperás.

Acciones del sistema

Acción	Qué hace
Escalar a una persona	Pasa la conversación al equipo humano
Etiquetar	Aplica una etiqueta a la conversación
Cerrar la conversación	La cierra con un resumen
Webhook	Avisa a un sistema externo
Avisar a un usuario o departamento	Notifica al equipo dentro de TalkAI y el agente sigue atendiendo
Avisar al dueño fuera de TalkAI	Notifica a una persona por un medio externo
Consultar a otro agente (`consult_agent`)	Le pregunta algo a un agente transaccional sin ceder la conversación
Enviar una plantilla (`send_template`)	Manda una plantilla de WhatsApp sin variables, por ejemplo un menú de botones
Leer adjuntos (`read_attachment`)	Lee PDF, Word, Excel, CSV, texto y fotos de documentos
Editar imágenes y PDFs (`edit_media`)	Tacha, recorta, retoca, rota o convierte. Ver Adjuntos
Constatar comprobantes en AFIP	Verifica facturas (solo Argentina). Ver Validación AFIP
Agenda	Ofrecer horarios, dar, listar, reprogramar y cancelar turnos. Ver Agenda

Si `send_template` no manda nada

La herramienta rechaza la plantilla, y el agente parece mudo, en tres casos típicos:

El nombre o idioma de la plantilla no coincide exactamente (cuidado con los acentos).
La plantilla tiene encabezado multimedia que no se pudo resolver.
La plantilla tiene variables: esta herramienta solo envía plantillas sin variables.

Editor de agente con los interruptores para transferir y consultar a otros agentes.

Disparadores automáticos

Algunas acciones pueden dispararse solas ante un evento, sin que el agente lo decida: al iniciar, al cerrar, al transferir a otro agente IA o al escalar a una persona.

Los argumentos admiten variables que se reemplazan con datos reales: {{customerName}}, {{customerPhone}}, {{conversationId}}, {{lastUserMessage}}, {{summary}}.

Notificaciones automáticas

En el paso General podés hacer que el agente avise a tu equipo ante cada evento (inicio, cierre, escalado, transferencia). Para cada uno elegís si notificar, a qué departamento o usuario, y un resumen con variables.

Etiquetas automáticas

De la misma forma, el agente puede etiquetar la conversación según el evento. Para cada uno elegís la etiqueta.

💡

Tip:Combiná etiquetas automáticas con filtros del inbox para medir: por ejemplo, "Resuelto por IA" al cerrar o "Requiere humano" al escalar.

Errores frecuentes

Guardar una herramienta sin probarla.
Descripciones genéricas: el agente no sabe cuándo usarla.
Esperar que send_template complete variables.