Cómo Construir un Asistente de IA para WhatsApp

// prompts/systemPrompt.js

const SYSTEM_PROMPT = `
Eres un asistente prequirúrgico de pacientes para el Instituto Ortopédico Reedy.
Tu función es responder preguntas de pacientes en las 48 horas previas a cirugía electiva.

BASE DE CONOCIMIENTO:
- Protocolo de ayuno: no alimentos sólidos durante al menos 8 horas antes de cirugía.
  Líquidos claros (agua, té solo, café negro) permitidos hasta 2 horas antes.
  No chicles, caramelos duros, ni bebidas con leche después de medianoche.
- Ubicación de check-in: Mostrador de Admisiones Quirúrgicas, Planta Baja, Campus Principal.
  Llegar 90 minutos antes de la hora programada de cirugía.
  Documentos requeridos: DNI, tarjeta de seguro (si aplica), confirmación de cita.
  Línea de admisiones: +34 931 234 567, opción 2.
- Respuestas emocionales comunes: la ansiedad antes de cirugía es normal y esperada.
  Reconoce los sentimientos del paciente antes de proporcionar información.
  Si la ansiedad se describe como severa o debilitante, recomienda discutirlo con el equipo médico.

REGLAS DE COMPORTAMIENTO:
1. Responde SOLO preguntas que puedas responder desde la base de conocimiento anterior.
2. Si una pregunta está fuera de alcance, dilo claramente y proporciona la línea de admisiones.
3. NUNCA inventes información médica específica que no esté presente en la base de conocimiento.
4. Mantén las respuestas concisas. Los pacientes leen esto en una pantalla de teléfono.
5. Si el paciente recibió instrucciones diferentes de su cirujano, SIEMPRE defiere al cirujano.
6. Saluda al paciente por su nombre en el primer mensaje si su nombre se conoce del contexto.
7. Responde en el mismo idioma que usa el paciente.
`;

module.exports = SYSTEM_PROMPT;

// sessions/sessionStore.js

const sessions = new Map();

const MAX_HISTORY_TURNS = 10; // keep last 10 exchanges to manage context window

function getHistory(userId) {
  return sessions.get(userId) || [];
}

function addTurn(userId, role, content) {
  const history = getHistory(userId);
  history.push({ role, content });

  // trim to max turns (each turn = 2 messages: user + assistant)
  const maxMessages = MAX_HISTORY_TURNS * 2;
  if (history.length > maxMessages) {
    history.splice(0, history.length - maxMessages);
  }

  sessions.set(userId, history);
}

function clearHistory(userId) {
  sessions.delete(userId);
}

module.exports = { getHistory, addTurn, clearHistory };

// llm/claudeClient.js

const Anthropic = require('@anthropic-ai/sdk');
const SYSTEM_PROMPT = require('../prompts/systemPrompt');

const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });

async function generateResponse(history, userMessage) {
  // append the new user message to history before calling the API
  const messages = [
    ...history,
    { role: 'user', content: userMessage }
  ];

  const response = await client.messages.create({
    model: 'claude-sonnet-4-20250514',
    max_tokens: 512,        // keep responses short for mobile reading
    system: SYSTEM_PROMPT,
    messages
  });

  return response.content[0].text;
}

module.exports = { generateResponse };

// server.js

require('dotenv').config();
const express = require('express');
const twilio = require('twilio');
const { getHistory, addTurn } = require('./sessions/sessionStore');
const { generateResponse } = require('./llm/claudeClient');

const app = express();
app.use(express.urlencoded({ extended: false }));

const twilioClient = twilio(
  process.env.TWILIO_ACCOUNT_SID,
  process.env.TWILIO_AUTH_TOKEN
);

app.post('/webhook', async (req, res) => {
  // Twilio envía datos codificados en formulario
  const incomingMessage = req.body.Body?.trim();
  const fromNumber = req.body.From; // ej. "whatsapp:+34612345678"

  if (!incomingMessage || !fromNumber) {
    return res.status(400).send('Faltan campos requeridos');
  }

  try {
    const history = getHistory(fromNumber);
    const reply = await generateResponse(history, incomingMessage);

    addTurn(fromNumber, 'user', incomingMessage);
    addTurn(fromNumber, 'assistant', reply);

    await twilioClient.messages.create({
      from: process.env.TWILIO_WHATSAPP_NUMBER,
      to: fromNumber,
      body: reply
    });

    res.status(200).send('OK');

  } catch (error) {
    console.error('Error de webhook:', error);
    await twilioClient.messages.create({
      from: process.env.TWILIO_WHATSAPP_NUMBER,
      to: fromNumber,
      body: 'Estamos experimentando un problema temporal. Por favor, llama al +34 931 234 567 para asistencia inmediata.'
    });
    res.status(200).send('OK');
  }
});

app.listen(process.env.PORT, () => {
  console.log(`Servidor de webhook ejecutándose en puerto ${process.env.PORT}`);
});