apiCEP
    ES|EN
    Volver al blog

    Cómo crear un bot de WhatsApp que valide comprobantes SPEI automáticamente con apiCEP

    El proceso que repites decenas de veces al día

    Tu cliente hace la transferencia. Te manda el comprobante por WhatsApp. Tú pausas lo que estás haciendo, revisas la imagen, verificas el monto, confirmas que llegó a tu cuenta y le respondes. Luego liberas el pedido o el acceso.

    Ese ciclo se repite en cada venta. Si tienes un día bueno con 20 pedidos, son 20 interrupciones que te sacan de todo lo demás.

    Con un bot de WhatsApp conectado a apiCEP, ese ciclo completo ocurre solo: el cliente manda el comprobante, el bot lo valida contra Banxico en tiempo real y responde automáticamente con la confirmación — sin que tú hagas nada.

    Las dos piezas del sistema

    Este bot se construye con dos herramientas:

    • YCloud — plataforma oficial BSP de Meta que conecta tu WhatsApp Business App actual a una API y te permite crear automatizaciones y chatbots sin dejar de usar tu número de siempre. [page:0]
    • apiCEP — API que recibe la imagen del comprobante SPEI, la lee con OCR y verifica el pago directamente contra Banxico en menos de 10 segundos.

    La combinación es poderosa: YCloud maneja todo lo que tiene que ver con WhatsApp (recibir mensajes, detectar imágenes, enviar respuestas), y apiCEP hace la verificación del pago. Tú conectas ambas cosas.

    Ventaja clave de YCloud: coexistencia con tu app actual

    La función de coexistencia de WhatsApp Business App de YCloud permite conectar tu número actual de WhatsApp Business a la plataforma sin perder tu historial, tus contactos ni tu palomita azul. [page:0]

    Sigues respondiendo uno a uno desde tu teléfono como siempre, pero ahora también tienes acceso a la API para automatizar flujos específicos — como la validación de comprobantes. [page:0] No necesitas migrar a un número nuevo ni cambiar la forma en que atiendes a tus clientes.

    Sin RFC, sin empresa formal: cualquiera puede hacer esto

    Antes de entrar al tutorial, un punto importante para emprendedores: apiCEP no requiere RFC, ni que seas persona física con actividad empresarial, ni persona moral.

    Para crear tu cuenta en apiCEP solo necesitas un correo electrónico y una contraseña. Eso significa que cualquier negocio — formal o informal, grande o pequeño — puede tener un bot de WhatsApp que valide comprobantes SPEI automáticamente.

    YCloud también tiene planes accesibles con prueba gratuita, sin requerir constitución de empresa para empezar.

    Si vendes por Instagram, por grupos de WhatsApp, desde un negocio en casa o en proceso de formalización, este sistema funciona igual para ti que para una empresa registrada.

    Arquitectura del bot

    El flujo completo funciona así:

    Cliente manda imagen del comprobante por WhatsApp
        ↓
YCloud recibe el mensaje y detecta que es una imagen
        ↓
YCloud llama a tu backend (webhook) con la URL de la imagen
        ↓
Tu backend llama a apiCEP con la URL del comprobante
        ↓
apiCEP consulta Banxico y responde si el pago es válido
        ↓
Tu backend procesa la respuesta
        ↓
YCloud envía la respuesta automática al cliente por WhatsApp

    Paso 1 — Conéctate a YCloud con tu número actual

    1. Crea tu cuenta en ycloud.com — hay plan gratuito para empezar.
    2. Desde el panel, selecciona WhatsApp Business App Coexistence. [page:0]
    3. Escanea el QR con tu app de WhatsApp Business actual para vincular tu número.
    4. En minutos tendrás acceso a la API de YCloud con tu mismo número, sin perder nada de tu operación actual.

    Paso 2 — Crea un webhook para recibir mensajes

    YCloud enviará cada mensaje recibido a una URL de tu servidor (webhook). Necesitas un backend mínimo que reciba esas notificaciones.

    Ejemplo en Node.js con Express:

    const express = require('express');
const app = express();
app.use(express.json());

app.post('/webhook/whatsapp', async (req, res) => {
  const message = req.body;

  // Solo procesar si es una imagen
  if (message.type === 'image' && message.image?.url) {
    await handleComprobanteImage(message.from, message.image.url);
  }

  res.sendStatus(200);
});

app.listen(3000);

    Paso 3 — Conecta la imagen a apiCEP

    Cuando el webhook detecta una imagen, la pasa a apiCEP para validación:

    const APICEP_API_KEY = process.env.APICEP_API_KEY;
