Ejercicio: Otros proveedores y alternativas a la API directa

⏱ 40 minutos
📶 Nivel: intermedio

Objetivo

Comparar proveedores con números, recomendar un camino según el perfil del proyecto y escribir el adaptador de entrada de Twilio, para comprobar que cambiar de proveedor solo toca la carcasa del bot.

Cómo se trabaja

La parte A es de investigación en las páginas oficiales. La parte B son cuatro funciones de JavaScript puro que se comprueban en esta página. Los precios que uses en la parte B son inventados y solo sirven para practicar la cuenta: nunca cotices con ellos.

💡 Reto extra

Añade salidaATwilio(para, respuesta) que convierta una respuesta de tipo texto del motor en el cuerpo { To: "whatsapp:+<para>", Body: texto }, y que lance un error para los demás tipos (explica en un comentario por qué los botones necesitan plantillas o contenido especial en ese proveedor: revisa su documentación antes de decidir).

▶ Prueba tu código aquí (opcional)

Código (edítalo y pulsa Ejecutar)

<script>
// Escribe aquí tus funciones y pruébalas con console.log
</script>

Página (resultado)

Consola

Pasos

Marca cada paso a medida que lo completes. Tu avance se guarda en este navegador.

Parte A. Abre las páginas oficiales de precios de Meta, de Twilio y de 360dialog y anota en notas.md, para cada una, la fecha de consulta y qué cobra (por mensaje, cuota mensual, o ambos). Marca cada cifra con «Verifica este dato».
Parte A. Elige un negocio imaginario (por ejemplo, el minimarket con 600 mensajes de plantilla al mes) y escribe en notas.md qué camino recomendarías (API directa, proveedor o sandbox) y por qué, en 4 líneas.
Parte B. Escribe costoMensual({ cuotaFija, tarifaProveedor, mensajes, tarifaMeta, plantillas }): devuelve cuotaFija + tarifaProveedor * mensajes + tarifaMeta * plantillas, redondeado a 2 decimales. Los campos que falten valen 0.
Parte B. Escribe recomendarOpcion({ sabeProgramar, numClientes, quiereSoporte, usaLibreriaNoOficial }) con estas reglas, en este orden: si usa librería no oficial devuelve "rechazar"; si no sabe programar devuelve "bsp"; si quiere soporte o tiene más de 5 clientes devuelve "bsp"; en otro caso devuelve "api-directa".
Parte B. Escribe riesgoDeBloqueo(opcion): "api-directa" y "bsp" dan "bajo"; "baileys" y "whatsapp-web.js" dan "alto"; cualquier otra cosa da "desconocido".
Parte B. Escribe entradaDeTwilio(form): recibe un objeto con From (por ejemplo "whatsapp:+51999000111") y Body, y devuelve { de, entrada } donde de es el número sin el prefijo whatsapp: ni el +, y entrada es { tipo: "texto", texto } (con el texto recortado). Si falta From, o falta Body o está vacío, devuelve null.

💡 Pista 1: La suma de costos

Usa valores por defecto al desestructurar: { cuotaFija = 0, tarifaProveedor = 0, ... }. Para redondear a 2 decimales: Math.round(x * 100) / 100.

💡 Pista 2: Orden de las reglas

Las reglas se evalúan de arriba abajo con if ... return. Si el cliente usa una librería no oficial, nada más importa: devuelves "rechazar" primero.

💡 Pista 3: Limpiar el número de Twilio

form.From.replace("whatsapp:", "").replace("+", "") deja solo los dígitos. Revisa typeof form.Body === "string" y que, ya recortado, no esté vacío.

🔎 Comprueba tu trabajo

Pega tu código y pulsa Comprobar. La revisión ocurre en tu navegador; nada se envía a ningún sitio. Cada punto en rojo incluye una pista. Pega solo el JavaScript, sin las etiquetas <script>.

Tu código de JavaScript

✅ Ver una solución posible

Intenta resolverlo antes de mirar. Tu versión puede ser distinta y también correcta.

funciones.js

function costoMensual({ cuotaFija = 0, tarifaProveedor = 0, mensajes = 0, tarifaMeta = 0, plantillas = 0 } = {}) {
  const total = cuotaFija + tarifaProveedor * mensajes + tarifaMeta * plantillas;
  return Math.round(total * 100) / 100;
}

function recomendarOpcion({ sabeProgramar, numClientes, quiereSoporte, usaLibreriaNoOficial }) {
  if (usaLibreriaNoOficial) return "rechazar";
  if (!sabeProgramar) return "bsp";
  if (quiereSoporte || numClientes > 5) return "bsp";
  return "api-directa";
}

const RIESGOS = {
  "api-directa": "bajo",
  "bsp": "bajo",
  "baileys": "alto",
  "whatsapp-web.js": "alto",
};

function riesgoDeBloqueo(opcion) {
  return RIESGOS[opcion] ?? "desconocido";
}

function entradaDeTwilio(form) {
  if (!form || typeof form.From !== "string" || typeof form.Body !== "string") return null;
  const texto = form.Body.trim();
  if (!texto) return null;
  const de = form.From.replace("whatsapp:", "").replace("+", "");
  return { de, entrada: { tipo: "texto", texto } };
}