360Bots
Les bots alimentent les menus, flows, coques OTP et services framework partenaires.
Lister les bots
GET /api/v1/bots
{
"bots": [
{
"code": "portail",
"name": "SEED Portail",
"runtime_mode": "local",
"partner": { "code": "seed", "name": "SEED" }
}
]
}
Créer un bot
POST /api/v1/bots
{
"code": "support",
"name": "Support bot",
"runtime_mode": "service",
"channel_inapp": true
}
Détail d'un bot
GET /api/v1/bots/{code}
Inclut menus / flows / actions lorsque runtime_mode=local.
Sessions
GET /api/v1/bots/{code}/sessions
Inspecter les sessions actives et le contexte (ops / debug).
Service framework
Service HTTP géré par le partenaire pour la logique métier :
| Endpoint | Objectif |
|---|---|
GET /api/v1/bot-framework | Configuration actuelle |
PUT /api/v1/bot-framework | Définir service_base_url, auth, chemins |
Lorsque runtime_mode=service, MorisBox appelle vos endpoints /start et /input et mappe les réponses en événements client.
Invitation flow
POST /api/v1/bots/{code}/flows/{flow_code}/invite - voir Flows.
Identifiants par bot
Chaque bot a un token bot (hashé) et un secret webhook (HMAC).
Voir Identifiants bots et webhooks pour le modèle de sécurité complet et l'API.
