Advice and answers from the Callyzer Team

Callyzer LeadSquared Integration

Overview:

This guide provides step-by-step instructions to set up and configure the LeadSquared connector in Callyzer. With this integration, you can effortlessly link Callyzer to LeadSquared, enabling automatic mapping of call activities to the lead’s number in LeadSquared. Call activities can be mapped to either the “Latest Opportunity” or “Lead” associated with the number.

Pre-requisites:

  • LeadSquared Account: Ensure you have an active LeadSquared account.
  • Lead Mapping:
    • Call activities in LeadSquared will only map if lead or opportunity with the corresponding number exists.
    • If no matching lead or opportunity is found, no activity will be recorded.

How to Activate the Connector:

  • Navigate to the Connectors menu in Callyzer.
  • Select LeadSquared.
  • Click Try for 15 Days.
  • On the Purchase Summary screen, click Activate Trial.

Note: If you’ve already used a free trial for this connector, the option to try it for free again will not be available.

How to Configure the Connector:

  • Navigate to the Connectors menu and click Configure for LeadSquared.
  • Choose Post Activity for either:
    • Latest Opportunity
    • Lead
  • API Host:
    • Log in to your LeadSquared account.
    • Navigate to Settings → API and Webhooks → API Host.
    • Copy the API Host value and paste it into Callyzer.
  • Access Key:
    • In LeadSquared, go to Settings → API and Webhooks.
    • Click on Show Secret Key.
    • Copy the Access ID and Secret Key, then paste them into Callyzer.
  • Call Log API:
    • In LeadSquared, go to Apps → App Market Place → Universal Telephony Connector → Configure → Call Log API.
    • Copy the Call Log API value and paste it into Callyzer.

Click Save to confirm the configuration.

How to Test the Connector:

  • Call any number saved as a lead or opportunity in LeadSquared.
  • Once the call is disconnected, check LeadSquared to see if the call activities have been mapped to the corresponding lead.

How to Check the Logs:

  • Navigate to Connectors → LeadSquared → Configure.
  • Go to the Logs section.
  • Review the logs for each call activity, including:
    • Request Data: Details of the data passed from Callyzer.
    • Status: The status of the request.
    • Response: The response received from LeadSquared.

How to Configure Agent Name in LeadSquared:

For detailed instructions, refer to the below video:

In LeadSquared the call logs are pushed but it is showing the employee’s / agent’s phone number instead of their name, what should I do?

Please follow the video in the above section to display the name of the employee/agent instead of their phone number.

Is it possible to sync call recording from Callyzer to LeadSquared?

Yes, this integration will also sync the call recording (once it is available from the employee’s device to the Callyzer server) to LeadSquared. In LeadSquared, you will see a Play button, and you can listen to the call recording by clicking on that Play button.

Where are my call recordings stored? Are they stored on Callyzer or on LeadSquared?

The call recordings are stored on Callyzer. In LeadSquared, you can only listen to these recordings by clicking the Play button. If you delete the call recording from Callyzer, you will no longer be able to play that recording in LeadSquared.

In Callyzer, I am seeing the error “429 Too Many Requests” in the Logs section of the LeadSquared connector configuration screen. What does this mean?

The “429 Too Many Requests” error is a rate limit imposed by LeadSquared, based on your subscription plan. To resolve this issue or to request a higher limit, please contact the LeadSquared support team for further assistance.

Callyzer Zoho CRM Extension Guide

Overview

This guide provides step-by-step instructions to install, set up, and configure the Callyzer extension in Zoho CRM. The extension maps call logs with leads or contacts in Zoho CRM. If a lead or contact with a specific phone number exists, Callyzer will associate all related call logs and activities with that number.

Prerequisites

  • Zoho CRM Account: Requires an active Zoho CRM account with an Enterprise or higher plan.
  • Active subscription of Zoho connector in Callyzer.

Installing the Callyzer Extension in Zoho CRM

Steps to Install Callyzer

  • Open Zoho CRM and navigate to Settings (Setup) → Marketplace → All.
  • Search for Callyzer.
  • Alternatively, copy paste this URL in your browser to install the extension – https://marketplace.zoho.com/app/preview/crm/callyzer-for-zoho-crm
  • Click Install.
  • Accept the Terms & Conditions.
  • Select Permissions for Users/Profiles.
  • Click Authorize to allow the connector.
  • Click Accept to grant necessary permissions.
  • Click Finish.

Configure the Callyzer Extension in Zoho CRM

Setting Up API Key Names

  • Open Zoho CRM and go to Settings (Setup) → Marketplace → All → Installed.
  • Locate Callyzer Extension and click Configure.
  • Set up the API Key Names as follows:

