Communication: hbf-client-integrations

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

Calls Out To

Platform

Service	Protocol	Purpose	Key calls / queues
hbf-core	HTTP Bearer	Subscribers, chat sessions, bot deployments, activities, transcripts	Via CoreClientService
bot-v5 (cb-bot-api)	HTTP Bearer	Flow events	POST https://bot-v5.helvia.io/api/events

External Integrations

Module	External Service	Protocol	Purpose
snappi	Pobuca Measure	HTTP REST	Conversation analytics upload
snappi	Microsoft Dynamics 365	HTTP REST OAuth2	CRM record sync
novibet	Zendesk	HTTP REST Basic Auth	Support ticket creation
novibet	Genesys Cloud	HTTP REST (SDK)	Live-agent handoff, CSAT
aia	SITA AMS	SOAP	Flight data (departures, arrivals)
aia	Facebook Messenger	HTTP Graph API v22	Customer messaging
aia	AWS S3	HTTP SDK	Flight image storage
sixt	Wheelsys	SOAP	Rental vehicle lookup
sixt	Infobip	HTTP REST	Driver greetings (Viber/WhatsApp/SMS)
generali	GS400 Billing API	HTTP REST	Due payment queries
generali	Genesys Cloud	HTTP REST (SDK)	Schedule callbacks
actionLine	Microsoft Graph API	HTTP REST OAuth2	Calendar availability, Teams meetings
kelly-ai-agents	Kelly AI Agents API	HTTP REST	AI agent bridge
viva	Viva API	HTTP REST	Integration
helix	Helix API	HTTP REST	Integration
esy	Esy API	HTTP REST	Integration

Called By

Service	Protocol	How
hbf-bot	HTTP (HBFGuard JWT)	All module endpoints

Contracts

Inbound

All endpoints require HBFGuard + OrgMemberGuard.

• POST /snappi/:orgId/conversations -- upload conversation
• POST /snappi/:orgId/incidents -- create CRM incident
• POST /novibet/:orgId/session-ticket -- create Zendesk ticket
• POST /aia/flights -- search flights
• POST /sixt/:orgId/rentalDetails -- vehicle lookup
• POST /sixt/:orgId/processCheckoutGreeting -- cron-triggered checkout greeting
• POST /generali/:orgId/due-payments -- query payments
• POST /generali/:orgId/create_callback -- schedule Genesys callback
• POST /actionLine/:orgId/available-slots -- calendar availability
• POST /actionLine/onlineMeetings -- create Teams meeting
• POST /cb-bot-api/process -- trigger bot flow

Outbound

• hbf-core: HTTP Bearer for subscriber, session, deployment, activity, and transcript operations
• bot-v5: POST https://bot-v5.helvia.io/api/events with Bearer token
• External services: per module (see External Integrations table above)

Env vars:

• CORE_URL -> hbf-core
• CORE_TOKEN -> hbf-core
• POBUCA_URL -> Pobuca
• CRM_URL -> Dynamics 365
• ZENDESK_BASEURL_* -> Zendesk
• AIA_SOAP_URI -> SITA AMS
• SIXT_INFOBIP_BASE_URL -> Infobip
• GENERALI_GS400_BASE_URL -> GS400

Flows Involving This Service

(Integration layer. No primary flow. Called on-demand during message processing.)