Zoho CRM WhatsApp Integration: Setup with Workflow Rules

SyncMate blog image with a WhatsApp tile, titled Zoho CRM WhatsApp integration setup guide

Quick answer: To send WhatsApp messages from Zoho CRM, create a webhook in Zoho that calls the message API of SyncMate by Assistro. Then attach it to a workflow rule as an instant action. When a record matches the rule, Zoho sends the request and SyncMate delivers the message from your connected WhatsApp number. You need Zoho CRM Standard or higher, because the Free edition has no webhooks.

Sources checked on 9 November 2026, with SyncMate details confirmed by our product team on 11 November 2026. Spotted an error? Report a correction. Read about Assistro.

Key Takeaways

  • The setup has two halves: a Zoho webhook that holds the message, and a workflow rule that decides when it fires.
  • Webhooks aren't available on Zoho CRM's Free edition. Standard and higher editions include one webhook per workflow action.
  • Each request needs your SyncMate token, an Integration: zoho header and a phone number that includes the country code.
  • Zoho retries a failed webhook once, after 15 minutes, so test before you switch a rule on.
  • It works with your own number linked by QR code or an official Cloud API number. Your own number isn't the official API, so only message people who've opted in.

In this guide: How it works · Before you start · Setup in 6 steps · Workflow ideas · Zoho limits · Troubleshooting · Zoho's own WhatsApp feature · Safe sending · FAQ

How the integration works

Zoho CRM workflow rules run actions automatically when a record meets your criteria. One of those actions is a webhook, which sends an HTTP request to a URL you choose (Zoho CRM help: Webhooks).

SyncMate gives you that URL. Its single-message endpoint accepts a phone number and a message, then sends it from the WhatsApp number you've linked to SyncMate (SyncMate developer guide).

Put together, the flow looks like this:

  1. A lead or contact is created or edited in Zoho CRM.
  2. A workflow rule checks it against your conditions.
  3. If it matches, the rule calls your webhook.
  4. The webhook posts the record's phone number and a personalised message to SyncMate.
  5. SyncMate sends the WhatsApp message.

No code runs on your side. You fill in forms in Zoho and paste one token from SyncMate.

This guide uses the own-number route, where you link a WhatsApp number to SyncMate by QR code. The Zoho integration also works with an official Cloud API number connected to SyncMate. On that route, Meta's rules apply, including approved templates for messages you start.

What you need before you start

Check these four things first. If a setup fails later, come back to this list.

Requirement

Why it matters

Where to check

Zoho CRM Standard, Professional, Enterprise or Ultimate

Webhooks aren't available in the Free edition

Zoho CRM feature list

Zoho admin access, or permission to manage automation

You'll create webhooks and workflow rules in Setup

Zoho CRM Setup

A SyncMate account with WhatsApp connected

SyncMate sends from the number you link by QR code

Connect your WhatsApp

An active SyncMate plan with SyncMate's Zoho CRM add-on

Sending needs a main plan plus the add-on, which includes the API token

SyncMate pricing

You'll also need phone numbers stored with the country code, for example 919876543210. SyncMate removes +, spaces and dashes automatically, but it can't add a missing country code.

For what SyncMate can do with Zoho beyond this guide, see the WhatsApp Zoho CRM integration page. SyncMate is priced per integration, with a 7-day free trial. See current plans on the pricing page, shown in your local currency.

How to set up the integration in 6 steps

The steps below use a common example: send a welcome message when a new lead is created. You can change the module, trigger and wording afterwards.

Step 1: Connect WhatsApp to SyncMate

Log in to SyncMate and open WhatsApp Manager. Click Scan QR to Connect and scan the code from your phone under WhatsApp > Linked devices > Link a device. Click Verify to check that it shows "WhatsApp is connected!" (SyncMate user guide).

Don't move on until the connection shows as connected. If WhatsApp isn't connected, Zoho's requests can't be sent.

Step 2: Copy your SyncMate API token

In SyncMate, open the Zoho CRM integration page and generate your API token there, then copy it. The token comes with SyncMate's Zoho CRM add-on.

Treat the token like a password. Anyone who has it can send messages from your connected number.

Step 3: Create the webhook in Zoho CRM

In Zoho CRM, go to Setup > Automation > Actions > Webhooks and click Configure Webhook (Zoho CRM help). Fill in the form:

Zoho field

What to enter

Name

SyncMate - new lead welcome

Method

POST

URL to Notify

https://app.assistro.co/api/v1/wapushplus/single/message

Authorization Type