Set up the Zoho CRM Connector in Callyzer

Configuring Webhook in Callyzer

  • Go to the Callyzer web portalConnectors, then click Configure under Zoho.
  • Click Add Zoho Endpoints.
  • Copy the Webhook URL from the Zoho CRM extension.
  • Paste the copied Webhook URL into Zoho Endpoints.
  • Click Test Endpoints.
  • If the test is successful, click Create Endpoints.

How to Test the Callyzer Zoho CRM Extension

  • Make a call to the phone number of an existing lead or contact in Zoho CRM.
  • In Zoho CRM, open the Lead or Contact associated with that phone number.
  • Go to the Lead Details or Contact Details page.
  • Navigate to the Callyzer Call Log section to view call details for that number.

Troubleshooting

Activating a Trial for Zoho connector in Callyzer

  • Open Callyzer and navigate to Connectors → Zoho.
  • Click Try for 15 Days.
  • On the Purchase Summary screen, click Activate Trial.
    • Note: If you have already used a free trial, this option will not be available.
  • Open Zoho CRM and go to Developer Hub → APIs & SDKs → API Names.
  • Under Leads, find and copy the API Name for the Phone field.
  • Similarly, locate the Phone API Name under Contacts.

I have a lead / contact with a specific phone number but call logs do not match with it.

This could be because of the phone number format in the lead / contact. The Callyzer Zoho CRM extension supports below phone number formats:

  • 9xxxxxxxxx [only phone number, without country code].
  • 09xxxxxxxxx [phone number with a leading zero].
  • +919xxxxxxxxx [plus sign, country code and phone number].
  • +91 9xxxxxxxxx [plus sign, country code and space with phone number].
  • 91 9xxxxxxxxx [country code without plus sign and space with phone number].
  • +91-9xxxxxxxxx [plus sign, country code and dash (-) with number].
  • 091 9xxxxxxxxx [country code with a leading zero and space with phone number].
  • 0919xxxxxxxxx [country code with a leading zero with phone number].

My call logs are not getting synced from Callyzer to Zoho CRM

  • Open Callyzer and navigate to Connectors -> Zoho -> Configure -> Logs.
  • Under Response click on View on any of the latest row.
  • Check if you are seeing error like this: {“code”:”INVALID_DATA”,”details”:{},”message”:”Value is empty and ‘get’ function cannot be applied”}
  • If yes then open your Zoho CRM -> Marketplace -> All -> Installed -> Callyzer -> Configure.
  • Under Integrations click on Revoke and then click on Authorize.
  • Follow the steps shown in the screen to Authorize the connection again.

FB & Insta Lead Capture Connector Integration with Callyzer

Overview:

This document will help you with steps to setup & configure FB & Insta Lead Capture connector in Callyzer. With this connector you can connect Callyzer to Facebook and Instagram effortlessly and automatically import leads from Facebook and Instragram advertise / campaign forms directly into Callyzer and these leads will then be available in the Leads module of Callyzer.

Pre-requisites:

  • You need to have a running advertisement / campaign form in Facebook in order to capture the data that people fill in the form when they see your advertisement / campaign.
  • While creating a Facebook advertisement / campaign form you need to have at least 2 mandatory fields:
    • Name of the lead.
    • Phone number / Mobile number of the lead.
  • The data is automatically imported into the Leads module of Callyzer so you need to subscribe to the Lead module subscription plan of Callyzer.

How to activate the connector:

  • Navigate to the Connectors menu.
  • Select FB & Insta Lead Capture.
  • Click Try for 15 Days.
  • On the purchase summary screen, click Activate Trial.
NOTE: If you have already done a free trial of this connector previously you will not be able to try it for free again.

How to configure the connector:

  • Navigate to Connectors menu and click Configure for FB & Insta Lead Capture.
  • Click Login to Facebook:
    • Log in to the account with the active ad campaign.
    • If previously linked, choose to continue with prior settings.
  • Click Edit Settings to select the Facebook pages to connect, then click Next.
  • Set all options to YES (Callyzer may not work properly if all options are not turned on) and click Done.
  • Click OK to confirm.

You’ve successfully configured FB & Insta Lead capture with Callyzer! 

How to setup lead assignment:

  • Select the desired Facebook page & form.
  • Select appropriate lead assignment options as your requirement.
  • Map Facebook fields to Callyzer Leads module fields. 
  • Click Save to complete setup.
  • You’ll see a summary of the configured Facebook pages and forms. 
  • You can edit or remove these settings as needed.

