Custom Header Searching and Correlation

This article describes the process and steps requires to extract custom SIP X-headers for search and correlation purposes.

1. Add Custom Header in heplify-server

Edit /etc/heplify-server.toml

add custom header information

AlegIDs               = ["XCallID"] # For Correlation
ForceALegID           = true
CustomHeader          = ["X-CID","XCallID"] # Custom Header

if you are running a docker container, add custom headers by setting an environment variable

"HEPLIFYSERVER_CUSTOMHEADER=X-CID,XCallID"

restart heplify-server

systemctl restart heplify-server.service

2. Add Mappings in homer-app

Go to settings in homer UI and click on mappings, Edit profile 'call' with HEP ID '1'.

Add the following at end of Field Mapping

.
.
.
    },
    {
        "id": "data_header.X-CID",
        "name": "X-CID",
        "type": "string",
        "index": "none",
        "form_type": "input",
        "position": 25,
        "skip": false,
        "hide": true
    },
    {
        "id": "data_header.XCallID",
        "name": "XCallID",
        "type": "string",
        "index": "none",
        "form_type": "input",
        "position": 26,
        "skip": false,
        "hide": true
    }
]

Like this

3. Call SIP Search Widget Settings

Go to Home screen of homer. Eidt settings of Call SIP Search widget.

Move X-CID and XCallID to active list.

4. Search with Custom Header

now you will be able to search with custom Header field.

Note: Custom Header search will work new calls only.