← Blog
Claude APIWhatsApp Businessautomatizaciónatención al clienteColombia

Cómo conectar Claude API con WhatsApp Business para atención al cliente

25 de abril de 20265 min de lectura

Por qué WhatsApp y no otro canal

En Colombia y en toda Latinoamérica, WhatsApp no es un canal más — es el canal. Los clientes prefieren escribir un WhatsApp antes que llenar un formulario, enviar un email o llamar. Las empresas que lo ignoran en su estrategia de atención están dejando que los clientes se pierdan en el proceso.

El problema es que WhatsApp a escala es insostenible con operadores humanos. Una empresa que recibe 200 mensajes diarios necesita al menos 3-4 personas dedicadas a responder — y aún así los tiempos de respuesta fuera de horario son inexistentes. Un agente basado en Claude resuelve el 70-85% de las consultas en segundos, en cualquier horario, y escala los casos complejos al humano adecuado con el contexto completo de la conversación.

La arquitectura básica

El sistema tiene tres piezas:

WhatsApp Business API (Meta)
        ↓  webhook
Tu servidor (Node.js / Python)
        ↓  API call
Claude API (Anthropic)
        ↓  respuesta
WhatsApp Business API → usuario

WhatsApp Business API (Meta): Es el canal oficial de Meta para empresas. No es la app de WhatsApp Business que descargas en el teléfono — es una API que requiere aprobación de Meta, un número de teléfono dedicado y un proveedor de soluciones (BSP) o acceso directo vía Meta Cloud API.

Tu servidor: Recibe los mensajes entrantes por webhook, gestiona el historial de conversación, decide si Claude responde automáticamente o escala a un humano, y envía la respuesta de vuelta a WhatsApp.

Claude API: Recibe el historial de la conversación y las instrucciones de comportamiento del agente, y genera la respuesta.

Cómo implementar el flujo

Paso 1: Configurar WhatsApp Business API

Tienes dos opciones para acceder:

  • Meta Cloud API (directo): Sin costo de infraestructura de terceros, pero requiere configurar tú mismo los webhooks y la gestión de números en Meta Developer Portal.
  • BSP (Business Solution Provider): Proveedores como Twilio, 360dialog o Vonage ofrecen una capa sobre la API de Meta con más herramientas. Tienen costo mensual adicional pero simplifican la integración.

Para la mayoría de empresas en Colombia que están empezando, Meta Cloud API directa es suficiente y más económica.

Paso 2: El webhook que recibe los mensajes

Cuando un usuario escribe a tu número de WhatsApp, Meta envía un POST a tu endpoint:

{
  "entry": [{
    "changes": [{
      "value": {
        "messages": [{
          "from": "573001234567",
          "text": { "body": "Hola, ¿cuáles son sus horarios?" },
          "timestamp": "1714089600"
        }]
      }
    }]
  }]
}

Tu servidor recibe este evento, extrae el número del remitente y el texto del mensaje, y decide qué hacer.

Paso 3: Gestión del contexto de conversación

Claude necesita el historial de la conversación para responder de forma coherente. Cada mensaje nuevo llega sin contexto — tu servidor es responsable de mantenerlo.

La forma más simple: una base de datos (Redis o PostgreSQL) que almacena los últimos N mensajes por número de teléfono.

def get_conversation_history(phone_number: str, limit: int = 10) -> list:
    # Retorna los últimos `limit` mensajes de este número
    return db.query(
        "SELECT role, content FROM messages WHERE phone = ? ORDER BY created_at DESC LIMIT ?",
        phone_number, limit
    )

Paso 4: La llamada a Claude

Con el historial construido, armas el request a Claude API:

import anthropic

client = anthropic.Anthropic()

def generate_response(history: list, new_message: str) -> str:
    messages = history + [{"role": "user", "content": new_message}]
    
    response = client.messages.create(
        model="claude-sonnet-4-6",
        max_tokens=500,
        system="""Eres el asistente de atención al cliente de [Empresa].
        Respondes en español, de forma cordial y concisa.
        Si el cliente pregunta por precios específicos, cotizaciones o reclamos,
        responde que vas a conectarlo con un asesor y termina con: [ESCALAR_HUMANO]""",
        messages=messages
    )
    
    return response.content[0].text

La instrucción [ESCALAR_HUMANO] es una señal que tu servidor detecta para transferir la conversación a un operador real.

Paso 5: Lógica de escalamiento

No todo debe responderlo el agente. La lógica de escalamiento define cuándo un humano toma el control:

def handle_response(phone: str, ai_response: str):
    if "[ESCALAR_HUMANO]" in ai_response:
        # Limpiar la señal del texto final
        clean_response = ai_response.replace("[ESCALAR_HUMANO]", "").strip()
        send_whatsapp(phone, clean_response)
        # Notificar al equipo de atención
        notify_agent(phone, get_conversation_history(phone))
    else:
        send_whatsapp(phone, ai_response)
        save_message(phone, "assistant", ai_response)

Qué puede resolver el agente automáticamente

Dependiendo de las instrucciones que le des a Claude y la información que le proveas, el agente puede resolver:

  • Preguntas frecuentes — horarios, ubicación, métodos de pago, requisitos
  • Estado de pedidos — si le das acceso a tu base de datos de pedidos
  • Calificación de leads — recopilar nombre, empresa, necesidad antes de pasar a un vendedor
  • Agendamiento básico — integrando con Calendly o Google Calendar via API
  • Soporte nivel 1 — guías paso a paso, instrucciones de uso, resolución de problemas comunes

Lo que no debe resolver solo: reclamos con carga emocional alta, devoluciones de dinero, casos legales o cualquier situación donde el cliente necesita sentir que hay un humano escuchando.

Costos reales para una empresa mediana

Tasa de referencia: $4.100 COP/USD (aproximada — ajusta según la tasa del día).

Componente USD/mes COP/mes aprox.
WhatsApp Business API (Meta Cloud) $0 – $50 $0 – $205.000 (primeras 1.000 conversaciones gratis)
Servidor (instancia básica AWS/GCP) $15 – $40 $62.000 – $165.000
Claude API (500 conversaciones/mes, ~10 msgs c/u) $30 – $80 $123.000 – $328.000
Total operativo $45 – $170 $185.000 – $700.000

El costo de desarrollo del sistema completo, dependiendo de complejidad de integraciones, está entre $800 – $3.000 USD (~$3M – $12M COP) una sola vez.

El resultado que importa

El indicador que más valoran los equipos que implementan este sistema no es la tasa de automatización — es el tiempo de primera respuesta. Pasar de "respuesta en 4-8 horas (en horario laboral)" a "respuesta en 8 segundos, 24/7" cambia la percepción del servicio de forma inmediata y medible en la satisfacción del cliente.

Jose Martinez N.
Jose Martinez N.
Desarrollo Full Stack · IA aplicada · Bogotá, Colombia
LinkedIn

¿Tienes un proceso que se puede automatizar?

En 30 minutos revisamos si tiene sentido para tu caso. Sin costo, sin compromiso.

También te puede interesar