Notify & Welcome

Dua endpoint utility: broadcast event Socket.IO dan generate welcome message.

POST /api/notify-new-message

Broadcast req.body.data ke seluruh Socket.IO client melalui event newMessage.

Handler: controllers/aiAgentController.js — notifyNewChat

Auth: JWT Bearer wajib (atau IP allowlist bypass)

Request

{
  "data": {
    "message": "payload bebas"
  }
}

Response

Notification send to client

Response adalah text, bukan JSON.

POST /api/generate_welcome

Generate welcome message berdasarkan store dan agent personality.

Handler: controllers/mainController.js — generateWelcomeMessagge

Auth: JWT Bearer wajib (atau IP allowlist bypass)

Model: gpt-4o-mini, temperature 0.8

Request

Contoh request

{
  "store_id": "store-1",
  "agent_id": "agent-1",
  "device_id": "device-1"
}

Response (HTTP 201)

{
  "status": 201,
  "message": "success",
  "data": {
    "welcome_message": "...",
    "cost_request": "$0.000000"
  }
}

Catatan

• generate_welcome mencatat token/cost ke response (cost_request), tapi tidak ke log_request_openai (atau tercakup penuh)
• notify-new-message tidak validasi shape data — payload bebas diteruskan ke Socket.IO
• Response shape berbeda antara dua endpoint — notify return text, welcome return JSON

Kembali ke

• API Reference Index — daftar semua grup
• Conventions — Socket.IO behavior