Construye con IA: cómo armar el WhatsApp de los clientes de la agencia con Claude Code, OpenAPI y MCP

Cuatro piezas. El llms.txt resume el producto, el precio, los límites y los enlaces para el agente. La especificación OpenAPI y la colección Postman describen los endpoints, en portugués, inglés y español. El servidor MCP, de código abierto (github.com/zapzapapi/zapzap-mcp), le da al agente herramientas listas, y los SDK oficiales (Node.js, Python y PHP, en el GitHub zapzapapi) cubren la integración en código. Mira la página de agentes de IA y la guía del servidor MCP.

Pon en el archivo de instrucciones del proyecto (CLAUDE.md, AGENTS.md o las reglas de Cursor) los enlaces de la OpenAPI y del llms.txt, la base URL y los nombres de las variables de entorno. Nunca pegues la clave y el secreto de la API en el prompt ni en el repositorio: el agente solo necesita saber que existen ZAPZAP_API_KEY y ZAPZAP_API_SECRET.

Un fragmento de instrucciones que funciona: "La API de WhatsApp es ZapZap. Especificación: https://zapzapapi.com/openapi/zapzap-openapi.es.json. Resumen para IA: https://zapzapapi.com/llms.txt. Base: https://api.zapzapapi.com/api/v1. Autenticación: encabezados x-api-key y x-api-secret, leídos de ZAPZAP_API_KEY y ZAPZAP_API_SECRET. Usa solo endpoints presentes en la especificación y avisa cuando un recurso no exista."

Los prompts que funcionan son pequeños y verificables. Para un CRM mínimo: "Crea un script Node.js que reciba el webhook de mensajes recibidos de ZapZap y guarde en una tabla leads (teléfono, nombre, primer mensaje, instancia, fecha). Usa solo los campos que describe la especificación, valida el payload y responde 200 rápido." Para un reporte: "Lee las instancias con GET /instances y, para cada una, las campañas con GET /{instanceId}/sender/listfolders. Genera un JSON con los contadores log_total, log_delivered, log_read y log_failed." Para recordatorios: "Programa un mensaje con POST /{instanceId}/sender/simple usando scheduled_for en milisegundos."

Pide siempre la prueba al final: "escribe una prueba que corra contra una instancia de homologación". Y haz que el agente cite de qué operación de la OpenAPI sacó cada llamada, lo que vuelve la revisión cuestión de un minuto.

El fragmento de abajo es la base de casi todo: listar las instancias de la cuenta y revisar el estado de cada una. Usa solo operaciones documentadas, y sirve como punto de partida para un panel interno de salud de los números de los clientes.

const BASE = "https://api.zapzapapi.com/api/v1";
const headers = {
  "x-api-key": process.env.ZAPZAP_API_KEY,
  "x-api-secret": process.env.ZAPZAP_API_SECRET,
};

const instances = await (await fetch(BASE + "/instances", { headers })).json();
for (const inst of instances) {
  const r = await fetch(BASE + "/" + inst.id + "/instance/status", { headers });
  console.log(inst.name, r.ok ? await r.json() : "HTTP " + r.status);
  await new Promise((res) => setTimeout(res, 1000));
}

Cuatro proyectos de alto retorno para una agencia: un panel de salud de los números de los clientes (cuáles se cayeron, cuáles necesitan reconectarse), un CRM mínimo alimentado por webhook, un reporte mensual por cliente (mira automatizar reportes) y un programador de seguimientos y recordatorios (mira programar mensajes de compromisos). Para el flujo de leads de anuncios por cliente, mira seguir leads de anuncios.

Empieza por el panel de salud: es de solo lectura, tiene poco riesgo y ya entrega valor en la primera semana.

Revisa todo envío. Un agente que genera código que envía mensajes puede, por error, mandar el mismo mensaje a una lista entera o ignorar el ritmo. Exige retrasos entre envíos, un tope de volumen por ejecución y un modo de prueba que escriba en un log en lugar de enviar. No apruebes código que envíe a listas sin consentimiento, según el uso aceptable.

Atiende también la seguridad: clave y secreto solo en el back-end, nunca en el navegador, y una clave por entorno. Para las páginas de nicho, mira agencias con IA y reventa con la marca del cliente.