Teams Easy Lookup – See who’s calling you on Teams!

When you get an incoming call on Teams Direct Routing, this call is sent to our Session Border Controller. From there, we will send the caller ID (phone number) to our intermediate system which will then query the configured sources (Search.ch, ERP, CRM) for matches. We will then insert the name (and company, if available) as the display name before the call is delivered to your Teams Client. This way, you’ll be able to see who’s calling you or who has tried to call you.

Teams Easy Lookup only works if you’re a Teams Direct Routing customer of TwinCap First. It’s not possible to connect a 3rd party provider.

If you’re already a Teams Direct Routing Customer of us and already have a Search.ch API key, nothing else is needed. If you want to connect your own ERP or CRM system, it needs to fulfill the requirements stated below.

No. A lookup only takes milliseconds to complete.

No. Teams Easy Lookup is a cloud service and works without installing any software. You don’t need to install anything on your PC or Smart Phone.

Teams Easy Lookup is compatible with all Microsoft Teams clients. It doesn’t matter if you’re using your Desktop, Mobile, Desk Phone or the Web Client, you’ll always see the caller’s name.

Yes. The recognition of caller names will happen on a per number basis and not per user. If you’re using a call queue to distribute incoming calls on your main number to multiple users, all users will see who’s calling.

The default version uses Search.ch as directory. It’s possible to connect other sources such as your own CRM or ERP system or other public directories which you have access to.

With the free API key of Search.ch, your company can make up to 1000 requests per month. This means that you’ll be able to identity up to 1000 caller names per month.

If you need more than 1000 API calls per month, an additional contract with the company Directories Data AG is required. This will result in higher setup fees and monthly recurring charges. Contact us for more information.

Your system needs to provide an API and must be reachable over the public internet, or at least from specific IP addresses/ranges. REST APIs are preferred but other solutions are also possible.

Yes. For example, we can query your own database first and only query a public directory like Search.ch if no match is found in your system.

By default, we will send you the names, company names and location (if available) of callers in Search.ch. If your own system provides an API, we can also query additional information like customer numbers, check if the caller is already a customer etc. Basically any information which is retrievable by an API can be included in the caller name.

In rare cases, it’s possible that multiple entries per number are found. This can occur if, for example, a company has multiple office locations but published only one phone number. In this case, we will always send you the first result.

In this case, we will send the caller number followed by the suffix [No Results] to your Teams client. You’ll immediately know that a lookup has been made but that the number is not part of any connected directory.

You can send up to 90 characters. We do not recommend sending too many characters as manual line breaks are not possible and names this long will be barely readable on mobile devices with rolling texts.

If a number is saved as a contact in Exchange Online (Outlook) or stored as a contact on your mobile device, Teams will always prefer your local information over Easy Lookup. We can’t query if the number is saved as one of your contacts, therefore an Easy Lookup request will still be made. Note that this will also count towards your monthly contingent of API requests at Search.ch.

Yes, the caller name will also be visible in your call history.

If the caller is also using Teams Phone, your Teams Client will recognize that the caller is also a Teams user. In this case, a lookup in Azure AD will happen and override the information Easy Lookup already inserted.

We need about 1 hour to setup Easy Lookup. This implies that you already have an API key for Search.ch and the standard version without any customization (e.g. your own CRM/ERP) is implemented.