Communication: hbf-console

1-hop view of how this service communicates with its siblings. For the full system view, see service-communication.md.

Calls Out To

Service	Protocol	Purpose	Key calls / queues
hbf-core	REST API (REACT_APP_API_CORE_URL)	Organizations, tenants, users, auth, dashboard, analytics, audit logs, knowledge bases, chat sessions, integrations, settings	Primary backend for all console operations
hbf-lcm	REST API + Socket.IO (REACT_APP_API_LIVECHAT_URL)	Live chat requests, conversations, notes, tags, messages, settings	Socket.IO for real-time agent events
hbf-media-manager	REST API (REACT_APP_API_MEDIA_URL)	Media file CRUD	Upload, list, delete media
hbf-notifications	SSE + REST API (REACT_APP_API_NOTIFICATIONS_URL)	Real-time push notifications, notification CRUD	EventSource on /organizations/{orgId}/notifications/events?userId={userId}
hbf-reports	REST API (REACT_APP_API_REPORTS_URL)	Scheduled analytics reports	Report schedule management
hbf-nlp	REST API (REACT_APP_API_NLP_SERVICE_URL)	NLP pipeline configuration	Confidence: medium
hbf-topic-modeller	REST API (REACT_APP_API_TOPIC_MODELLER_URL)	Topic modeling	Confidence: medium
hbf-messenger-profile	REST API (REACT_APP_API_MESSENGER_PROFILE_URL)	Messenger integration profile	Confidence: medium
hbf-data-manager	REST API (REACT_APP_API_DATA_MANAGER_URL)	Data management	Confidence: medium
hbf-webchat	URL embed (REACT_APP_API_WEBCHAT_URL)	Webchat script URL embedded in deployment snippet (getDeploymentSnippet)	Static URL reference only
hbf-knowledge-manager	REST API (REACT_APP_API_KNOWLEDGE_MANAGER_URL)	Knowledge base management and webhook configuration	store/knowledgeBases/knowledgeBasesApi.js
hbf-scheduler	REST API (REACT_APP_API_SCHEDULER_URL)	Scheduled flows	store/scheduledFlows/scheduledFlowsApi.js

Called By

Browser application. Not called by other services.

Contracts

Inbound

None. This is a React SPA served to the browser.

Outbound

Socket.IO Connection (hbf-lcm)

• Connects to REACT_APP_API_LIVECHAT_URL
• Query: organizationId={orgId}
• Auth: Bearer token in header
• Events: message, event (live chat presence, conversations)

SSE Connection (hbf-notifications)

• Connects via EventSourcePolyfill to /organizations/{orgId}/notifications/events?userId={userId}
• Auth: Bearer token in header

Env Vars

Env Var	Target Service
REACT_APP_API_CORE_URL	hbf-core
REACT_APP_API_LIVECHAT_URL	hbf-lcm
REACT_APP_API_MEDIA_URL	hbf-media-manager
REACT_APP_API_NOTIFICATIONS_URL	hbf-notifications
REACT_APP_API_REPORTS_URL	hbf-reports
REACT_APP_API_NLP_SERVICE_URL	hbf-nlp
REACT_APP_API_TOPIC_MODELLER_URL	hbf-topic-modeller
REACT_APP_API_MESSENGER_PROFILE_URL	hbf-messenger-profile
REACT_APP_API_DATA_MANAGER_URL	hbf-data-manager
REACT_APP_API_WEBCHAT_URL	hbf-webchat (webchat script URL embedded in deployment snippet)
REACT_APP_API_KNOWLEDGE_MANAGER_URL	hbf-knowledge-manager
REACT_APP_API_SCHEDULER_URL	hbf-scheduler

Flows Involving This Service

Frontend application. Indirectly involved in all user-initiated flows.