This is a module for MikoPBX which shows the caller name from the Swiss phone directory tel.search.ch on incoming calls.
On every incoming call the number is looked up in the directory and the CallerID name is set to
Name F. City, Street 1. Numbers may arrive as 044…, +4144…, 004144… or 4144….
Numbers outside Switzerland and numbers missing from the directory are left untouched,
so a name sent by your provider is not lost.
Module was built by scriptwriter13 in 2026 and released by GPL V3. deutsche Version Русская версия
Upgrading from older version: remove the old CalleridSearchCH module first. The module id gained the
Module prefix required by MikoPBX, so an install over the old one leaves both modules enabled, with one
lookup per enabled module on every incoming call and the old script still running.
- Build the module archive (see below) or take it from the releases page.
- In the MikoPBX admin panel open Modules → Installed → Upload new module and choose the zip file.
- Enable the module.
- Open the module page, paste your API key and press Save.
- If desired, you can also modify the call flow. Only make these settings if you are certain of what you are doing. Here, it is possible to reject anonymous calls or calls categorized as call center traffic. It is also optionally possible to play a custom-recorded announcement before the call is dropped.
Requires MikoPBX 2025.1.1 or newer.
Get a key at https://tel.search.ch/api/getkey. It is free for moderate use. Without a key the directory returns the name only, without city and street.
The caller number of every incoming Swiss call is sent to tel.search.ch over HTTPS. The module stores nothing about calls and writes no log of names or addresses.
- The directory is asked with a hard 2 second budget for the whole request. If it does not answer in time, the call goes on with the original CallerID.
- Failures are never silent and never break a call: the reason is written to the Asterisk log
through AGI verbose, prefixed
CalleridSearchCH:. A rejected or exhausted key shows up there. Caller names and addresses are not logged. - No name is shown: check the Asterisk log first, then that the number has a public entry at tel.search.ch.
- Run the self-check without PBX and network:
php tests/LookupTest.php
zip -r ../ModuleCalleridSearchCH.zip . -x '.git/*'