Agentes de IA que Ejecutan Acciones: Conecta tu Agente a tu API, Calendario y CRM

Un chatbot responde preguntas. Un agente de IA además hace cosas: agenda una cita, consulta el estado de un pedido, revisa el stock, mueve una oportunidad en el CRM o pasa la conversación a una persona.

Esa diferencia es la que convierte a la IA en una herramienta de trabajo. En esta guía te explicamos cómo conectar un agente de WhatsApp a tus sistemas, con ejemplos de Plazbot.

#Cómo decide un agente qué hacer

Cuando un cliente escribe "¿dónde está mi pedido 4521?", el agente:

1. Entiende la intención: quiere saber el estado de un pedido.
2. Elige la herramienta: el servicio "consultar pedido".
3. Pide lo que falta: si el cliente no dio el número, lo pregunta.
4. Ejecuta: llama a tu API con el número de pedido.
5. Responde con el resultado, en lenguaje natural.

En Plazbot, el agente puede encadenar varias herramientas en un mismo mensaje, por ejemplo consultar disponibilidad y luego agendar.

#Las cuatro formas de darle herramientas

#1. Acciones: el agente trabaja en tu CRM y tu calendario

Se activan desde la pestaña Acciones del agente, sin código:

• Calendario: crear, confirmar, reprogramar, cancelar o listar eventos, respetando tu horario de disponibilidad.
• CRM: agregar o quitar etiquetas, mover de etapa, segmentar.
• Equipo: asignar la conversación a una persona, marcarla como resuelta o apagar el agente.
• Mensajes: enviar una imagen, un archivo o una plantilla de WhatsApp.
• Automatización: enviar al contacto a una secuencia o iniciar una automatización.
• IA: generar un resumen de la conversación.

#2. Servicios: el agente consulta tu API

Un servicio es una llamada a tu sistema. Lo configuras desde la pestaña Servicios:

• Para qué sirve: una descripción clara, como "Consulta el estado de un pedido por su número". El agente la usa para decidir cuándo llamarlo.
• Método y URL: GET o POST a tu API.
• Encabezados: por ejemplo tu API key.
• Cuerpo: una plantilla con variables, como {{numero_pedido}}.
• Campos requeridos: lo que el agente debe pedir antes de llamar, con hasta 3 botones de respuesta rápida.
• Respuesta: qué datos tomar de la respuesta y cómo contestar.
• Respuestas condicionales: si el pedido está "en camino", responde una cosa; si está "retrasado", otra, o encadena otro servicio.

Por ejemplo, si tu API responde esto:

{
  "pedido": "4521",
  "estado": "en_camino",
  "fecha_entrega": "2026-10-21",
  "transportista": "Envíos Rápidos"
}

El agente puede contestar: "Tu pedido 4521 está en camino con Envíos Rápidos y llega el 21 de octubre."

Antes de activar un servicio, pruébalo desde el panel: la prueba hace la llamada real a tu API y te muestra la respuesta.

#3. Fuente de datos: el agente busca en tu tabla

Si tu información cambia seguido pero no tienes una API, conecta una hoja de Google Sheets o una tabla de Plazbot en la pestaña Datos. Sirve para:

• Stock y precios de productos.
• Sucursales, horarios y direcciones.
• Propiedades disponibles, con zona y precio.

Actualizas la hoja y el agente responde con los datos nuevos, sin tocar el prompt.

#4. Workers: lógica propia sin servidor

Cuando necesitas algo a medida, un Worker es una función en TypeScript o JavaScript que corre en Plazbot y el agente puede usar como herramienta. Por ejemplo:

• Calcular una cotización con tus reglas.
• Consultar dos sistemas y combinar los resultados.
• Validar un dato antes de guardarlo.

Los Workers también sirven para reaccionar a eventos, sincronizar sistemas o programar tareas. Lo explicamos en la sección de Workers para desarrolladores.

#Buenas prácticas

• Describe bien cada herramienta. El agente decide con la descripción; "Consulta el estado de un pedido por su número" funciona mejor que "API pedidos".
• Expón solo lo necesario. Una API key con permisos de lectura para consultas; nada de operaciones de borrado.
• Pide los datos de a uno. Usa campos requeridos con botones para evitar errores de escritura.
• Define qué pasa cuando falla. Un mensaje amable y la opción de hablar con una persona.
• Prueba en el chat de prueba. Ahí ves qué herramienta eligió el agente y qué respondió tu API.
• Revisa el Monitor. En producción, ves cada decisión del agente y cada llamada a tus sistemas.

Si estás empezando, sigue primero cómo crear un agente de IA para WhatsApp paso a paso. Para un ejemplo de agenda completo, mira cómo crear un agente de reservas de citas, y para ventas, agente de IA para vender por WhatsApp.