@danielgarciapro

Guía de Automatización con IA

Dale a Claude un número de WhatsApp

Su propia línea conectada a la API oficial de WhatsApp Cloud. Envía, recibe, agenda citas y haz seguimiento continuo sin necesidad de tocar tu teléfono.

Una guía elaborada por @danielgarciapro

Empieza Aquí

La pieza que faltaba

Los conectores tradicionales de Claude le permiten leer y responder dentro de tus cuentas existentes. Lo que no le proporcionan es una línea propia e independiente. Hasta que tu agente no posea su propio número, no podrá atender a un cliente a medianoche, dar seguimiento a una cotización al tercer día, ni confirmar una reserva mientras duermes.

Un número propio cambia por completo la categoría. Deja de ser un asistente pasivo con el que tú conversas, y se convierte en una entidad autónoma que habla con otras personas en tu nombre.

Construye sobre la Cloud API oficial de Meta.

Enruta toda tu arquitectura a través de un Meta Business Partner o directamente con Meta. Las herramientas no autorizadas que inician sesión simulando tu usuario o que utilizan clientes modificados terminan invariablemente con números baneados de por vida. Una vez que pierdes un número comercial en WhatsApp, se pierde para siempre.

Paso 1

Elige un número

Existen tres alternativas principales. Te recomendamos iniciar con un número alojado (*hosted*) mientras realizas pruebas de concepto, y migrar a tu propia línea cuando lances a producción.

Opción	Qué obtienes	Configuración	Ideal para
Número alojado (Hosted)	Un número nuevo y limpio asignado para ti	~2 min, sin tarjeta SIM ni códigos	Pruebas, desarrollo y nuevos agentes
Tu propia SIM	Cualquier número, de cualquier país	Verificación única (código SMS/llamada)	Un número que tus clientes ya conocen
App de WhatsApp Business	Mantienes la app móvil, mensajes sincronizados	Sin proceso complejo de migración	Equipos que ya operan a diario en la app

Panel de configuración de número alojado

Un número alojado no necesita tarjeta SIM física ni códigos de verificación manuales.

¿Estás en fase de pruebas? Elige el número alojado (*hosted*). Estarás enviando y recibiendo mensajes en un par de minutos y podrás descartarlo después.
¿Operación comercial real? Usa el número que tus clientes ya tienen registrado en sus agendas. La confianza y el historial pesan mucho más que la rapidez de setup.
Nunca utilices tu número personal para un agente automatizado. Separa siempre la línea operativa de tu vida privada.

Paso 2

Deja que Claude escriba la integración

No tienes que pasar horas leyendo manuales de referencia de la API. Instala las habilidades de agente (*agent skills*), abre Claude Code y describe con precisión lo que necesitas construir.

Integración con Claude Code y Agent Skills

Las skills proporcionan a Claude la documentación completa de la plataforma en forma de herramientas interactivas.

Luego pídelo en lenguaje completamente natural:

Constrúyeme un agente de WhatsApp que responda dudas frecuentes sobre
nuestros servicios, consulte el calendario en tiempo real, agende citas
y envíe un recordatorio la mañana del evento. Escala la conversación conmigo
si la persona solicita cualquier cosa que el modelo no pueda resolver con certeza.

Paso 3

Envío y recepción de mensajes

Todo el proceso de envío se reduce a instanciar un cliente y ejecutar una única llamada. Absolutamente todo lo demás es la lógica personalizada de tu negocio.

La Cloud API oficial de Meta por debajo, envuelta en un SDK sumamente simple.

La recepción es un webhook

Los mensajes entrantes de los usuarios llegan en forma de petición HTTP POST hacia tu servidor. El manejador (*handler*) de esa ruta es precisamente el punto donde Claude entra en acción.

// 1. El mensaje entrante llega a tu endpoint de webhook app.post('/webhook', async (req, res) => { const msg = req.body.message; // 2. Le preguntas a Claude qué responder, inyectando el contexto de tu negocio const reply = await claude(msg.text, businessContext); // 3. Envías la respuesta directamente desde tu número oficial await client.messages.sendText({ to: msg.from, body: reply }); res.sendStatus(200); });

Ese es el bucle completo: el mensaje entra, Claude razona con contexto, y el mensaje sale. Todo lo demás que construyas (sincronización de calendarios, CRM, catálogos o bases de datos) son simplemente herramientas (*tools*) que pones a disposición de Claude dentro del paso dos.

El Resultado

Lo que ve tu cliente

Una conversación de WhatsApp completamente fluida y natural, atendida en cuestión de segundos, a cualquier hora del día o de la noche.

Tu agente operando en su propio número. Tu teléfono personal permanece completamente al margen.

Bonus Extra

Inserta una mini-aplicación dentro del chat

