Technical documentation

Natalia Analytics Documentation

Connect your Alcatel OmniPCX Enterprise (OXE) or Office (OXO) PBX to Natalia. Collect Call Detail Records, analyze traffic, costs, missed calls and abuse through a conversational AI.

Cloud-managed, on-prem-trusted

Lightweight appliance on your premises, intelligence in the cloud. Outbound HTTPS only, no inbound port.

Ask questions in plain language

No more spreadsheets or scheduled reports. A conversational AI that answers your questions in natural language.

GDPR by design + 15-min install

Pseudonymized data, EU hosting, installation in 15 minutes. Compliance from first boot.

Architecture

Natalia Analytics combines a lightweight on-premise agent deployed on your network that collects call records from your PBX, and the Natalia cloud that receives, stores and exposes them through a conversational AI interface over a secure channel.

flowchart LR
    subgraph LAN["Your premises"]
        PBX["Alcatel PBX<br/>OXE / OXO"]
        AGENT["Natalia agent VM"]
    end
    subgraph CLOUD["Natalia Cloud"]
        API["Natalia API"]
        MCP["Analytics AI chat"]
    end
    USER["Your teams"]
    PBX -.->|Billing tickets| AGENT
    AGENT -->|Outbound encrypted connection| API
    API --> MCP
    USER -->|Secure connection| MCP

    click PBX "/en/documentation/natalia-analytics/alcatel-pbx-prerequisites" "Alcatel PBX prerequisites"
    click AGENT "/en/documentation/natalia-analytics/installation" "Install the agent VM"
    click API "/en/documentation/natalia-analytics/security" "Security overview"
    click MCP "/en/analytics" "Discover Natalia Analytics"
    click USER "/en/contact" "Request a demo"

Collection pipeline

The agent collects and processes billing tickets from your PBX every 30 minutes, then pushes them to Natalia Cloud over a secure channel. On network incident, tickets are queued and retransmitted automatically.

flowchart TD
    A["Alcatel PBX"] -->|Regular collection| B["Natalia agent VM"]
    B -->|Processed tickets| G["Secure transmission"]
    G -->|Success| H["Natalia Cloud"]
    G -->|Network unavailable| I["Automatic retry"]
    I -.->|When network is back| G

    click A "/en/documentation/natalia-analytics/alcatel-pbx-prerequisites" "PBX prerequisites"
    click B "/en/documentation/natalia-analytics/installation" "Install the agent VM"
    click H "/en/documentation/natalia-analytics/security" "Security overview"
    click I "/en/documentation/natalia-analytics/troubleshooting" "Troubleshooting"

OXO authentication

The Natalia agent authenticates against your OXO PBX over a secure channel, then pulls new billing tickets every 30 minutes. The session token is renewed without manual intervention.

sequenceDiagram
    participant A as Natalia agent VM
    participant O as Alcatel OXO PBX
    participant N as Natalia Cloud

    A->>O: Secure authentication
    O-->>A: Session token valid 1h
    loop Every 30 min
        A->>O: Fetch new tickets
        O-->>A: Billing tickets
        A->>N: Secure transmission
        N-->>A: Confirmation
    end
    Note over A,O: Automatic renewal<br/>of session token