How to configure GFI FAXmaker to use XCAPI

The information in this article applies to:

  • GFI FAXmaker for Exchange/SMTP 14

Article ID: KBID003492

Query keywords: XCAPI

Note: XCAPI is supported from GFI FAXmaker 14.3 Service Release 1 and later.

XCAPI is a software-only Fax over IP (FoIP) solution from TE-SYSTEMS. The following knowledgebase article explains how to install XCAPI on your GFI FAXmaker server and configure GFI FAXmaker to send and receive faxes using XCAPI.

Installing XCAPI

XCAPI needs to be purchased and downloaded directly from TE-SYSTEMS. More information can be found on the TE-SYSTEMS website. Installation instructions are provided once you download XCAPI.
 
http://www.te-systems.de/products/xcapi.php?sess_lang_ch=en

Configuring XCAPI

  1. Open the ‘XCAPI Configuration’
     
  2. Click on the ‘Click here to add a controller’ link under the ‘Controller’ section.

  3. In the ‘Controller Wizard’ select ‘Add Voice-over-IP controller (VoIP)’ and click on the ‘Next’ button.
     
  4. Select the appropriate Network Interface Card on the GFI FAXmaker which is able to communicate with your VoIP Gateway.
     

     
  5. Next you need to select your appropriate VoIP gateway which will be used to send and receive faxes. If the list included in XCAPI does not contain your PBX, you should select a compatible or one of the generic environments such as ‘H.323 Gateway’ or ‘SIP’
     
  6. Depending on the VoIP gateway selected in the previous screen, you will need to define the properties of the VoIP gateway. This generally consists of the IP address of the VoIP gateway and authentication settings if your VoIP gateway requires authentication.
     

     
  7. Finally you need to enter a meaningful description of the newly created controller and decide how many channels should be available for applications such as GFI FAXmaker.
     
  8. Click on the ‘Next’ button and ‘Finish’ button to complete the wizard.

At this point you have created the controller which will be used by GFI FAXmaker to send and receive faxes. Finally we need to configure GFI FAXmaker to use the XCAPI controller to send and receive faxes.

XCAPI Notes:

  • When any changes are done in the XCAPI configuration, you need save the configuration by click on ‘File > Save’ in the XCAPI configuration.
     
  • The ‘XCAPI Diagnostics’ located in the XCAPI program group contains useful information that can assist you in troubleshooting any issues you have with XCAPI controllers.
     
  • XCAPI licenses are configured from the XCAPI configuration under the ‘Licenses’ section.

Configuration GFI FAXmaker for use with XCAPI:

  1. Open the GFI FAXmaker configuration.
  2. Click on the ‘Lines/Devices’ node and select ‘Properties’ in the right pane.
  3. Click on ‘Add..’ to add the XCAPI controller.
  4. In the ‘Add fax Line’ window, enter the settings as follows:
     
    • Available fax lines: Select any fax line available.
    • Device type: ‘ISDN PRI/IP CAPI 2.0 devices’
    • Physical line/port: Select any available Controller / Channel
       
  5. Under the ‘Device’ tab, select the ISDN type: ‘TE-SYSTEMS XCAPI’
  6. Click ‘Ok’ to save your fax lines.

Notes:

  • The ‘TE-SYSTEM XCAPI’ ISDN is only available if the license key provided in GFI FAXmaker has a valid software maintenance agreement or running the evaluation of GFI FAXmaker.
     
  • The rest of the options which you can configure when creating a new line are discussed further in the GFI FAXmaker manual (Section: Configuring a fax line > Line options)