Knowledge Base

Documentation & Help Center

Guides for GoDesk Telephony and SMS — Zoho CRM integrations built for African businesses.

Overview

What is GoDesk Telephony?

GoDesk Telephony is a Zoho CRM PhoneBridge extension that gives your team a fully functional softphone inside the CRM. No desktop app, no hardware desk phone — just a browser.

Inbound callsIncoming calls ring inside Zoho CRM. The contact record opens automatically if the number is recognised.
Outbound callsClick any phone number in CRM to dial — or type a number directly in the widget.
Hold & ResumePut a caller on hold with one click; resume when ready.
MuteSilence your microphone mid-call without ending it.
DTMF / KeypadSend tones for IVR navigation using the on-screen keypad.
Call timerLive duration counter for every call.
Automatic call loggingCalls are logged to the contact or lead in Zoho CRM with direction, duration, and timestamp.
Missed call trackingMissed inbound calls are flagged and tracked; a return call marks them as resolved.
Multi-agent supportEach agent has their own extension — calls ring to the right person.

How does it work?

GoDesk Telephony uses WebRTC audio delivered over a secure connection, so calls run entirely in the browser. When a call connects:

  1. The widget detects the call and displays the caller's number.
  2. If the number matches a Zoho CRM contact, that record is surfaced automatically.
  3. When the call ends, a call log is written to Zoho CRM against the matched record.

Everything happens within the CRM — agents never need to open another application.

What are the requirements?

  • Zoho CRM Professional plan or above (PhoneBridge requires CRM access)
  • A modern browser: Chrome 90+, Edge 90+, or Firefox 88+
  • A microphone (built-in or USB headset recommended)
  • Internet connection with stable upload/download speeds
  • An active GoDesk Telephony subscription with extensions assigned by your administrator

Installation & Setup

Step 1 — Install from the Zoho Marketplace

  1. Go to the Zoho Marketplace and search for GoDesk Telephony.
  2. Click Install.
  3. Select the CRM organisation to install into and accept the permissions.
  4. Zoho will redirect you back to CRM when installation is complete.

Step 2 — Activate your GoDesk account

  1. Visit omni.godesk.co.ke to sign up or log in.
  2. Select the Telephony product and choose a plan.
  3. You will receive your organisation credentials by email — keep these safe.

Step 3 — Connect GoDesk to Zoho CRM (OAuth)

GoDesk needs read access to Zoho CRM so it can match incoming call numbers to contact records and write call logs.

  1. In Zoho CRM, go to Setup → PhoneBridge → GoDesk Telephony.
  2. Click Connect to Zoho.
  3. Review the permissions and click Accept.
  4. You will be redirected back to GoDesk. You should see a green Connected status.
The OAuth connection uses Zoho's official API. GoDesk only requests the minimum permissions needed to read contacts and write call activities.

Step 4 — Assign extensions to users

Each agent who will make or receive calls needs an extension assigned.

  1. Log in to the GoDesk Admin Portal at omni.godesk.co.ke.
  2. Navigate to Telephony → Extensions.
  3. For each agent, click Assign Extension and enter their Zoho CRM email address and extension number.
  4. Click Save.
Extensions are provisioned by the GoDesk team during onboarding. Contact support@godesk.co.ke if you need additional extensions.

Step 5 — Verify the widget appears in Zoho CRM

  1. Ask one of your agents to open Zoho CRM.
  2. The GoDesk phone icon should appear in the bottom toolbar (the PhoneBridge panel).
  3. Clicking it opens the GoDesk Telephony widget.
  4. The status should show Ready with the agent's extension number.

If the widget shows Extension not found, confirm the agent's Zoho CRM email matches exactly what was entered in the admin portal.

How do I remove the integration?

Go to Zoho CRM → Setup → Marketplace → Installed Extensions, find GoDesk Telephony, and click Uninstall. This removes the widget from all users in the organisation.

User Guide

Opening the widget

  1. Log in to Zoho CRM.
  2. Click the phone icon in the bottom toolbar to open the PhoneBridge panel.
  3. The GoDesk widget loads and shows your extension number and a Ready status (green dot).

If you see Initialising... for more than 10 seconds, try refreshing the CRM page.

Making a call — Click-to-dial

  1. Open any Contact, Lead, or Deal record in Zoho CRM.
  2. Click the phone number field — a dial icon appears next to it.
  3. Click the dial icon. The GoDesk widget opens automatically and dials the number.

Making a call — Manual dial

  1. Open the GoDesk widget.
  2. Type the number in the dial pad input field (include the country code, e.g. +254712345678).
  3. Press Enter or click the green Call button.

Receiving a call

  1. The GoDesk widget expands automatically and shows the caller's number.
  2. If the number matches a CRM contact, their name is displayed.
  3. Click the green Answer button to pick up.
  4. Click the red Hang up button to end the call.

Make sure your browser has microphone permission granted for Zoho CRM. On first use, the browser will ask — click Allow.

During a call — controls

Mute yourselfClick the microphone icon. Click again to unmute.
Put on holdClick the pause icon. The caller hears hold music. Click again to resume.
Send keypad tones (DTMF)Click the keypad icon to open the dial pad. Press keys to navigate IVR menus.
End the callClick the red hang-up button.

