# Zoho Desk

> Log every Allo call and SMS in Zoho Desk on a Phone ticket for the matching contact, with a call record, and sync your Zoho Desk contacts and accounts to Allo

The Zoho Desk integration logs each Allo call and SMS on a Zoho Desk ticket for the caller, with the channel **Phone**. Each call is added to the ticket as a **call record** (a Call activity) with the call details, the AI summary, the transcript and a link to the recording. SMS are added as **private comments** that only your agents see. A call and the SMS around it stay in the same ticket.

Your Zoho Desk contacts and accounts sync to Allo, edits included, so callers show up with their Zoho Desk name and account.

## How to connect

The Zoho Desk integration connects with your Zoho account. You need an Allo admin or manager to connect the integration, and we recommend connecting with a Zoho Desk administrator, so Allo can see every contact, ticket and department.

<Note>
  Call records (Call activities) are part of the Zoho Desk Professional and Enterprise editions and the trial. On the Free, Express and Standard editions, Allo adds each call to the ticket as a private comment instead, with the same content. See [Editions without call records](#editions-without-call-records).
</Note>

### Find your Zoho region

Zoho keeps each account in one data center. Your Zoho Desk address tells you which one:

| Your Zoho Desk address | Region to pick in Allo |
| --- | --- |
| `desk.zoho.eu` | Europe |
| `desk.zoho.com` | United States |
| `desk.zoho.in` | India |
| `desk.zoho.com.au` | Australia |

### Connect in Allo

<Steps>
  <Step title="Go to Integrations">
    In Allo, go to **Settings** \> **Integrations**.
  </Step>
  <Step title="Find Zoho Desk">
    Find **Zoho Desk** in the **Support** section and click **Connect**.
  </Step>
  <Step title="Pick your region">
    Select the region of your Zoho Desk account and click **Connect**.
  </Step>
  <Step title="Sign in to Zoho and accept">
    Sign in with your Zoho account. If you belong to several Zoho Desk portals, pick the portal to connect. Click **Accept** to give Allo access to Zoho Desk.
  </Step>
  <Step title="Wait for the contact import">
    Allo imports your Zoho Desk contacts and accounts. The integration shows the import in progress until the first sync finishes.
  </Step>
</Steps>

### Choose a department (optional)

Allo creates its tickets in your portal's **default department**. To use another department, go to **Settings** \> **Integrations** \> **Zoho Desk**, pick a department under **Department** and click **Save**. Only enabled departments are listed.

### Choose your support lines (optional)

Support lines decide which Allo lines send calls and SMS to Zoho Desk. Only calls and SMS on the selected lines are sent. Calls and SMS on any other line are not sent at all, so sales or personal conversations never reach your support queue.

To send every call and SMS, leave the selection on **All lines**.

To choose support lines, go to **Settings** \> **Integrations** \> **Zoho Desk**, open **Support lines**, select the lines and click **Save**.

<Note>
  For an inbound call or SMS, the line is the number the customer dialed or texted. For an outbound call or SMS, the line is the number shown to the customer. Call back or reply from a support line if you want it logged in Zoho Desk.
</Note>

### Create unknown callers in Zoho Desk (optional)

The **Create unknown callers in Zoho Desk** setting decides what happens when a caller or SMS sender is not a Zoho Desk contact yet.

- **On:** Allo creates the caller as a new Zoho Desk contact and logs the call or SMS on that contact. The new contact is named after the Allo contact, or after the phone number if the Allo contact has no name.
- **Off:** calls and SMS from numbers that are not Zoho Desk contacts are not sent to Zoho Desk.

## What syncs

**From Zoho Desk to Allo:**
- Contacts that have a phone or mobile number, with their name, email, phone and mobile numbers, title and account name
- Accounts, with their name, phone, website, industry and description

**From Allo to Zoho Desk:**
- Calls, logged as call records on Phone tickets of the matching Zoho Desk contact
- SMS, logged as private comments on Phone tickets of the matching Zoho Desk contact
- New contacts, when **Create unknown callers in Zoho Desk** is on

**Sync direction:** Two-way. Calls and SMS are sent to Zoho Desk as they happen. The first sync imports all your Zoho Desk contacts and accounts. After that, Allo checks every hour for contacts and accounts created or changed in Zoho Desk, so edits made in Zoho Desk reach Allo.

A contact moved to the trash or marked as spam in Zoho Desk is removed from Allo at the next sync. A contact whose last phone number is removed in Zoho Desk is removed from Allo too. Zoho Desk contacts without a phone number are not imported, because Allo cannot match them to a call or SMS. Allo never changes an existing Zoho Desk contact.

Allo matches the Zoho Desk contact by phone number, on the **Phone** and **Mobile** fields. National and international formats of the same number match, so a contact saved with `(415) 555-1234` or `06 12 34 56 78` is found for a call from `+14155551234` or `+33612345678`. Custom phone fields are not checked.

<Note>
  If you also use the Zoho CRM integration, the same person can come into Allo from both Zoho CRM and Zoho Desk. Allo groups contacts that share a phone number in your team.
</Note>

## How calls are synced

After each call on a support line, Allo creates a Zoho Desk ticket for the matching contact, or adds the call to the contact's recent Allo ticket (see [How follow-up calls and SMS are grouped in one ticket](#how-follow-up-calls-and-sms-are-grouped-in-one-ticket)). The ticket has:

- The channel **Phone** and the status **Open**
- Your default department, or the department picked in Allo
- The tags `allo` and `allo-call`
- A subject with the call details, for example `Allo Inbound Call to US Support (+18885550100) - Answered - Leo (2m 03s)`
- A one-line description: `Phone call with US Support (+18885550100) on Nov 6, 2026, 16:35 UTC (logged by Allo)`

The call itself goes in a **call record** linked to the ticket and the contact, dated to the real start of the call, with its direction and duration. Its description contains:

- The call direction and result, the start time (UTC), the duration, and the from and to numbers
- The Allo line and the Allo user who handled the call, and the call tags
- The AI summary
- The call transcript, with speaker names when available
- A link to the call recording

The ticket and the call record are assigned to the Zoho Desk agent whose email matches the Allo user's email. If no Zoho Desk agent has that email, the ticket stays unassigned.

When the AI summary, the call tags or the call result change in Allo after the call, Allo updates the call record.

### Editions without call records

On the Free, Express and Standard editions, Zoho Desk has no call records. Allo detects it and adds the call to the ticket as a **private comment** instead, with the same content. Everything else works the same way.

### Ticket status

Every Allo ticket is **Open**, for answered calls, missed calls and voicemails alike, so your team sees each phone conversation in its queue. Allo never resolves or closes a ticket: that stays with your agents.

### How follow-up calls and SMS are grouped in one ticket

Calls and SMS with the same contact share one ticket. A new call or SMS joins the contact's Allo ticket when that ticket is Open or On Hold, is in the same department, and was last updated less than 1 hour before it. This covers the customer calling or texting again, and your team calling back or replying.

When a call or SMS joins an existing ticket:

- Allo adds it as a new call record or private comment.
- Allo renames the ticket after what it holds: `Allo calls with <contact name> on <line name> (<number>)`, `Allo SMS with …` or `Allo calls and SMS with …`.
- Allo adds the `allo-call` or `allo-sms` tag if the ticket does not carry it yet. Tags already on the ticket are kept.
- The 1-hour window restarts from that call or SMS.

Once an agent closes the ticket, the next call or SMS opens a new ticket. Allo recognizes its tickets by their **Phone** channel and their subject starting with `Allo`. Allo never adds calls or SMS to a ticket that came from another channel, such as an email.

<Warning>
  Do not rename Allo tickets to a subject that no longer starts with `Allo …`. Allo would no longer recognize them, and the next call or SMS opens a new ticket.
</Warning>

Use the `allo`, `allo-call` and `allo-sms` tags to filter Allo tickets in Zoho Desk views and workflow rules.

## How SMS are synced

After each SMS sent or received on a support line, Allo creates a Zoho Desk ticket for the matching contact, or adds the SMS to the contact's recent Allo ticket. The ticket has the channel **Phone** (Zoho Desk has no SMS channel for other apps), the tags `allo` and `allo-sms`, and a subject such as `Allo Inbound SMS to US Support (+18885550100) - Leo`.

The SMS goes in a private comment that contains:

- The SMS direction, the time it was sent (UTC), and the from and to numbers
- The Allo line and the Allo user who sent or received it
- The message text

The ticket is **Open**, for inbound and outbound SMS alike. Nothing is texted to your customer from Zoho Desk.

## Click-to-call

Click-to-call is not available for this integration.

## Troubleshooting

Check the sync status of any call from the **call list on [web.withallo.com](https://web.withallo.com)**. Each call has an integration indicator showing its sync state.

<AccordionGroup>
  <Accordion title="I cannot connect my integration">
    Only **admins** and **managers** of an Allo workspace can connect integrations. If you don't see the option, ask your workspace admin or manager to set it up.

    If the Zoho sign-in fails, check these causes:

    - **The region is wrong.** Pick the region that matches your Zoho Desk address (see [Find your Zoho region](#find-your-zoho-region)). A Europe account cannot sign in through the United States region, and the other way around.
    - **Your Zoho user has no Zoho Desk access.** Sign in with a user who is an agent in the Zoho Desk portal you want to connect.
    - **Too many connected apps.** Zoho allows a limited number of active sign-ins per app and user. If you connected and disconnected Allo many times, remove old Allo entries under **Connected Apps** in your Zoho account settings, then connect again.
  </Accordion>

  <Accordion title="Call or SMS not synced to Zoho Desk">
    Check these causes, in this order:

    - **The call or SMS was not on a support line.** Only calls and SMS on your selected support lines are sent to Zoho Desk. Check **Settings** \> **Integrations** \> **Zoho Desk** \> **Support lines**, or select **All lines** to send everything.
    - **The contact is not a Zoho Desk contact.** With **Create unknown callers in Zoho Desk** off, calls and SMS from unknown numbers are not sent. Add the phone number to the Zoho Desk contact, or turn the setting on.
    - **The phone number is in a custom field.** Allo matches on the **Phone** and **Mobile** fields only.
    - **The picked department was disabled or deleted.** Pick another department in **Settings** \> **Integrations** \> **Zoho Desk**, or go back to **Default department**.
    - **Your Zoho Desk API credits ran out.** Zoho Desk limits API calls per day for the whole portal, and the Free edition and the trial have the smallest budget. Logging a call uses about 10 to 15 credits. When the daily budget is used up, calls and SMS are not synced until the next day: sync them again from the call list.
  </Accordion>

  <Accordion title="A Zoho Desk contact does not appear in Allo">
    Check these causes:

    - **The contact has no phone or mobile number in Zoho Desk.** Allo only imports contacts with a phone number. Add the number in Zoho Desk; Allo imports the contact at the next hourly sync.
    - **The sync has not run yet.** Allo checks Zoho Desk every hour. A contact created or changed in Zoho Desk appears in Allo after the next sync.
    - **The first import is still running.** On a large Zoho Desk portal, the first import can take a while. The integration shows the import in progress until it finishes.
  </Accordion>

  <Accordion title="Duplicate contacts">
    With **Create unknown callers in Zoho Desk** on, Allo first looks for an existing Zoho Desk contact by email, then by phone number, and only creates a contact when it finds none. A duplicate appears when the same person is saved in Zoho Desk with a different email and a number in a custom phone field. Merge the contacts in Zoho Desk.
  </Accordion>

  <Accordion title="Calls show as private comments, not call records">
    Your Zoho Desk edition has no call records (Free, Express and Standard). Allo adds calls as private comments instead. Upgrade to Professional or Enterprise to get call records; new calls then use them automatically.
  </Accordion>

  <Accordion title="A follow-up call or SMS opened a new ticket">
    A follow-up call or SMS joins an existing ticket only when all of these conditions are true:

    - The ticket was created by Allo, has the **Phone** channel and a subject that starts with `Allo`.
    - The ticket is Open or On Hold, not Closed.
    - The ticket is in the department Allo uses.
    - The ticket was last updated less than 1 hour before the new call or SMS.

    If one of these conditions is false, Allo opens a new ticket.
  </Accordion>

  <Accordion title="My customer received an email about an Allo ticket">
    Allo writes the call details in call records and private comments, which are never emailed. An email comes from your own Zoho Desk setup. Check:

    - **Workflow rules and notification rules** in **Setup** \> **Automation** that send an email on new tickets. Exclude tickets tagged `allo`.
    - **The acknowledgement email** of the department, if it is set to answer every new ticket.
  </Accordion>

  <Accordion title="The ticket is unassigned">
    Allo assigns the ticket to the Zoho Desk agent whose email matches the Allo user's email. If the emails differ, the ticket stays unassigned. Use the same email in Allo and Zoho Desk, or assign Allo tickets with a Zoho Desk assignment rule on the `allo-call` or `allo-sms` tag.
  </Accordion>
</AccordionGroup>
