For standard procedures or verification, you might want to modify the Caller ID of incoming calls so you can identify them better. For this, you can use the CID Modifiers module. With this module, you are able to manipulate the Caller ID information for incoming calls so you can change it to whatever you need.
A common use is to add information to know the inbound route or trunk the call is coming from, or the DID the caller dialed to reach us. This way we can utilize the appropriate salutation for the incoming call.
To create your CID modifiers you must go to PBX > Incoming Call Tools > CID Modifiers. There are three types of Sources for the manipulation of CID information. Static, which is the standard way, by defining a hard-coded way to manipulate the CID information. MySQL to perform a MySQL query to modify the CID information based on the MySQL response. And finally, HTTPS/HTTP Request, so the CID information is based on the response.
First, we must enter a Description to identify this CID Modifier. For a static CID modifier, we have CID Number and Name Settings. For the CID Number, you can enter how many characters to Skip, the total length of characters you are keeping, any characters or digits to Prepend before the CID Number, and any characters or digits to Append after the CID Number.
For the CID Name Settings, you can Prepend anything before the CID Name, Append anything after the CID Name, and outright Replace what the CID Name is.
Below the CID Number and Name settings, you have a Simulation section. This section allows you to enter sample CID information so you can see how this is modified.
You can then Save and Apply Changes. CID Modifiers can then be added to Inbound Routes under PBX > Calls Routing > Inbound Routes. This will apply the CID modifier through every incoming call that goes through this Inbound Route.
For MySQL and HTTP/HTTPS requests, you can use the following variables for your queries.
- [CIDNUM] – This will return the Caller ID Number.
- [CIDNAME] – This will return the Caller ID Name.
This type of Source also provides the necessary fields for you to establish your connection.
A sample MySQL query can be as follows.
select cidname, cidnumber from customer where phone = ‘[CIDNUM]’ The response should return the cidname and cidnumber columns for the CID information to be modified.
Similarly with HTTPS/HTTP requests. A sample query can be as follows.
https://mycrm.com/cid.php?caller=[CIDNUM]&callername=[CIDNAME]The URL execution must return a result in JSON format containing cidname and cidnumber attributes in order to modify the CID information.
You will now have the Caller ID information just how you need it, and operate following your standards and information handled.
