Settings

API credentials are configured via environment variables

Copy .env.example to .env and set KALEM_API_TOKEN, KALEM_AGENT_ID, and KALEM_BASE_URL. Without these, all outbound calls return a safe simulated response.

Integration URLs

Set your public VPS domain below. Copy each URL and register it in your AI voice platform.

Register this in your AI voice platform → Agent → Webhooks. The agent posts call lifecycle events here.

GET tool — agent calls this at call start to load the customer profile. Param: phone (query string).

GET tool — agent calls this to list the customer's saved billers. Param: cif (query string).

POST tool — agent calls this to execute a bill payment. Body: { cif, billerId, amount }.

POST tool — agent calls this to transfer funds to a beneficiary. Body: { cif, toBeneficiaryId, amount }.

Test Outbound Call

Triggers a test outbound call for UC-V01. Returns a simulated response if credentials are not set in .env.