Now, any submissions to your Facebook form will be captured in Callyzer, visible in the Leads → My Leads.

How to test the connector:

  • Open Facebook Developers.
  • Navigate to ResourcesDeveloper tools.
  • Select Lead Ads RTU Debug Tool.
  • Choose the appropriate Facebook page and form.
  • Click Preview Form, fill in the details, and click ContinueSubmit.
  • Return to Callyzer:
    • Navigate to ConnectorsFB & Insta Lead CaptureConfigure.
    • Check Logs to confirm the lead was captured.
    • Also, check Leads → My Leads to see the new lead.

How to check the Logs:

  • Navigate to ConnectorsFB & Insta Lead CaptureConfigure.
  • Go to Logs.
  • View the log of all data received from Facebook/Insta, including date-wise status, results, lead information, and requests for each lead.

My Facebook page & form is configured correctly in Callyzer, still leads are not getting pushed to Callyzer.

This might be because your Facebook page does have appropriate access to Callyzer as an “Assigned CRM”. Please follow the below steps.

  • Log in to your Facebook Business Account.
  • Select the appropriate Business Portfolio and Facebook Page from the dropdown at the top on left panel.
  • Go to Settings.
  • Navigate to Integrations -> Lead Access from the left panel.
  • Choose the correct Facebook Page.
  • Click on Assign CRMs.
  • Select Callyzer from the list and click Assign.
  • Verify that Callyzer appears in the Connected CRMs list.

In my Facebook form I have multiple choice selection field, how can I map that with Callyzer.

To map a multiple-choice selection field from your Facebook form to Callyzer, follow these steps:

Step 1: Create a Dynamic/Customized Form Field in Callyzer

  • Go to Leads -> Form Settings in Callyzer.
  • From the list, select DropDown.
  • Click on Edit to modify the field.

Step 2: Configure the Form Field

Enter the appropriate label and other details in the form field, then in Options enter the text and value for each option as per your Facebook form in below manner.

  • Text Field:
    • Enter the text as it appears in your Facebook form.
    • Example: If your Facebook form option is “This is Option 1”, enter “This is Option 1” in the Text field.
  • Value Field:
    • Convert the same text to lowercase.
    • Replace spaces with underscores (_).
    • Example: For “This is Option 1”, enter “this_is_option_1” in the Value field.

Now Save this setting & map this newly created Form Field in Callyzer with Facebook form field in the Facebook connector configuration page of Callyzer.

Why Follow This Format?

This format ensures that the data from Facebook can be mapped correctly when imported to Callyzer, as it standardizes the text format.

Note : For additional assistance or troubleshooting, please contact your relationship manager.

How Call Recording Synchronization works with Callyzer

Callyzer supports call recording synchronization. This means the app does not record calls directly. Instead, your phone or device records the calls, and Callyzer syncs these recordings to its cloud server.

Please watch the videos below to learn how call recording synchronization works with Callyzer.

Guide to Call Recording Sync with Callyzer (English)

Guide to Call Recording Sync with Callyzer (Hindi)

How to call API using PHP?

Here is the code to the call Callyzer API using the PHP CURL function.

<?php

// API Url to fetch call history
$url = "https://api1.callyzer.co/admin/api/call/callHistory";

// Access Token
$accessToken = 'API_TOKEN';

