Custom Tags in CDR Reports

IMPORTANT:

Details in this document are for reference only and are unsupported by the Flowroute support staff.
Please use as purely reference material; we make no guarantees that this information is correct, or will not harm your system. Please be careful and always keep a backup of anything before you make changes, or alter settings.

The custom tag field on Call Detail Records (CDRs) is populated from the optional X-Tag SIP header field, which you can specify on each outbound call. The maximum length you may use for this field is 32 characters; anything longer will be truncated. You can populate the contents of the custom tag dynamically using variables if you're a savvy user for your respective system. This allows you to tag CDRs with your internal customer IDs, calling campaigns, etc.

This article describes creating custom tags for Asterisk, and FreeSWITCH.

Asterisk:

Add the following line to your dial plan before the Dial() command to tag your calls with a custom tag. In the following example, bob is added as a custom tag.
```
SIPAddHeader(X-Tag: bob)
```

FreeSWITCH:

Add the following to your dial plan XML for outbound calls to add the custom tag. In the following example, bob is added as a custom tag.
```
sip_h_X-Tag=bob
```

For inbound calls, add the following for the custom tag. In the following example, bob is added as a custom tag.
```
sip_rh_X-Tag=bob
```

NOTE: Additional information regarding the channel variable can be found on FreeSWITCH's Channel Variables wiki page.