Connect WhatsApp to Zoho CRM on a Coexistence number

How does a WhatsApp message become a Zoho CRM record?

Meta posts every message on the number to the webhook destination you set, here an n8n Webhook node. The workflow takes the sender's number from the payload and calls Zoho's search endpoint with phone set to it, on Leads and then on Contacts. Zoho checks every phone field in the module, so a match on Mobile or Phone both count, which spares you from guessing which field a salesperson used.

When nothing comes back, n8n's Zoho CRM node creates a Lead with the WhatsApp profile name and the number. Either way the workflow now has a record id, and it writes the message as a note against that record through POST /Notes. A note needs only Note_Content and a Parent_Id naming the module and the record.

{
  "data": [
    {
      "Note_Title": "WhatsApp, inbound",
      "Note_Content": "do you have anything friday?",
      "Parent_Id": {
        "module": { "api_name": "Leads" },
        "id": "4876876000000624001"
      }
    }
  ]
}

Which Zoho permissions does the n8n credential need?

Read and create on the modules you search and write, plus create on Notes. Zoho names the note scope ZohoCRM.modules.notes.CREATE and requires the parent module's create scope beside it, so a credential that can create Leads but was never granted the notes scope fails on the last step with an authorisation error.

n8n's Zoho CRM node covers Leads, Contacts, Accounts, Deals and several sales documents, with create, upsert, get, get all, update and delete. Notes are not among its resources, which is why the note goes through an HTTP Request node. n8n lets that node reuse the Zoho credential you already connected, so there is one OAuth grant to manage rather than two.

Set the API domain to your Zoho data centre. A credential created in the EU region calls zohoapis.eu, not zohoapis.com.

How many messages can Zoho CRM absorb?

Zoho meters its API in credits per rolling 24 hours, and the budget depends on edition and user count. The Free edition gets 5,000. Standard gets 50,000 plus 250 per user, Professional 50,000 plus 500 per user, and Enterprise 50,000 plus 1,000 per user, each with an edition cap.

Each inbound message costs a search and a note write, plus a lead creation for first-time senders. That is comfortably inside a paid edition's budget for a small business number. The ceiling that bites first is usually concurrency: Free allows 5 simultaneous calls and Standard 10, so a burst of messages from a broadcast reply can queue. Set the n8n workflow to process executions one at a time if you see Zoho returning limit errors.

Do replies sent from the phone reach Zoho CRM?

They can. On a Coexistence number the WhatsApp Business app keeps working, and when someone answers from it Meta sends an echo of that outgoing message to the same webhook destination under the smb_message_echoes field.

Give the workflow a branch for echoes and write them as notes titled as outbound. The salesperson who opens the lead in Zoho then reads both sides of the conversation, and nobody has to paste screenshots into the CRM.

Messages the workflow sends itself through the Cloud API, such as an approved template after a deal changes stage, are best logged at the moment of sending, because the workflow already holds the text and the record id.

Common mistakes

• Granting the credential lead scopes but not ZohoCRM.modules.notes.CREATE. The search and the lead work, then every note fails.
• Calling zohoapis.com from an account in another Zoho data centre. Use the API domain of the region the account lives in.
• Searching Leads only. Converted customers are Contacts, and each one who writes in turns into a fresh duplicate lead.

Frequently asked questions

Keep reading