Integrating Alohub Softphone × Zoho CRM

Instructions for installing and using the Alohub Softphone extension on Zoho CRM: calling from the phone number and linking the call to the correct Lead/Deal/Contact/Account.

Overview

Item	Value
Host	`crm.zoho.com`, `.eu`, `.in`, `.com.au`, `.jp`, `crmplus.zoho.com`
Module	`Leads`, `Contacts`, `Potentials`(Deals), `Accounts`
Link call	Map module → `Who_Id`/ `What_Id`/ `$se_module`

Note: Zoho does not automatically link Lead ↔ Contact. The call is linked to the record where it is initiated.

Conditions

Alohub provider account is Zoho , connected via OAuth to the correct data center ( .com/.eu/.in/...).
Permission to create record Calls in Zoho.

Installation

Install the extension, open Zoho CRM according to your correct DC.
Open the side panel, log in. The provider badge displays Zoho .

Usage — Call from phone number

Chip "Call" appears next to the phone number in the record details and list. With the zpb-phonewidget of Zoho, the extension hides the default call icon and places the Alohub chip right next to it — this chip carries the record context, ensuring the call is linked accurately.

Call log linked to the correct record

The extension reads the URL in the format .../tab/<Module>/<id>:

Context module	Zoho Calls field
`Contacts`	`Who_Id = recordId`
`Leads`	`Who_Id = recordId`, `$se_module = "Leads"`
`Potentials`/ Deals	`What_Id = recordId`, `$se_module = "Deals"`
`Accounts`	`What_Id = recordId`, `$se_module = "Accounts"`
(no context)	fallback: find Contact by phone number

Troubleshooting

Phenomenon	How to handle
See both Zoho icon and Alohub chip	Reload; the extension hides `zpb-phone`via CSS — if still present, report to dev
Incorrectly linked Contact instead of Lead	Check the correct URL `/tab/Leads/<id>`; view console `[Alohub] DIAL ctx`
Wrong data center	Open the correct `crm.zoho.<dc>`; Alohub provider has `apiDomain`matched

Need further assistance? Contact Alohub .