La tecnología de WhatsApp Flows te permite renderizar un formulario nativo interactivo directamente en la conversación: reservas de turnos, catálogos dinámicos, encuestas o captura de clientes potenciales. Sin apps externas que descargar ni enlaces que saquen al usuario a un navegador web.

Un formulario de agendamiento nativo, desplegado visualmente dentro de WhatsApp.

Usa un Flow cuando requieras más de dos datos. El formato de texto tradicional es deficiente cuando intentas pedir cinco respuestas consecutivas.
Conserva el chat para la conversación empática y reserva el Flow para completar la transacción o registro estructurado.

Para Desarrolladores

Prueba y depura adecuadamente

Esta es la etapa donde la mayoría de implementaciones de WhatsApp fallan, y el motivo principal por el cual los bots dejan de responder silenciosamente en producción.

Panel de logs y diagnóstico de solicitudes

Cada solicitud registrada en detalle: latencia, carga útil enviada (payload) y respuesta del servidor.

Usa siempre un número en sandbox al iniciar. Jamás pruebes nuevos prompts o flujos con clientes reales en tu línea principal.
Monitorea los logs del webhook continuamente. Si tu agente enmudece, casi con certeza se trata de una falla en el webhook (timeout o error HTTP), no de un mal prompt.
Rastrea el estado real de los mensajes. Enviado (*sent*), entregado (*delivered*) y leído (*read*) son tres hitos distintos. Las plantillas suelen rebotar en el primero si no están autorizadas.
Envíate mensajes primero a ti mismo, luego a un contacto de confianza, antes de exponer el bot al tráfico general.

Lee Esto Dos Veces

Las reglas de oro para mantenerte en línea

Obtén opt-in (consentimiento explícito). Solo tienes permitido iniciar comunicaciones con usuarios que hayan aceptado previamente ser contactados por este medio.
La ventana de servicio de 24 horas. Durante las primeras 24 horas desde el último mensaje recibido del cliente, puedes responder con cualquier mensaje libre. Fuera de ese lapso, solo puedes contactar mediante plantillas pre-aprobadas por Meta.
Las plantillas requieren aprobación. Redacta con anticipación tus mensajes de recordatorio y seguimiento, y somételos a revisión en el panel de Meta antes del día en que los necesites.
Ofrece siempre una salida con un operador humano. Todo agente automatizado debe contar con una ruta sencilla de escalamiento a una persona real cuando el cliente lo solicite.
Transparencia: aclara que es un asistente de IA. No necesitas repetirlo en cada línea, pero jamás simules ser un humano real si el usuario te lo pregunta directamente.

La tarificación es por uso real.

Los planes gratuitos son bastante generosos para validar un proyecto piloto (típicamente hasta 1,000 conversaciones de servicio gratuitas cada mes). No obstante, Meta factura por cada conversación iniciada a partir de ese límite, y las tarifas difieren según el código de país del cliente. Consulta siempre las tarifas oficiales actualizadas antes de presupuestar un costo fijo con un cliente.

Si Algo Falla

Resolución de problemas frecuentes

¿El agente se quedó en silencio repentinamente? Revisa que tu servidor esté retornando un código de estado 200 OK rápidamente. Si la solicitud entra en timeout, la plataforma suspende temporalmente la entrega de eventos.
¿El mensaje figura como enviado pero nunca llega? Lo más probable es que hayan pasado más de 24 horas desde la última interacción y requieras utilizar una plantilla aprobada (*template*).
¿Meta rechazó tu plantilla? Generalmente sucede por utilizar lenguaje de ventas o marketing en una categoría configurada como 'Utilidad'. Ajusta el texto o selecciona la categoría de marketing.
¿Las respuestas tardan demasiado en generarse? Envía un acuse de recibo instantáneo (o el estado de "escribiendo...") y luego la respuesta analizada por Claude. La ausencia prolongada de respuesta genera la sensación de que el servicio está caído.
¿Claude inventa respuestas o se equivoca? El 99% de las veces obedece a falta de contexto preciso en el system prompt, no a un déficit del modelo. Proporciónale listas de precios, políticas de garantía y preguntas frecuentes completas.

Despliegue a Producción

Lista de verificación de lanzamiento

✓

Has probado el envío y la recepción en el número directamente desde tu propio teléfono celular.
✓

El agente posee el contexto real de precios, catálogo de servicios, políticas comerciales y preguntas frecuentes.
✓

El mecanismo de escalamiento a una persona real está probado y se activa con facilidad.
✓

Las plantillas para recordatorios y seguimiento ya fueron enviadas y aprobadas por Meta.
✓

Los registros (logs) del webhook están accesibles para monitorear errores de manera inmediata.
✓

Ningún componente de tu solución solicita contraseñas personales de WhatsApp ni emplea clientes modificados o ingeniería inversa.