Skip to main content

Screen pop

When a call rings, the console's phone and the MonoPhone app show who is calling: a contact of the company phonebook, a colleague from the directory, or the contact a connected CRM knows. A link opens the caller's record. If your company wants, the record opens by itself.

What the agent sees​

Under the caller's number the call screen shows the name, the company and where it was found, and Open record:

  • for a CRM contact, the contact's page in your CRM;
  • for a contact of the company phonebook, the phonebook in the console, searched for the number.

Nothing is shown when nobody knows the number or the answer takes more than a few seconds; a slow or failing CRM never delays or breaks the call.

Settings​

Open CRM integrations (/admin/crm) and scroll to Screen pop. Everybody who may read contacts sees the settings; changing them needs integrations:write for the whole company.

  • Open by itself: Never (agents click Open record), When the call rings, or When the call is answered. The record opens once per call, in a new browser tab in the console and in the browser of the phone or computer in the app.
  • What opens: The caller's record (CRM or company contact), Your address, or The record, else your address.
  • Your address: an https (or http) address with placeholders that are filled in for each call: {number} (the caller's number in international format), {digits} (the number's digits only), {name} (the name found, or the name the call shows), {call_id} and {direction} (inbound or outbound). Every value is encoded, so it cannot change the address. Example: https://crm.example.com/search?phone={number}.
  • Look in the company contacts and directory first: on by default; off asks only the CRMs.
  • Also for outgoing calls: the record also opens for calls you place.

The CRM lookup uses the integrations you set up from a template or as a native connector (see CRM templates and Native CRM connectors); each contact's record address comes from the integration's link setting.

Browsers may block a tab that opens without a click. If records do not open by themselves in the console, allow pop-ups for your PBX address in the browser.

API​

GET and PUT /api/v1/integrations/crm/screen-pop read and change the settings; POST /api/v1/integrations/crm/screen-pop/resolve answers, for one call, the contact found, its record address and the address to open.