After a call — automatic logging

Once a call ends, GoDesk automatically logs the call to Zoho CRM:

  • Direction — Inbound or Outbound
  • Duration — total talk time
  • Date & time — when the call occurred
  • Contact match — linked to the CRM record if the number was recognised

You can view call logs in the Activities section of any contact or lead record.

Missed calls

If you miss an inbound call:

  • The widget shows a Missed indicator.
  • The call is logged in Zoho CRM as a missed call activity.
  • When you call that number back, the missed call is automatically marked as returned.

First-time setup: entering your extension

If your administrator has not yet linked your Zoho CRM account to an extension:

  1. Enter the extension number provided by your administrator (e.g. 1001).
  2. Click Connect.
  3. The widget will register and show Ready.

Your extension is saved in this browser. To change your extension, click the Change extension link at the bottom of the setup screen.

Troubleshooting & FAQ

Widget shows "Initialising..." indefinitely

Cause: The browser is waiting for microphone permission, or the CRM page did not fully load.

Fix:

  1. Refresh the Zoho CRM page.
  2. When the browser prompts for microphone access, click Allow.
  3. If no prompt appears, check your browser's site permissions: go to Settings → Privacy & Security → Site Settings → Microphone and make sure crm.zoho.com is allowed.

Widget shows "Extension not found"

Cause: Your Zoho CRM email address is not linked to an extension in the GoDesk admin portal.

Fix: Contact your CRM administrator and ask them to assign an extension to your email address. Alternatively, enter your extension number manually when the setup screen appears.

Widget shows "Init failed" or "Reconnecting..."

Cause: The widget could not establish a connection to the GoDesk phone system.

Fix:

  1. Check your internet connection.
  2. Refresh the Zoho CRM page.
  3. If the issue persists, contact support@godesk.co.ke and include your extension number and the approximate time the error occurred.

No audio on calls

Cause: Browser audio output settings, or microphone permission not granted.

Fix:

  1. Confirm your headset or speakers are selected as the default audio output.
  2. Check that the CRM tab has microphone permission.
  3. Try a different browser (Chrome is recommended).

Click-to-dial does not trigger the widget

Cause: The GoDesk Telephony extension may not be set as the default PhoneBridge provider.

Fix: In Zoho CRM, go to Setup → PhoneBridge. Ensure GoDesk Telephony is selected as the active provider. Save and refresh the CRM.

Call logs are not appearing in Zoho CRM

Cause: The OAuth connection between GoDesk and Zoho CRM may have expired.

Fix (administrator):

  1. Go to Zoho CRM → Setup → PhoneBridge → GoDesk Telephony.
  2. Click Reconnect and complete the OAuth flow again.
  3. Confirm the status shows Connected.

FAQ — Can I use GoDesk Telephony on mobile?

GoDesk Telephony runs in a desktop browser. Mobile browser support is not available at this time. For mobile calling, contact support@godesk.co.ke to ask about the GoDesk mobile app roadmap.

FAQ — Can multiple agents share one extension?

No. Each extension is assigned to one agent. If two agents share an extension, only one can be registered at a time and inbound calls will only ring for the registered agent. Contact your administrator to request additional extensions.

FAQ — Is my call data secure?

Yes. All signalling and audio is encrypted in transit using TLS/SRTP. GoDesk does not store raw audio recordings unless the call recording feature is explicitly enabled on your account.

Overview

What is GoDesk SMS?

GoDesk SMS brings two-way text messaging into Zoho CRM. Agents send and receive SMS from the CRM sidebar without switching apps. Every message thread is stored against the contact record and visible to the whole team.

Send SMSSend a text message to any contact directly from their CRM record.
Receive SMSInbound messages appear in the CRM sidebar in real time.
Conversation threadsFull message history per contact — all agents see the same thread.
Contact matchingIncoming messages are automatically linked to the matching CRM contact by phone number.
Unread indicatorsUnread message counts surface in the CRM so agents know who to follow up with.
Message templatesSave and reuse common responses to speed up agent workflows.

How does it work?

  1. An agent opens a contact record in Zoho CRM.
  2. The GoDesk SMS panel appears in the right sidebar.
  3. The agent sends a message, which is delivered from the organisation's business SMS number.
  4. When the contact replies, the message appears in the thread and is logged as an activity on the contact record.

Everything stays in Zoho CRM — no separate messaging app needed.

What are the requirements?

  • Zoho CRM account
  • A modern browser: Chrome 90+, Edge 90+, or Firefox 88+
  • An active GoDesk SMS subscription with a provisioned business SMS number

Installation & Setup

Step 1 — Install from the Zoho Marketplace

  1. Go to the Zoho Marketplace and search for GoDesk SMS.
  2. Click Install.
  3. Select the CRM organisation and accept the permissions.
  4. Zoho redirects you back to CRM when installation is complete.

Step 2 — Activate your GoDesk SMS account

  1. Visit omni.godesk.co.ke to sign up or log in.
  2. Select the SMS product and choose a plan.
  3. During onboarding, GoDesk provisions a business SMS number for your organisation. This is the number your customers will see.

