Preview · This help is still growing and will be extended over time.
Configure the search.ch integration
Identifying callers from the public Swiss directory
With the search.ch integration, echo also identifies callers who are not in any of your own systems: echo looks up the number in the public Swiss directory of search.ch, with entries for people, companies and authorities. A directory entry for a person appears as a person in echo, an entry for a company or authority as a company, each with phone numbers, email addresses, websites and address as listed in the directory.
The integration is set up once by an administrator and applies to the whole organization. You need your own search.ch API key.
Things to know:
- Switzerland only. search.ch lists Swiss entries. Callers from other countries are not found there.
- Public entries only. echo finds what search.ch publishes. People without a directory entry are not found.
- Updates after up to 24 hours. echo keeps search.ch results for 24 hours. A changed directory entry therefore appears in echo after up to a day.
- Your own key. The terms of use and any limits of the API key are set by search.ch.
Prerequisites
- search.ch is added under Settings → Integrations (see How integrations work).
- You are signed in to echo as an administrator.
Set up search.ch
Request an API key
Request an API key from search.ch at search.ch/tel/api/getkey.en.html (opens in a new tab). The link is also shown on the settings page in echo.
Enter the key
Open Settings → search.ch and paste the key into 1 API Key. echo checks the key right away by sending a test query to search.ch and shows 2 API Key is valid or API Key is invalid.
Save
Click 3 Save. The button is only active once the key has been confirmed as valid. echo stores the key encrypted; afterwards the field shows a placeholder instead of the key.
From now on echo includes search.ch in every caller lookup and contact search.
Change or remove the key
To replace the key, click into API Key, enter the new key, wait for API Key is valid and click Save. If you leave the field without typing, the saved key stays unchanged.
To stop using search.ch, remove the integration at the bottom of the page under Remove integration (see How integrations work).
Troubleshooting
The page says search.ch is not enabled. Add search.ch under Settings → Integrations first.
The search.ch settings are missing. Integration settings are only shown to administrators; ask one of them.
“API Key is invalid”. Check that you copied the complete key without spaces. If it is still rejected, request a new key at search.ch.
The integration shows Not configured. No API key has been saved yet. echo does not search search.ch until a key is saved.
Callers are suddenly no longer recognized at all. If search.ch rejects the saved key (for example because it was revoked), the whole caller lookup can fail. Enter a valid key or remove the integration.
A Swiss caller is not found. Check on search.ch whether the number has a public entry. Entries changed in the last 24 hours may not be visible in echo yet.