Plataformas
MorisBox es una única API para socios que llega a los usuarios mediante distintas interfaces de cliente y canales de entrega. Esta página reúne todo lo que está disponible actualmente.
Vista general
| Capa | Descripción | Quién la utiliza |
|---|
| Partner API | API REST (/api/v1) para mensajes, cuentas, plantillas, bots y webhooks | Su backend |
| Partner Hub | Consola web para claves, bots, plantillas y respuestas de soporte | Operadores del socio |
| Partner Docs | Este sitio: referencia de la API y guías de integración | Desarrolladores |
| Aplicación móvil | Aplicación nativa para usuarios finales en iOS / Android (Expo) | Usuarios finales |
| Application Client | Aplicación web progresiva (el mismo producto que la aplicación móvil) | Usuarios finales |
| Tiempo real | Actualizaciones en directo (bandeja, chat, difusiones) | Clientes móviles / Application Client |
| Canal in-app | Entrega en la aplicación móvil / Application Client de MorisBox | Ruta principal |
| Canal WhatsApp | Respaldo / alcance cuando in-app no está disponible | Respaldo |
| Canal SMS | Último respaldo (OTP, alertas críticas) | Respaldo |
Una sola llamada de envío; MorisBox selecciona el mejor canal en orden.
Canales de entrega
Se configuran por socio como una cadena ordenada (que puede sobrescribirse para cada mensaje). Orden habitual en producción:
| Orden | Código del canal | Interfaz | Uso habitual |
|---|
| 1 | inapp | Aplicación móvil + Application Client de MorisBox | Mensajes del hub, flows, newsletters y chat: la experiencia más completa |
| 2 | whatsapp | WhatsApp | Usuario sin conexión / sin aplicación; alertas adaptadas a las plantillas |
| 3 | sms | SMS | OTP, cuentas no reclamadas y texto como último recurso |
Notas de comportamiento
| Tema | Regla |
|---|
| Cuenta reclamada | Preferir inapp cuando el usuario haya reclamado MorisBox |
| No reclamada | In-app suele omitirse (not_claimed) → WhatsApp / SMS |
| OTP | Puede forzar SMS / WhatsApp (todavía no hay una sesión en la aplicación) |
| Tiempos de espera | Por etapa; si falla o se agota el tiempo → canal siguiente |
| Recordatorio sin conexión | Tras la entrega in-app, si el usuario no está conectado → WhatsApp/SMS: «nuevo mensaje en MorisBox» (sin cuerpo E2E) |
| Idempotencia | La misma idempotency_key no vuelve a producir una distribución duplicada |
Consulte Conceptos clave para conocer el ciclo de vida de las cuentas y Mensajes para los payloads de envío.
Plataformas para usuarios finales
Los usuarios se autentican mediante teléfono + OTP. Los socios vinculados aparecen en su hub.
Móvil (iOS / Android)
| |
|---|
| Producto | Aplicación nativa MorisBox (Expo) |
| Autenticación | OTP sin contraseña |
| Funcionalidades | Hub de socios, mensajes independientes, contenido multimedia, newsletters HTML, CTA con enlace, flows interactivos, bots, conversaciones de soporte, marcar como favorito / no leído y actualizaciones en tiempo real |
| Ideal para | Experiencia completa compatible sin conexión, clientes preparados para push y consumidores en producción |
Application Client (web)
| |
|---|
| Producto | El mismo producto para usuarios finales en forma de aplicación web progresiva |
| Autenticación | OTP sin contraseña |
| Funcionalidades | El mismo modelo de hub que en móvil: mensajes, flows, bots, soporte y newsletters |
| Ideal para | Acceso inmediato sin instalación desde una tienda; demostraciones para socios y usuarios de escritorio |
Lo que ven los usuarios (modelo del hub)
| Zona | Objetivo |
|---|
| Mensajes | Elementos independientes de socios (texto, contenido multimedia, enlaces, HTML y tarjetas de flow): no es un hilo de chat |
| Formularios / bots | Flows interactivos de varias etapas y menús de bot |
| Conversaciones | Hilos de soporte iniciados por el usuario |
La Partner API POST /messages siempre se dirige al hub, no al chat de soporte. Más información: Interfaz de mensajes y experiencias.
Plataformas para socios
Partner API
| |
|---|
| Base | https://api.morisbox.com/api/v1 (sandbox) |
| Autenticación | Authorization: Bearer <api_key> |
| Capacidades | Enviar mensajes (todos los tipos de contenido), gestionar cuentas y vinculaciones, plantillas, difusiones, conversaciones (agente), bots, webhooks y sandbox |
Mapa completo: Descripción general de la API · Inicio rápido · Autenticación.
Partner Hub
| |
|---|
| Producto | Consola web para operadores |
| Tareas habituales | Claves API, plantillas, parámetros de canales, configuración de bot / flow, respuestas de soporte, teléfonos de sandbox y cumplimiento |
| URL (sandbox) | https://partner.morisbox.com |
Panel para desarrolladores
Documentación para socios
| |
|---|
| Producto | Partner Docs (docs.morisbox.com/partners) + Developer Docs (docs.morisbox.com/developers) |
| Público | Ingenieros de integración (socios y desarrolladores) |
| Ámbito | REST, tipos de contenido multimedia, newsletters, flows, bots, webhooks, desarrolladores y sandbox |
Plataforma en tiempo real
Actualizaciones en directo para los clientes de usuarios finales (mensajes nuevos en el hub, eventos de conversación y entrega de difusiones).
| |
|---|
| Transporte | Socket.IO mediante el edge de tiempo real |
| Clientes | Aplicación móvil + Application Client (sesiones de usuario autenticadas) |
| Modelo de escalado | Pasarelas sin estado; rooms por cuenta de usuario |
| Impacto para el socio | Usted siempre envía una sola vez mediante REST; los clientes se actualizan en directo sin polling |
No llame a la capa de tiempo real desde los backends de socios para envíos normales: la Partner API es suficiente.
Tipos de contenido × plataformas
content_type | In-app (móvil / Application Client) | WhatsApp | SMS |
|---|
text | Completo | Sí (texto) | Sí (truncado) |
image | Visor completo | Depende del proveedor | Enlace / omitir |
document | Descargar / abrir | Depende del proveedor | Enlace / omitir |
audio | Reproductor | Depende del proveedor | Enlace / omitir |
video | Reproductor | Depende del proveedor | Enlace / omitir |
link | Tarjeta CTA | Texto + URL | URL |
html | Lector completo de newsletter HTML | Resumen / enlace | Resumen / enlace |
flow | Interfaz interactiva de varias etapas | Texto de invitación + deep link | Texto de invitación |
system | Aviso de la plataforma | Poco frecuente | Poco frecuente |
La experiencia más completa siempre es in-app. Diseñe primero los payloads para in-app; conserve un texto breve y compatible con SMS como respaldo de última milla.
Plataformas interactivas (flows y bots)
Matriz de plataformas (quién se comunica con qué)
Your systems
│ Partner API key
▼
Partner API ──────► routing (inapp → whatsapp → sms)
│ │
│ ├─► Mobile / Application Client (hub + realtime)
│ ├─► WhatsApp
│ └─► SMS
│
├─► Partner Hub (operators)
└─► Webhooks → your HTTPS endpoints
Resumen de disponibilidad
| Plataforma | Estado | Notas |
|---|
| Partner REST API | Disponible | Ruta de producción para las integraciones |
| Partner Hub | Disponible | Operaciones y configuración |
| Partner Docs | Disponible | Este sitio |
| Aplicación móvil | Disponible | iOS / Android mediante Expo |
| Application Client | Disponible | La misma familia de productos que la aplicación móvil |
| Push en tiempo real | Disponible | Bandeja / chat / difusiones en directo |
Canal inapp | Disponible | Entrega principal |
Canal whatsapp | Disponible | Adaptador / proveedor configurado según el despliegue |
Canal sms | Disponible | Adaptador / proveedor configurado según el despliegue |
| Claves de sandbox | Disponible | Pruebas de envío sin riesgo: Sandbox |
| E2EE in-app | Disponible | Conversaciones + payloads sellados del hub: Cifrado E2E |
| Canales de correo electrónico / push nativo | En la hoja de ruta | Todavía no forman parte de la cadena predeterminada |
La conectividad con los proveedores de WhatsApp y SMS depende de su entorno (claves Live frente a stubs locales). El comportamiento de la cadena de respaldo es el mismo en todos los entornos.
Elegir la interfaz adecuada
| Objetivo | Utilizar |
|---|
| Enviar un OTP / una alerta crítica | Partner API → cadena con prioridad para SMS/WA según la necesidad |
| Newsletter enriquecida o contenido multimedia | content_type=html / image / video → primero in-app |
| Formulario de varias etapas (estilo SEED) | Invitación a flow + runner de flow |
| Soporte continuo | El usuario inicia una conversación; el agente responde mediante Hub / API |
| Anuncio masivo | API de difusiones |
| Automatizar menús | 360Bots (runtime local o de servicio) |
Siguientes pasos
