Header manipulation (team)

Path: /settings → Header Manipulation tab

Team-scoped header manipulation configs let your team add, remove, or modify SIP headers on calls through your endpoints. These are separate from the default platform-wide configs maintained by superadmins (see Admin settings → Header manipulation).

AccessADMIN+

Configuration fields

Field	Required	Description
Configuration Name	Yes	Friendly name.
Description	No	What this config does.
Enabled	Yes	Master toggle.

Each config has one or more rules:

Field	Required	Description
Direction	Yes	Incoming (call enters) or Outgoing (call forwarded).
Action	Yes	Add / Remove / Modify.
Header Name	Yes	e.g. X-Custom-ID, P-Asserted-Identity.
Value / Pattern	Conditional	Value (Add) or regex (Modify / Remove).
Condition	No	Optional match condition.

Default vs team configs

• Default configs are platform-wide and applied globally; they appear in Team overview but cannot be edited here.
• Team configs apply only to your team's base numbers.
• Both can be active on the same base number — defaults are processed first.

Examples

Add a tracking header on outgoing calls

Field	Value
Direction	Outgoing
Action	Add
Header Name	X-Team-Source
Value	my-team-name

Genesys BYE metadata (DE-style)

Bot hangup already sends X-Genesys-* headers. Add a fixed environment header that the bot does not send:

Field	Value
Direction	Outgoing
Action	Add
Header Name	X-VGW-Environment
Value	vgw-preprod-de-c1

Collab / GR Refer-To query params

For on-prem Collab REFER, put k/v pairs on the transfer action as transferSipHeaders or as Refer-To query params (ANI_TRANS, handover_queue, …). Header-manipulation Modify can escape or rewrite Refer-To when the vendor needs a composed URI. Worked Genesys FQDN/TGRP URIs are on Genesys Cloud BYOC.

Strip a header on incoming calls

Field	Value
Direction	Incoming
Action	Remove
Header Name	P-Early-Media

Workflows

Create a config

1. Click Create.
2. Enter name, description, rules.
3. Enable the config.
4. Save.
5. Assign the config to a base number in Team overview.

Edit a config

Open the config, modify rules / metadata, save.

Screenshotguide/team-admin/header-manipulationneeds_review

Settings → Header Manipulation tab

Highlight: config list with name, rules count, enabled toggle; rule editor with direction / action / header / value

Reason: TelWeb v0.9.14 i18n and UI refactors changed labels/layout; screenshot needs visual review.

See also

• Team overview — assign configs to base numbers.
• TelPro operations — Kamailio is where these rules execute.