General

Module

Leads

Step 4: Add the token header and the message body

Under Header, add three Custom Parameters:

Parameter name

Value

Authorization

Bearer YOUR_SYNCMATE_TOKEN

Content-Type

application/json

Integration

zoho

The Integration: zoho header tells SyncMate to count the message against your SyncMate Zoho CRM add-on.

Under Body, choose Raw and the JSON format. Paste this, then replace each ${...} value using Zoho's merge-field picker (type # in the editor to open it):

{
"msgs": [
{
"number": "${Leads.Mobile}",
"message": "Hi ${Leads.First Name}, thanks for getting in touch with us. I'll call you today to talk through what you need."
}
]
}

What each part does:

  • number is the WhatsApp number, including the country code. +, spaces and dashes are removed automatically.
  • message is the text. Merge fields let every message use the lead's own details.

Only number and message are required.

The form also shows a read-only Preview URL, so you can check the endpoint. Click Save.

Step 5: Attach the webhook to a workflow rule

Go to Setup > Automation > Workflow Rules and click Create Rule (Zoho CRM help: Workflow rules). Then:

  1. Choose the Leads module and name the rule.
  2. Set the trigger to a record action: Create.
  3. Add a condition, such as Mobile is not empty and Lead Source is Website.
  4. Under Instant Actions, choose Webhook, then select your SyncMate webhook and add it to the rule.
  5. Click Save.

Choose the trigger carefully. Zoho doesn't let you change a rule's trigger after you create it.

Step 6: Test with your own number

Create a test lead with your own mobile number in the correct format. You should get the WhatsApp message shortly after you save the lead. Then check:

  • The name and other merge fields filled in correctly.
  • Nothing arrived twice.
  • The message came from the number you linked in Step 1.

Only then share the rule with your team.

Three workflows to start with

These are common starting points. Each uses the same webhook pattern, with a different module, trigger and message.

Workflow

Module and trigger

Condition

Message idea

New lead welcome

Leads, on Create

Mobile is not empty

Thank them and say when you'll call

Contact follow-up

Contacts, on Edit of a field you choose, such as Contact Owner

Mobile is not empty

Introduce the new owner and how to reach them

Date reminder

Contacts, date-based rule

A date field you track, such as a renewal date

A reminder with the date

All three use the lead's or contact's own Mobile field. By default, Deals don't hold a mobile number the way leads and contacts do, so start with these two modules.

Each new message needs its own webhook, because the body text lives in the webhook. Name them clearly, such as SyncMate - contact owner change, so your team can find them later.

Zoho CRM limits that affect WhatsApp messages

Zoho's limits shape how far you can take this. These come from Zoho's own documentation, checked on 9 November 2026.

Limit

Value

Source

Webhooks on the Free edition

Not available

Zoho CRM feature list

Webhook calls per day, Standard

25,000 per day, or 100 per user license per day, whichever is lower

Zoho CRM feature list

Webhooks per instant action

1

Zoho CRM help: Workflow rules

Webhooks per workflow rule

Up to 6: 1 instant and 5 time-based

Zoho CRM help: Webhooks

CRM fields sent per webhook

Up to 10

Zoho CRM help: Webhooks

Header parameters

Up to 10

Zoho CRM help: Webhooks

Timeout and retry

10-second timeout, one retry after 15 minutes

Zoho CRM help: Webhooks

Two of these limits affect day-to-day sending most:

  • The 10-field cap. Keep messages focused. A name, an owner's name and a date are plenty.
  • The single retry. If SyncMate's API doesn't return a success response within 10 seconds, Zoho tries once more after 15 minutes and then stops. A success response means the request was accepted, so also keep your WhatsApp connection healthy.

Higher editions raise the daily call limit: Professional allows 50,000 calls a day, Enterprise 500,000 and Ultimate 1,000,000. Each also has a per-user cap, listed on the Zoho CRM feature list.

Troubleshooting

If the test in Step 6 doesn't work, go through these in order.

Nothing arrives

  • Check the rule's conditions. If the test lead doesn't match them, the webhook never fires.
  • Check that the phone field you mapped isn't empty. A lead with only a Phone value won't send if you mapped Mobile.
  • Check that WhatsApp is still connected in SyncMate. The troubleshooting and reconnection guide covers this.

The message goes to the wrong number or fails

The number must include the country code. A local number without one can't be delivered. If your team types numbers in different ways, agree on one format for the field you map.

Error responses