$data = [
    'callStartDate' =--> '2023-01-20',
    'callEndDate' => '2023-01-24',
    'employeeNumbers'=> '9998875555',
    'callTypes'=> 'Incoming,Outgoing',
    'excludeNumbers' => 'False',
    'recordFrom' => '100',
    'pageSize' => '50',
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_POSTFIELDS,json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    "Authorization: Bearer " . $accessToken,
    "Content-Type: application/json"
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if ($response === false) {

    echo "cURL Error: " . curl_error($ch);
} else {
    
    echo "Response: " . $response;
}

curl_close($ch);
?>

Troubleshoot FunTouch O.S 4.0 & Above

Process 1: Settings For Auto Start for Callyzer
Step 1: Open Phone Settings.

Step 2: Find More Setting Option And Click On It.

Step3: Click On Application Option

Step4: Click on AutoStart Option(Make Sure it Must be Blue/Green.) And find the CallyzerBIZ application and click on toggle button
(Make Sure it Must be Blue.)
Process 2: How to disable battery optimization for Callyzer
Step 1: Open Phone Settings

Step 2: Type battery in the search box and click on Battery option.

Step 3: Click on High background power consumption.

Step 4: Search CallyzerBIZ and click on toggle button

How to Setup Call Recording in Employee Phone

You can also follow our Youtube tutorial to setup Call Recording in Employee Phone.

To Setup Call Recording in Employee Phone, Kindly follow the following steps.

Step 1: Open the default dialer in the user’s device and go to settings

Step 2: In Call Settings, Enable Call Recording.

Step 3: As you enable call recording, all your calls will be recorded. These call recording files are stored in File Manage. We have to synchronize the Call recording folder with the Callyzer.
To do so, Open: Callyzer Biz application -> Settings -> Change Call Recording Location.
Select the respective call recording folder from the file manger and click “Use this Folder“.
Please click on the “Allow” button to grant Callyzer Biz access to the call recording folder.

 

 
 
Alternate Process to setup Call Recording in Employee Phone

If you cannot find the Call Recording path from user’s device. Kindly follow the below instructions.

Step 1: Open the Default Dialer -> Settings -> Enable auto call recording.

Step 2:  To share the recorded file, click on the call log for more options.

Step 3: Click on the share button and attach the call recording with Callyzer Biz.

How to setup Call Recording? – Quick guide for Admin & User

Let’s look over quick steps to enable call recording synchronization feature. The process of accomplishing this task consists of two sections.

Let’s have a look at both the sections.

How to Setup Call Recording In Web/Customer/Admin Panel

To setup Call Recording in Admin Panel, You can also refer to this Video Tutorial.
 

To Setup Call Recording in Admin Panel, Kindly follow the following steps.

Step : 1 Login to your Callyzer Account.
Step 2: Click on “Manage Employee”.

 
Step 3: In Manage Employee, look for Call Recording Enabled Column.
 
Step: 4 Toggle the button next to the respective employee to enable to enable call recording.
 
 

How To Manage Webhook Response ?

Here we explain how you can handle the webhook response using separate languages like PHP, Node, Java

The original Response come from Callyzer

[{“id”:null,”employeeName”:”Nikunj”,”countryCode”:”91″,”employeeNumber”:”942808xxxx”,”logs”:[{“id”:”5P2lT3gZySjv66Y5ZtWd-I42pN9g0OMcuKnE1d_k”,”name”:”Unknown”,”countryCode”:”91″,”number”:”1503″,”duration”:4,”callType”:”Outgoing”,”callTime”:”2023-02-04 18:09:26″,”note”:null,”recordingURL”:null,”crmStatus”:null,”reminderTime”:null,”createdDate”:”2023-02-04, 06:10:08″,”modifiedDate”:null},{“id”:”DP8zh4jukFdmDtYE3v_MMIcYs4zOzo9Mx24jW6fk”,”name”:”Bharat”,”countryCode”:”91″,”number”:”909907xxxx”,”duration”:0,”callType”:”Outgoing”,”callTime”:”2023-02-04 18:09:38″,”note”:null,”recordingURL”:null,”crmStatus”:null,”reminderTime”:null,”createdDate”:”2023-02-04, 06:10:08″,”modifiedDate”:null}]}]

 

Using Java

 

 

//requestPayloadStr has request payload in string format
JSONArray reqJsonArray = new JSONArray(requestPayloadStr);

//Loop though all the employee's records
for (int i = 0; i < reqJsonArray.length(); i++) {
    
    //get Employee JSON Object
    JSONObject empJsonObj = reqJsonArray.getJSONObject(i); 
    
    //get Employee Name
    String employeeName = empJsonObj.getString("employeeName"); 
    
    //get Employee Number
    String employeeNumber = empJsonObj.getString("employeeNumber");
    
    //get call logs of an employee
    JSONArray empLogs = empJsonObj.getJSONArray("logs");

    //loop through all the call logs
    for(int j =0; j < empLogs.length(); j++) {

        //get a call log
        JSONObject callLog = empLogs.getJSONObject(j);

        //get unique call log id
        String callLogId = callLog.getString("id");

        String toName = callLog.getString("name");

        String toNumber = callLog.getString("number");

        String note = callLog.getString("note");
    }
}

 

Using PHP

 

<?php
   
//requestPayloadStr has request payload in json format
$webhookResponse = file_get_contents("php://input");

//decode Json and make into Array
$data = json_decode($webhookResponse, true);

//Loop though all the employee's records
foreach($data as $key => $val) {
		//get Employee Name
		$employeeName =$val['employeeName'];
		
		//get Employee Number
		$employeeNumber =$val['employeeNumber'];
		
		//get call logs of an employee using the loop
		foreach ($val['logs'] as $lk => $lv) {
				//get unique call log id
				$callLogId = $lv['id'];
				
				$clientName = $lv['name'];
				
				$clientNumber =$lv['number'];
				
				$note = $lv['note'];
        }
}
?>