VoIP, Linux, Security & much more fun
If you need any help regarding these subjects do not hesitate about sending me a text
fusionpbx-cnam.png

CIDLookup is the FreeSWITCH module who handles the Name Caller automatic setting. This mean that when an incoming call happens, mod_cidlookup will handle and set the correct name. This way, when the extension rings, you won't see only a number, but a name as well.

Mod_cidlookup has many capabilities, it can consult a database in two levels and it can ask a WEB based service. In this article, I will explain the last one.

For starters, you must get an account in OpenCNAM. If you get a paid one you will get more accuracy.

Configuring FreeSWITCH

Edit your cidlookup.conf.xml file and do the following:

  1. Add or edit this line:
    <param name="url" value="https://api.opencnam.com/v3/phone/+${caller_id_number}?account_sid=SID_TOKEN&auth_token=AUTH_TOKEN"/>
  2. If you are not using the database capability, comment out the odbc-dsn line to avoid annoying warnings.

After that you need to load or reload the module: load mod_cidlookup

Using de CidLookup

To activate it, you may need to add this line in your dialplan configuration:

<actionapplication="set"data="effective_caller_id_name=${cidlookup(${caller_id_number})}"/>

FusionPBX Configuration

Best way to do this is by doing an incoming route with the following characteristics:

  • condition: is context public?
  • condition: is caller number longer than 11 digits?
  • action: set call_direction=inbound
  • action: set effective_caller_id_name=${cidlookup(${caller_id_number})}

Side Effect

Using this method forces a syncronous call. This means that FreeSWITCH will wait until the CID lookup is finished. If for a reason there is a problem there and connection does not answer, you will be stuck.

Good Luck!

blog comments powered by Disqus
If you need more help than the free one provided here...