Producto propio · En producción

Wapi

Middleware multi-tenant para la WhatsApp Cloud API

Wapi es la capa de integración y orquestación que se coloca sobre la Cloud API oficial de Meta. Sus aplicaciones envían y reciben conversaciones de WhatsApp sin lidiar con webhooks, reintentos, límites de ritmo ni el ciclo de vida de las plantillas — con un motor de flujos, bots de IA y colas de atención humana encima.

.NET 10EF CorePostgreSQL / SQLiteDockerAzure

Solicitar una demo

582

Pruebas automatizadas

~158

Endpoints de API

Canales de mensajería

Por qué existe

La Cloud API es una API, no un producto

Meta entrega el transporte. La plantilla rechazada, el reintento, la ventana de 24 horas, el estado de entrega y el hilo de conversación son problema suyo.

Cada integración se rehace desde cero

Un webhook mal procesado pierde mensajes; un reinicio del servidor pierde la cola de envío. Resolverlo bien cuesta meses de trabajo que no diferencian a su negocio.

El bot y el humano no se hablan

Lo habitual es un bot por un lado y un agente con el teléfono por otro, sin historial compartido ni criterio de cuándo escalar.

Qué hace Wapi

Mensajería completa

Texto, plantillas (incluidas de carrusel y ofertas), media, menús, formularios nativos (Flows), catálogo de productos, ubicación, reacciones y respuestas citadas.

Entrega fiable

Reintentos ante fallos temporales de Meta, control de ritmo por número y envío encolado que sobrevive a un reinicio: nada se pierde en el camino.

Flujos y bots con IA

Motor conversacional con estado por contacto: menús, captura de datos y nodos de IA que responden sobre su base de conocimiento y consultan sus sistemas mediante funciones.

Atención humana

Colas con agentes, auto-asignación, transferencias, horario de atención, plazos de respuesta (SLA), respuestas rápidas y encuestas de satisfacción.

Campañas y CRM

Envíos masivos segmentados por etiquetas, programables y con seguimiento por destinatario, sobre una ficha 360° de cada contacto.

Aislamiento y cifrado

Filtros globales por tenant en el modelo de datos y secretos de Meta y OpenAI cifrados con AES-256-GCM en reposo.

Documentación

Módulo por módulo

Mensajería

Todo lo que la Cloud API permite enviar y recibir, con los errores de Meta ya interpretados en lenguaje entendible.

Plantillas de todos los tipos, incluidas carrusel y ofertas por tiempo limitado
Formularios nativos de WhatsApp (Flows) y catálogo de productos
Media, ubicación, fichas de contacto, reacciones y respuestas citadas
Reconoce todo lo entrante: botones de plantilla, pedidos, ubicaciones y respuestas de Flows
Envío encolado opcional que sobrevive a reinicios, con control de ritmo por número

Flujos conversacionales

Motor con estado por contacto. Se define el árbol de conversación y Wapi lleva a cada persona por él.

Menús de botones (hasta 3), listas (hasta 10) y texto numerado como alternativa
Nodos de captura de datos para formularios paso a paso
Nodos de IA con OpenAI, con clave por tenant y alternativa global
Escalado a humano por palabra clave, por decisión del modelo o desde una opción de menú

IA con contexto propio

El bot responde sobre lo que usted sabe, no sobre lo que el modelo imagina.

Base de conocimiento con búsqueda semántica por tenant
Funciones que consultan sus sistemas en vivo (estado de pedido, saldo, cita)
Cuando no hay respuesta fiable, deriva en lugar de inventar

Atención humana y equipos

La bandeja de los agentes, con las reglas de operación que un equipo real necesita.

Colas por tenant con agentes asignados y carga visible en tiempo real
Reparto manual (claim) o auto-asignación round-robin
Horario de atención por cola, con zona horaria, horarios partidos y tramos que cruzan medianoche
Plazos de respuesta (SLA), respuestas rápidas y encuestas de satisfacción
Al retirar a un agente, sus conversaciones vuelven a la espera en vez de quedar huérfanas

Campañas

Envíos masivos de plantillas con control operativo y de coste.

Segmentación por etiquetas del CRM
Programación, pausa y reanudación
Seguimiento por destinatario individual
Conversaciones facturables de Meta desglosadas por categoría y por cuenta