const TU_CLABE = process.env.TU_CLABE;
const TU_BANCO = process.env.TU_BANCO;
const TU_NOMBRE = process.env.TU_NOMBRE;

async function handleComprobanteImage(clientPhone, imageUrl) {
  // Llamar a apiCEP
  const response = await fetch('https://api.apicep.cloud/validate-transfer', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${APICEP_API_KEY}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      imageUrl: imageUrl,
      beneficiary: {
        clabe: TU_CLABE,
        bank: TU_BANCO,
        name: TU_NOMBRE
      }
    })
  });

  const result = await response.json();

  // Evaluar resultado
  const isValid = result.status === 'valid' && result.validation?.banxicoConfirmed === true;
  const amount = result.extracted?.amount;

  // Enviar respuesta al cliente por WhatsApp
  await sendWhatsAppMessage(clientPhone, isValid, amount, result);
}

    Paso 4 — Responde automáticamente por WhatsApp con YCloud

    Usa la API de YCloud para enviar la respuesta al cliente:

    async function sendWhatsAppMessage(phone, isValid, amount, apiResult) {
  let message;

  if (isValid) {
    message = `✅ *Pago confirmado*

Recibimos tu transferencia de $${amount} MXN.
Tu pedido está siendo procesado.

_Verificado contra Banxico_`;
  } else if (apiResult.status === 'pending') {
    message = `⏳ *Transferencia en proceso*

Tu pago aún no aparece en Banxico. Esto puede tomar unos minutos.
Por favor reenvía el comprobante en 10 minutos.`;
  } else {
    message = `❌ *No pudimos confirmar tu pago*

Verifica que el comprobante sea claro y que la transferencia sea al número de cuenta correcto.

Si crees que es un error, contacta a nuestro equipo.`;
  }

  await fetch('https://api.ycloud.com/v2/whatsapp/messages', {
    method: 'POST',
    headers: {
      'X-API-Key': process.env.YCLOUD_API_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      to: phone,
      type: 'text',
      text: { body: message }
    })
  });
}

    Lo que el cliente experimenta

    Desde el lado del cliente, la experiencia es fluida y profesional:

    1. Hace la transferencia en su banco.
    2. Abre WhatsApp y manda la captura del comprobante.
    3. En menos de 15 segundos recibe la confirmación automática.
    4. No espera a que nadie lo atienda.

    Para un negocio que vende las 24 horas o que tiene picos de demanda, esa respuesta inmediata marca una diferencia real en la experiencia del cliente.

    Casos de uso reales

    • Ventas por catálogo en WhatsApp: el cliente elige, paga y recibe confirmación sin que intervienes.
    • Reservaciones: el bot confirma el anticipo y bloquea el lugar automáticamente.
    • Acceso a grupos o canales privados: el bot valida el pago y envía el link de acceso al instante.
    • Cursos y productos digitales: el alumno paga, el bot confirma y envía el material o credenciales.
    • Negocios con horario: el bot valida comprobantes fuera de tu horario — incluso a las 2am.

    Puntos técnicos importantes

    • Nunca guardes el API key en el código — usa variables de entorno para APICEP_API_KEY y YCLOUD_API_KEY.
    • HTTP 200 de apiCEP no garantiza que el pago sea válido — siempre verifica status === \"valid\" y validation.banxicoConfirmed === true antes de confirmar al cliente.
    • Las URLs del CEP expiran en 15 días — si quieres conservar el respaldo oficial, descarga el PDF o XML y guárdalo en tu servidor.
    • Para volumen alto, respeta 10 segundos entre solicitudes a apiCEP para evitar timeouts con Banxico.

    Recursos para construirlo

    | Herramienta | Para qué | Link |
    |---|---|---|
    | YCloud | WhatsApp API + coexistencia con tu número actual | ycloud.com/es |
    | apiCEP | Validación de comprobantes SPEI contra Banxico | apicep.cloud |
    | Documentación apiCEP | Todos los campos, bancos y códigos de error | apicep.cloud/documentacion |
    | Documentación API YCloud | Referencia completa para enviar y recibir mensajes | docs.ycloud.com |

    Planes de apiCEP — sin RFC, sin contratos

    | Plan | Precio | Validaciones | Vigencia |
    |---|---|---|---|
    | Bienvenida | Gratis | 50 | 30 días |
    | Básico | $100 MXN | 200 | 30 días |
    | Premium | $200 MXN | 800 | 30 días |
    | Business | $400 MXN | 1,600 | 30 días |

    Solo necesitas un correo para registrarte. Sin RFC. Sin empresa registrada. Sin contratos.

    Crea tu cuenta gratuita en apicep.cloud y empieza con 50 validaciones sin costo.