Step 3 — Connect GoDesk SMS to Zoho CRM

  1. In Zoho CRM, go to Setup → Marketplace → Installed Extensions → GoDesk SMS → Configure.
  2. Enter the API Key from the GoDesk Admin Portal (SMS → Settings → API Key).
  3. Click Test Connection.
  4. If the test succeeds, click Save. If it fails, verify the API Key and try again.

Step 4 — Verify the SMS panel appears

  1. Open any Contact or Lead record in Zoho CRM.
  2. The GoDesk SMS panel should appear in the right sidebar.
  3. Send a test message to confirm delivery.

User Guide

Opening the SMS panel

  1. Log in to Zoho CRM.
  2. Open any Contact or Lead record.
  3. The GoDesk SMS panel appears in the right sidebar of the record.
  4. If you do not see the panel, click the GoDesk SMS tab in the sidebar.

Sending a message

  1. Open a contact or lead record.
  2. In the GoDesk SMS panel, click the message input box at the bottom.
  3. Type your message.
  4. Press Enter or click the Send button (paper plane icon).

The message appears in the thread immediately with a sent indicator. The contact receives it from your organisation's business SMS number.

Messages are limited to 160 characters per SMS segment. Longer messages are sent as multi-part SMS and delivered as one message on most modern phones.

Receiving a message

When a contact replies to an SMS:

  1. Their message appears in the conversation thread automatically (no refresh needed).
  2. If you have unread messages, the GoDesk SMS panel shows an unread count badge.
  3. The latest inbound message is also logged as an activity on the contact's timeline.

Using message templates

To use a template:

  1. In the message input box, click the template icon (grid icon).
  2. Browse or search the available templates.
  3. Click a template to insert it into the input box.
  4. Edit if needed, then send.

To create a template (administrators only):

  1. Log in to the GoDesk Admin Portal.
  2. Go to SMS → Templates → New Template.
  3. Enter a name and message body. Use {{contact_name}} as a placeholder.
  4. Click Save. The template is available to all agents immediately.

Viewing message history

All messages — sent and received — are stored in the conversation thread and in the contact's Activities tab in Zoho CRM.

To view full history: scroll up in the GoDesk SMS panel, or open the contact record → Activities tab → filter by SMS.

Sending an SMS to a new number

  1. Click the compose icon (pencil) at the top of the GoDesk SMS panel.
  2. Enter the phone number including country code (e.g. +254712345678).
  3. Type your message and send.
  4. GoDesk will create a new conversation thread. If a matching CRM contact is found later, the thread is linked automatically.

Troubleshooting & FAQ

SMS panel does not appear in the sidebar

Cause: The extension may not be installed, or your CRM profile may not have access.

Fix:

  1. Ask your administrator to confirm GoDesk SMS is installed in your CRM organisation.
  2. Check that your CRM user profile has GoDesk SMS permission enabled (Setup → Users & Control → Profiles).
  3. Try opening a different contact record — the panel only shows on Contact and Lead records.

Messages are not being delivered (outbound)

Cause: The recipient's number may be invalid, or the GoDesk SMS connection may have a problem.

Fix:

  1. Confirm the contact's phone number includes the country code (e.g. +254 for Kenya).
  2. Check for any error indicator next to the sent message.
  3. Log in to the GoDesk Admin Portal and verify the SMS number status is Active.
  4. Contact support@godesk.co.ke if the issue affects multiple contacts.

Inbound messages are not appearing in CRM

Cause: The webhook connection between GoDesk and Zoho CRM may have dropped.

Fix (administrator):

  1. Go to Zoho CRM → Setup → Marketplace → Installed Extensions → GoDesk SMS → Configure.
  2. Click Test Connection. If it fails, click Reconnect.
  3. Re-enter the API Key from the GoDesk Admin Portal and save.

Template variables not being replaced

Cause: The contact record is missing the name field, or the template was used on a manually composed number with no CRM match.

Fix: Open the contact record and ensure the First Name or Last Name field is filled. Save the record and try sending again.

FAQ — Can I send SMS to contacts outside my country?

Yes, as long as you include the international dialling code (e.g. +1 for the US, +44 for the UK). Delivery and any additional costs depend on your GoDesk SMS plan. Contact support@godesk.co.ke for international rate information.

FAQ — Can multiple agents reply to the same conversation?

Yes. All agents see the full conversation thread on a contact record. Any agent with access can send a reply. Messages show the sending agent's name in the GoDesk Admin Portal logs.

FAQ — What happens if a contact opts out of SMS?

If a contact replies with a standard opt-out keyword (STOP, UNSUBSCRIBE), GoDesk marks the number as opted out and future messages to that number are blocked automatically. The agent sees an opt-out indicator on the conversation thread.

FAQ — Are messages stored securely?

Yes. Messages are transmitted over encrypted connections and stored in Zoho CRM's secure infrastructure. GoDesk does not retain message content on its servers after delivery confirmation.

Still Need Help?

Our support team is available to assist with setup, configuration, and troubleshooting.

Email Support Talk to Sales