Get location and phone line type of your inbound calls with Zapier and Numverify

Inbound calls are essential for your business, and they deserve an excellent customer service; but, besides the information you get talking with the customer, it could be useful to know some details of the number the customer calls. Just like when you check your site traffic, you care about the source cities and countries of your visitor, or if the traffic reaches you through social networks, search engines or directly, when you check the phone numbers of your customers, you may be interested in getting similar information about the caller.

What can you do with this phone number information?

By knowing details of the caller's phone numbers, you can do several actions:

  • Qualify your leads: You can define if a caller has the chance of becoming a new customer according to his geographic location. This is useful if your business has some restriction or geographical preferences.
  • Classify calls from Toll-Free numbers: Tool-free phone numbers have national reach, and they can receive calls any part of your country; The ability to classify calls by area and city will allow you to define focused marketing strategies or create special offers for the locations from which you receive the most calls.
  • Discover which customers can be contacted with SMS: When you know which customers are calling you from mobile numbers, you can use those numbers to send text messages and inform them about offers and valuable information.

How to know the location and the type of number a customer calls you?

To achieve this with Toky, we will use the following tools:

  • Zapier: This solution allows to easily automate your business processes integrating your apps with no code.

You require a paid account in Zapier because we must create a zap with more than 3 steps and free plan only allows 2. The steps will be Toky + filter + Webhook Numverify + Google Sheets

  • Numverify: This solution provides an API that gives you detailed information about phone numbers in more than 230 countries. You can get validate the phone number, its location, the phone service carrier and the type of line that will let you know if it is a landline or mobile number.

You must create an account in Numverify to get your Key API and use it in this process. The free plan can be used to make basic tests and if you receive less than 250 calls per month since this plan only allows this maximum number of API calls.

  • Google Sheets: We will use a sheet in Google Sheets to save the information we get from Numverify.

These apps will be integrated to analyze inbound phone calls in Toky to generate information about the source phone number in a sheet of Google Sheets.

Basic steps of the Numverify API

After creating the account in Numverify you can access your API Key, and you can execute a request with the following parameters:

    ? access_key = {API_KEY}
    & number = {PHONE_NUMBER}
    & country_code = 
    & format = 1

For example, replacing {API_KEY} with your Numverify Key API would leave this link:{API_KEY}&number=442080891759&country_code=&format=1  

When executing it, you would have the following JSON response:

"valid": true,
"number": "442080891759",
"local_format": "02080891759",
"international_format": "+442080891759",
"country_prefix": "+44",
"country_code": "GB",
"country_name": "United Kingdom of Great Britain and North",
"location": "London",
"carrier": "",
"line_type": "landline"

Now that you know how to use the API to get details of a phone number, we will integrate it with Toky, Zapier and Google Sheets keep a log with data like country_code,carrier, country_name andline_type of inbound phone numbers that calls to your call center with Toky.

Creating a zap in Zapier

We are going to create a 4 step zap like this:

  1. Toky: We will use the New call trigger to capture information about calls made in your Toky call center.
  2. Zapier filter: We will only apply the process to inbound calls which are not live calls.
  3. Zapier Webhook: It will allow us to execute the Numverify API, sending the inbound phone number as the parameter to get calls data.
  4. Google Sheets: We will use it to create a new row for each inbound call with information generated by Numverify.
Zapier Numverify Phone validation
1. We start with Toky as a trigger

After connecting Zapier with Toky you can add the Toky connection and you use the New Call trigger.

Toky Zapier New call
2. Use Filter by Zapier

Now we must filter calls to only process inbound calls which are not live calls. To get this we add the component Filter by Zapier and put the following values with an AND condition:

  • Web call = no
  • Direction of the call = inbound
Zapier filter inbound calls Toky
3. Execute the call to the Numverify API

To execute the Numverify API we will use the Webhooks by Zapier component and execute the GET action

Zapier Webhook GET action

In the template we will use the following values:

  • URL:
  • Query String Params
    • accesskey: API Key from Numverify
    • number:: Add the phone of the inbound call that you will find in the parameter From Number of the Call of the action New call de Toky.
    • countrycode: Blank
    • format: 1
  • Send As JSON: No
  • JSON key: json
  • Unflatten: yes
  • Basic Auth: Blank
  • Headers: Blank
Zapier Webhook GET template parametres
4. Save the call records in Google Sheets

To finish the zap, we will store the information returned from Numverify API in a sheet in Google Sheets; for this, we will use the action Create Spreadsheet row of the Google Sheets component. To do this, you must have first created in your Google Drive account a file with a sheet that contains the following fields:

  • valid
  • number
  • local_format
  • international_format
  • country_prefix
  • country_code
  • country_name
  • location
  • carrier
  • line_type
  • to_number

Now in the template section, select the Google Sheets file, the worksheet and select the related fields. The value of the field to_number is taken from the field To number of the call from the Toky connection the others from the GET component as a result.

Zapier save phone number data Google Sheets

After finishing every step, activate your Zap and now every time you receive a phone call in your Toky call center, you will have additional information that will allow you to classify your customers using new data. This information can then be combined with other information from your CRM and get new interesting statistics.

You can do much more with the integration of Toky with Zapier. Try Toky for free

comments powered by Disqus