Skip to content
FMX EPOS
Download
Help Centre home

Configure caller ID and dialling

Caller ID settings belong to a single terminal. Open Back Office → Local Settings → Caller ID & Clover as an active administrator.

Under Caller ID Source, choose the Device on This Terminal:

  • None — No Telephone
  • Yealink Action URL
  • AD102 USB Caller ID
  • Phonic USB Caller ID

Select Save Caller ID & Clover at the bottom of the page and check Device Status. Only one source can be active. The USB devices handle incoming calls only, while Yealink handles both incoming calls and dialling out. The pill beside Caller ID & Dialling shows No Telephone, Incoming Only or Yealink.

Illustration, not a screenshot. The real screen can differ with the theme or version.

  1. Connect the AD102 or Phonic device to this PC.
  2. Choose the matching source and select Save Caller ID & Clover.
  3. Check Device Status. A working device reads, for example, “AD102 connected · 1 device(s)”. “No AD102 detected. Check USB and driver.” means the PC cannot find it.
  4. Make a test call and check that the number reaches the till.

If the status does not show the device as ready, see Caller ID and dialling troubleshooting. Choose the other USB type only if that is the device you have.

With a USB caller ID box, a call that arrives without a number is not shown on the till or kept in Customers → Calls. Whether a withheld number arrives without one depends on the device. With a Yealink phone, FMX EPOS can keep a call even when no number is sent.

Illustration, not a screenshot. The real screen can differ with the theme or version.

  1. Choose Yealink Action URL. The Yealink fields appear under the source.
  2. Enter the Yealink Dial URL. End it with =, or put {number} where the telephone number goes. The field is required even if the store only wants incoming calls: without a valid dial URL the save is refused.
  3. Enter the Callback Port. The default is 880. FMX EPOS uses ports 5139 and 8990 itself, so they cannot be chosen. Use this port in the phone’s Action URLs. After saving, Device Status reads “Listening on port 880” (or your port). If it reads “Callback port 880 could not open”, another program is using that port: choose another. The other settings are saved all the same, and the page says “Settings saved.” followed by the port warning.
  4. Enter the Allowed Callback IPs, separated by commas, including the phone’s address. The save is refused while the list is empty, and events from any other address are rejected. The latest refused address and time appear under Last Refused Callback.
  5. Tick Allow the Phone’s Self-Signed HTTPS Certificate only if the phone uses one and the store accepts that certificate. It applies only to dialling out and has no effect on incoming calls.
  6. Select Save Caller ID & Clover at the bottom of the page. It saves the source, the Yealink settings and the Clover settings together.

Allow the callback port through Windows Firewall. Give the phone a fixed IP address or a DHCP reservation so the allowed IP list stays correct.

The dial URL can contain the phone’s login details, so FMX EPOS hides the saved value. Under the field it shows “Saved securely” followed by the phone’s address and path without the login details, such as https://192.168.1.20/servlet?number=…. To keep the saved dial URL while changing other Yealink settings, leave the field blank. Use Show Keys only when nobody else can see the screen.

Once Yealink is chosen as the source, select Action URL Help under it. It lists a URL for each phone event: Off Hook, On Hook, Incoming Call, Outgoing Call, Call Established, Call Terminated, Missed Call and Cancel Call Out. Copy them into the phone’s web settings under Features → Action URL (the menu name varies with firmware). Replace EPOS_PC_IP with this PC’s address on the shop network (not the phone’s address and not 127.0.0.1), and leave $call_id and $remote as they are. Events from a phone that is not in Allowed Callback IPs are rejected, even with the correct URL.

Illustration, not a screenshot. The real screen can differ with the theme or version.

Save the Action URLs on the phone, then make a test call and check that it appears in Customers → Calls on the till. The Action URLs only report call events; dialling out still uses the Yealink Dial URL.

An incoming call appears in Customers → Calls on the till. With Yealink, when staff dial a customer, the number is sent through the saved dial URL. USB sources never dial out. With a USB source chosen, FMX EPOS ignores events from a Yealink phone, so the same call is never recorded twice.