360Bots
Os bots alimentam menus, fluxos, envelopes OTP e serviços do framework dos parceiros.
Listar os bots
GET /api/v1/bots
{
"bots": [
{
"code": "portail",
"name": "SEED Portail",
"runtime_mode": "local",
"partner": { "code": "seed", "name": "SEED" }
}
]
}
Criar um bot
POST /api/v1/bots
{
"code": "support",
"name": "Support bot",
"runtime_mode": "service",
"channel_inapp": true
}
Detalhes de um bot
GET /api/v1/bots/{code}
Inclui menus / fluxos / ações quando runtime_mode=local.
Sessões
GET /api/v1/bots/{code}/sessions
Inspecione as sessões ativas e o contexto (operações / depuração).
Framework de serviço
Serviço HTTP gerenciado pelo parceiro para a lógica de negócio:
| Endpoint | Objetivo |
|---|---|
GET /api/v1/bot-framework | Configuração atual |
PUT /api/v1/bot-framework | Definir service_base_url, autenticação e caminhos |
Quando runtime_mode=service, o MorisBox chama seus endpoints /start e /input e mapeia as respostas para eventos do cliente.
Convite para um fluxo
POST /api/v1/bots/{code}/flows/{flow_code}/invite: consulte Fluxos.
Credenciais por bot
Cada bot tem um token de bot (com hash) e um segredo de webhook (HMAC).
Consulte Credenciais de bots e webhooks para conhecer o modelo de segurança completo e a API.