Skip to main content

Caller names

Open Numbers and trunks, Numbers, Caller names (/admin/caller-names). You need trunks:read to see the page and trunks:write to change it.

The name your numbers show​

Give each of your numbers the name people should see when you call them, for example your company name on your main number. When a call presents that number to the carrier (the caller ID a user selects, the one of the route or of the calling profile), MonoPbx sends this name as the caller's name instead of the user's own name.

  • Up to 50 characters. Many carriers and phones show only the first 15.
  • A call that withholds its number (CLIR) sends no name. Emergency calls always present the caller's own identity.
  • Some carriers do not take the name from the call but from their own name database. Register the name with the carrier as they ask, and tick Registered with the carrier to keep track.

Names of the people who call you​

Switch on Look up the names of callers from outside to show a name for incoming calls from outside. The sources are asked in this order until one knows the number:

SourceLooks in
Company directorythe mobile number of an active user listed in the directory
Company contactsthe company phone book (not the users' personal contacts)
CRM integrationsyour connected CRMs that can look a number up
Your name lookup servicea service of your own choice, with your key (see below)

By default a name the carrier sent is kept, and only calls without a name (or with just the number as their name) get one. Switch on Replace the name the carrier sends to always show the name found. The lookup waits at most 1.5 seconds; if it is slower, the call rings with the carrier's name.

Your own name lookup service​

Enter the https address of your service with {number} (the number with its +) or {digits} (only the digits) where the number goes, the header that carries your key (for example Authorization) and the key. The key is stored encrypted and is never shown again. If the answer is JSON, enter the path of the name in it (for example $.name); otherwise the first line of the answer is the name.

Names looked up​

Every answer, found or not, is kept for Keep looked-up names hours (default a week), so your service is not asked for every call. The list shows what was found and where. Forget one number or Clear all to look them up again at the next call.