CallerHub
EN
Download

3CX: contact lookup from your own database

3CX shows names from its own contacts. For data from a CRM, an ERP or a database it offers a CRM integration: a template describes which address 3CX calls with the phone number and how it reads the response.

How 3CX queries a CRM

For an incoming call, 3CX calls the address stored in the template with the phone number and takes over the name and, if available, the link to the record. You upload the template in the 3CX management console under Integrations → CRM; the exact menu path depends on the version. The structure and placeholders of the template are described in the 3CX documentation.

For this to work, 3CX must reach the queried service over the network. If your 3CX runs at a hosting provider or in the cloud, the service needs an address reachable from the internet; then use HTTPS and limit the allowed senders.

With CallerHub: create the template, upload it, done

  1. In CallerHub, choose 3CX under Interfaces → Add interface, enter a label, click Create.
  2. In the Phone system card, choose “3CX (CRM template)”, enter the address of the 3CX under Allowed IP addresses and click Save and apply.
  3. Save the 3CX template …. The file contains the address and API key of this interface.
  4. In 3CX, upload the template under Integrations → CRM and select CallerHub as the CRM.
  5. Switch on the phone number search and make a test call. The access appears in CallerHub under Recent requests.

3CX queries with format=json and receives the name, the phone number and – if configured for the data source – the address of the record in the CRM.

Interfaces
Interfaces page with an expanded card for the phone system.

Where the names come from

3CX only asks CallerHub; CallerHub queries all data sources selected for this interface in the order you set. The first source with a match provides the name. A typical setup is a CRM as an SQL database or via a REST API, plus Active Directory for colleagues or a DATEV export. If one source fails, the others keep answering.

The phone number may arrive in any notation (national, +49, 0049, with spaces); CallerHub normalises it before the search, see phone numbers in E.164 format.

Call analytics with 3CX

For answer rate, service level and the callback list, CallerHub needs the call records of the 3CX. They arrive after the call:

  • CDR output (v18/v20): in 3CX under Admin → Settings → CDR; active (CallerHub listens on a port, e.g. 5100) or passive, or as a CSV export.
  • 3CX V20 via API (cloud or on premises): CallerHub retrieves the data via XAPI; in 3CX, create a client with XAPI access under Integrations → API.

The 3CX guide is based on published interfaces and has not yet been checked with a real 3CX. Check menu paths and setting names against the documentation of your version.

Frequently asked questions

Do I have to write the CRM template for 3CX myself?

No. CallerHub saves the template with the button “3CX template …”; the address and API key of the interface are already included. You upload the file to 3CX.

Does 3CX also show a link to the customer in the CRM?

Yes, if a link to the record is configured for the data source (e.g. an address with a placeholder for the customer number). CallerHub passes it to 3CX in the response.

Does this work with the free basic edition?

Yes. The basic edition allows one interface and one data source; the 3CX can be that one interface. The full edition allows up to ten interfaces and ten data sources and adds the extended call analytics.

Try it

Test it with your own data.

Try the full edition for 30 days: choose “Request trial …” in CallerHub and the trial key arrives by e-mail. The setup wizard guides you through data source, phone system and test lookup. After that, CallerHub continues as the free basic edition without losing settings or data.