SyncMate's developer guide lists these responses:

  • 401 Unauthorized: the token is missing or wrong, or the Integration header doesn't match it. Re-copy the token, check that the header reads Bearer followed by a space and the token, and that Integration is zoho.
  • 400 Bad Request: the JSON has a formatting error or a required field is missing. Check for a missing comma or quote.
  • 200 OK: the request was successful and the messages are queued for delivery.
  • 500 Internal Server Error: something went wrong on SyncMate's side. Try again later, and contact support if it keeps happening.

Messages arrive twice

Check whether two rules fire on the same record. An Edit trigger that watches any field can also fire every time someone updates the lead. Watch a specific field instead.

SyncMate or Zoho's built-in WhatsApp feature?

Zoho CRM lists its own WhatsApp Business feature, and its feature list notes that sending WhatsApp messages requires credits (Zoho CRM feature list). If you want everything inside Zoho and don't mind buying credits, look at that first.

SyncMate is Assistro's own product, so weigh this comparison with that in mind. The SyncMate route in this guide suits a different case:

  • You want to start from a number your team already uses, linked by QR code, without Meta verification.
  • You already use SyncMate with other tools, such as Zapier, Make or your store.

SyncMate also offers the official WhatsApp Business Platform (Cloud API), through SodaInMind as a Meta Tech Partner, and the Zoho integration works on that route too. Official-route messages follow Meta's rules, including approved templates for business-initiated messages (Meta: WhatsApp pricing).

Send safely on your own number

Linking your own number by QR code isn't the official WhatsApp API. WhatsApp restricts unofficial automated clients in its Terms of Service, so a number that sends badly can be limited or banned.

SyncMate's safe-use guide lists the habits that lower the risk. These matter most for CRM messages:

  • Only message people who've opted in. WhatsApp's own guidance on using WhatsApp responsibly says it bans accounts that are reported multiple times.
  • Use merge fields so each message reads differently.
  • Don't point a rule at thousands of old records at once.
  • Warm up a new number with manual chats before you automate it.

Our article on WhatsApp ban risk and safe automation explains the risk in more detail.

Frequently asked questions

Can I connect WhatsApp to Zoho CRM's Free edition?

Not with this method. Zoho's Free edition doesn't include webhooks, and the webhook is what calls SyncMate. You'll need Standard or a higher edition.

Do I need the official WhatsApp Business API to send messages from Zoho CRM?

No. With SyncMate you can send from your own number linked by QR code, with no Meta verification. That route isn't the official API, so follow safe-sending habits. If you'd rather use the official route, the Zoho integration also works with a Cloud API number.

Which Zoho modules can trigger a WhatsApp message?

Zoho webhooks work with its primary modules, such as Leads, Contacts, Accounts and Deals, plus Meetings and Tasks. Call Logs and Notes aren't supported, according to Zoho's webhook documentation.

Are WhatsApp replies logged in Zoho CRM?

Yes. SyncMate logs incoming replies in Zoho CRM as well as the messages you send. It doesn't create or update Zoho records automatically from an incoming WhatsApp message, so add new leads yourself, or save a WhatsApp contact to Zoho CRM from the chat with the SyncMate Chrome extension.

Can Zoho CRM send to WhatsApp groups?

Yes, through SyncMate. In the webhook body, set number to the group ID (it ends in @g.us) and add "type": 2. Groups work on both your own number and an official Cloud API number. WhatsApp channels work only on your own number: use the channel ID (it ends in @newsletter) with "type": 3.

Can I personalise each message?

Yes. Use Zoho merge fields in the webhook body, such as the lead's first name or the contact owner. Zoho sends up to 10 CRM fields per webhook, which is enough for most messages.

Can I send a WhatsApp message later instead of straight away?

Yes. Zoho lets you add a webhook as a time-based action on a workflow rule, as well as an instant one. Each rule can hold up to 5 time-based webhooks, so you could send a follow-up a day after a lead arrives.

Start sending WhatsApp messages from Zoho CRM

You now have the whole setup: one webhook that holds the message and one workflow rule that decides when it goes. Start with a single rule, test it on your own number, then add more as your team gets used to it. See everything SyncMate does with Zoho on the WhatsApp Zoho CRM integration page. Comparing CRMs too? Read our HubSpot vs Freshsales vs monday.com comparison. Ready to try it?

Start your 7-day SyncMate free trial

About the author: Mohammed Qureshi is Team Lead at Assistro, where he works on SyncMate's CRM and automation integrations with customers. See Mohammed Qureshi's author profile.

Leave a Reply

Your email address will not be published. Required fields are marked *