CRM y métricas

El historial y los números que permiten dirigir el equipo.

Ficha 360° del contacto: datos, etiquetas, notas internas, actividad y estado del bot
Tiempo de primera respuesta y de resolución, en media, mediana y p90
Carga por agente y cumplimiento de SLA
Auditoría y exportación de datos por tenant

Casos de uso

Dónde encaja

Atención al cliente que no depende del horario

El bot resuelve lo repetitivo con su base de conocimiento y escala a un agente humano solo cuando hace falta, respetando el horario de atención y el SLA.

Notificaciones transaccionales

Su ERP, POS o sistema interno dispara un aviso — pedido listo, cita mañana, pago recibido — y Wapi lo entrega como plantilla aprobada, con reintentos.

Campañas segmentadas

Promociones y recordatorios de cobro a un segmento concreto de contactos, programados, con pausa y reanudación y el coste por conversación a la vista.

Una sola bandeja multicanal

Instagram y Messenger entran por los mismos flujos, las mismas colas y el mismo CRM que WhatsApp. El agente trabaja en un único sitio.

Cómo se integra en su entorno

API REST documentada con Swagger/OpenAPI y API keys por tenant
Webhooks salientes firmados, con reintentos, hacia sus sistemas
Streaming SSE para bandejas de agente en tiempo real
Funciones de IA que consultan sus APIs en lugar de improvisar
Alta guiada de clientes con Embedded Signup de Meta
Evento session.handoff para avisar a sistemas externos de cada derivación

Seguridad y aislamiento

Aislamiento por tenant con filtros globales en el modelo de datos: una consulta sin filtro no puede devolver datos de otro cliente
Tokens de Meta, app secrets y claves de OpenAI cifrados con AES-256-GCM en reposo
Permisos por rol y auditoría de acciones dentro de cada tenant
En producción la API aborta el arranque si las claves siguen siendo las de ejemplo
Webhooks entrantes verificados por firma e idempotentes ante reenvíos de Meta

Despliegue

Dónde puede vivir

Docker Compose

Un `docker compose up` levanta la API, el panel y la base de datos. Es la vía recomendada para empezar.

Azure Web App for Containers

Despliegue documentado paso a paso para producción gestionada, con almacenamiento en Azure Blob.

SQLite o PostgreSQL

SQLite para una instancia única sin instalar nada; PostgreSQL cuando hace falta levantar varias instancias en paralelo.

Almacenamiento a elegir

Archivos en disco local, Azure Blob Storage o AWS S3, según dónde viva el resto de su infraestructura.

Preguntas frecuentes

Lo que suelen preguntarnos

¿Wapi reemplaza a WhatsApp Business?

No. Una cuenta de WhatsApp Business (WABA) real la aloja Meta. Wapi no reimplementa WhatsApp: es la capa de integración y orquestación sobre la Cloud API oficial, y necesita su propia WABA.

¿Hay que migrar el número actual?

El número debe estar dado de alta en la Cloud API. El alta guiada con Embedded Signup permite que el cliente autorice desde un popup y el servidor haga el resto de la configuración.

¿Qué pasa si se reinicia el servidor a mitad de una campaña?

Nada se pierde. Los webhooks entrantes, los envíos encolados y los webhooks salientes se guardan en base de datos, y los workers reservan lo que procesan, de modo que varias instancias reparten la carga sin duplicarla.

¿Se puede usar solo para enviar notificaciones?

Sí. Los módulos son independientes: se puede usar únicamente la API de mensajería sin activar flujos, colas ni campañas.

¿Sirve para Instagram y Messenger?

Sí. Ambos canales funcionan sobre los mismos flujos, colas y CRM. Están cubiertos por pruebas automatizadas; la verificación contra los servicios reales de Meta sigue en el mapa de trabajo.

Siguiente paso

¿Quieres ver Wapi funcionando?

Agendamos una demo sobre su caso concreto y le decimos con franqueza si encaja o no.

Agendar demo

También desarrollamos

Factu

API de facturación electrónica de Costa Rica: clave, consecutivo, XML v4.4, firma XAdES, envío a Hacienda y entrega al cliente.