Plateformes
MorisBox est une seule API partenaire qui atteint les utilisateurs sur plusieurs surfaces client et canaux de livraison. Cette page est le catalogue de tout ce qui est disponible aujourd'hui.
En un coup d'œil
| Couche | Description | Qui l'utilise |
|---|
| Partner API | API REST (/api/v1) pour messages, comptes, modèles, bots, webhooks | Votre backend |
| Partner Hub | Console web pour clés, bots, modèles, réponses support | Opérateurs partenaires |
| Partner Docs | Ce site - référence API et guides d'intégration | Développeurs |
| App mobile | App utilisateur final native iOS / Android (Expo) | Utilisateurs finaux |
| Application Client | App web progressive (même produit que le mobile) | Utilisateurs finaux |
| Realtime | Push en direct (boîte, chat, diffusions) | Clients mobile / Application Client |
| Canal in-app | Livraison dans le mobile / Application Client MorisBox | Chemin principal |
| Canal WhatsApp | Repli / portée lorsque l'in-app est indisponible | Repli |
| Canal SMS | Repli final (OTP, alertes critiques) | Repli |
Un seul appel d'envoi ; MorisBox choisit le meilleur canal dans l'ordre.
Canaux de livraison
Configurés par partenaire comme une chaîne ordonnée (surchargeable par message). Ordre de production typique :
| Ordre | Code canal | Surface | Usage typique |
|---|
| 1 | inapp | Mobile + Application Client MorisBox | Messages hub, flows, newsletters, chat - UX la plus riche |
| 2 | whatsapp | WhatsApp | Utilisateur hors ligne / sans app ; alertes adaptées aux modèles |
| 3 | sms | SMS | OTP, comptes non revendiqués, texte de dernier recours |
Notes de comportement
| Sujet | Règle |
|---|
| Compte revendiqué | Préférer inapp lorsque l'utilisateur a revendiqué MorisBox |
| Non revendiqué | L'in-app est souvent ignoré (not_claimed) → WhatsApp / SMS |
| OTP | Peut forcer SMS / WhatsApp (pas encore de session app) |
| Timeouts | Par étape ; en cas d'échec ou timeout → canal suivant |
| Rappel hors ligne | Après livraison in-app, si l'utilisateur est hors ligne → WhatsApp/SMS « nouveau message dans MorisBox » (sans corps E2E) |
| Idempotence | La même idempotency_key ne refait pas de fan-out en doublon |
Voir Concepts clés pour le cycle de vie des comptes et Messages pour les payloads d'envoi.
Plateformes utilisateur final
Les utilisateurs s'authentifient avec téléphone + OTP. Les partenaires rattachés apparaissent dans leur hub.
Mobile (iOS / Android)
| |
|---|
| Produit | App native MorisBox (Expo) |
| Auth | OTP sans mot de passe |
| Fonctionnalités | Hub partenaire, messages autonomes, médias, newsletters HTML, CTA lien, flows interactifs, bots, conversations support, épingler / non lu, mises à jour realtime |
| Idéal pour | UX complète compatible hors ligne, clients prêts pour le push, consommateurs en production |
Application Client (web)
| |
|---|
| Produit | Même produit utilisateur final en progressive web app |
| Auth | OTP sans mot de passe |
| Fonctionnalités | Même modèle hub que le mobile : messages, flows, bots, support, newsletters |
| Idéal pour | Accès immédiat sans install store ; démos partenaires et utilisateurs desktop |
Ce que voient les utilisateurs (modèle hub)
| Zone | Objectif |
|---|
| Messages | Éléments partenaires autonomes (texte, média, lien, HTML, cartes flow) - pas un fil de chat |
| Formulaires / bots | Flows multi-étapes interactifs et menus bot |
| Conversations | Fils support démarrés par l'utilisateur |
L'API partenaire POST /messages cible toujours le hub, pas le chat support. Détails : UI messages et expériences.
Plateformes partenaires
Partner API
| |
|---|
| Base | https://api.morisbox.com/api/v1 (sandbox) |
| Auth | Authorization: Bearer <api_key> |
| Capacités | Envoyer des messages (tous les types de contenu), comptes et rattachement, modèles, diffusions, conversations (agent), bots, webhooks, sandbox |
Carte complète : API overview · Démarrage rapide · Authentication.
Partner Hub
| |
|---|
| Produit | Console web pour les opérateurs |
| Tâches typiques | Clés API, modèles, paramètres de canaux, config bot / flow, réponses support, téléphones sandbox, conformité |
| URL (sandbox) | https://partner.morisbox.com |
Dashboard développeur
Documentation partenaire
| |
|---|
| Produit | Partner docs (docs.morisbox.com/partners) + Developer docs (docs.morisbox.com/developers) |
| Audience | Ingénieurs d'intégration (partenaires et développeurs) |
| Périmètre | REST, types de médias, newsletters, flows, bots, webhooks, développeurs, sandbox |
Plateforme realtime
Mises à jour en direct pour les clients utilisateur final (nouveaux messages hub, événements de conversation, livraison de diffusion).
| |
|---|
| Transport | Socket.IO via le edge realtime |
| Clients | Mobile + Application Client (sessions utilisateur authentifiées) |
| Modèle d'échelle | Passerelles sans état ; rooms par compte utilisateur |
| Impact partenaire | Vous envoyez toujours une fois via REST ; les clients se rafraîchissent en direct sans polling |
Vous n'appelez pas la couche realtime depuis les backends partenaires pour les envois normaux - la Partner API suffit.
Types de contenu × plateformes
content_type | In-app (mobile / Application Client) | WhatsApp | SMS |
|---|
text | Complet | Oui (texte) | Oui (tronqué) |
image | Visionneuse complète | Dépend du fournisseur | Lien / skip |
document | Télécharger / ouvrir | Dépend du fournisseur | Lien / skip |
audio | Lecteur | Dépend du fournisseur | Lien / skip |
video | Lecteur | Dépend du fournisseur | Lien / skip |
link | Carte CTA | Texte + URL | URL |
html | Lecteur newsletter HTML complet | Résumé / lien | Résumé / lien |
flow | UI multi-étapes interactive | Texte d'invitation + deep link | Texte d'invitation |
system | Avis plateforme | Rare | Rare |
L'expérience la plus riche est toujours in-app. Concevez les payloads pour l'in-app d'abord ; gardez un texte court compatible SMS pour le repli de dernier kilomètre.
Plateformes interactives (flows et bots)
Matrice des plateformes (qui parle à quoi)
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
Synthèse de disponibilité
| Plateforme | Statut | Notes |
|---|
| Partner REST API | Disponible | Chemin de production pour les intégrations |
| Partner Hub | Disponible | Ops et configuration |
| Partner Docs | Disponible | Ce site |
| App mobile | Disponible | iOS / Android via Expo |
| Application Client | Disponible | Même famille de produit que le mobile |
| Push realtime | Disponible | Boîte / chat / diffusions en direct |
Canal inapp | Disponible | Livraison principale |
Canal whatsapp | Disponible | Adaptateur / fournisseur configuré par déploiement |
Canal sms | Disponible | Adaptateur / fournisseur configuré par déploiement |
| Clés sandbox | Disponible | Tests d'envoi sans risque - Sandbox |
| E2EE in-app | Disponible | Conversations + payloads hub scellés - Chiffrement E2E |
| Canaux e-mail / push natif | Feuille de route | Pas encore dans la chaîne par défaut |
La connectivité fournisseur pour WhatsApp et SMS dépend de votre environnement (clés live vs stubs locaux). Le comportement de la chaîne de repli est le même dans tous les environnements.
Choisir la bonne surface
| Objectif | Utiliser |
|---|
| Envoyer OTP / alerte critique | Partner API → chaîne avec priorité SMS/WA selon le besoin |
| Newsletter riche ou média | content_type=html / image / video → in-app d'abord |
| Formulaire multi-étapes (style SEED) | Invitation flow + runner flow |
| Support continu | L'utilisateur démarre une conversation ; l'agent répond via Hub / API |
| Annonce en masse | API Diffusions |
| Automatiser des menus | 360Bots (runtime local ou service) |
Étapes suivantes
