Integration Guide

Connect YVWhatsApp to Zoho CRM

Send WhatsApp template messages to your Leads and Contacts directly from Zoho CRM, and automate them from Workflows.

Install · paste your secret · send · ~5 minutes · No coding required

Send from a record

A Send WhatsApp button on each Lead/Contact lists your approved templates, pick one, fill the variables, send.

Live preview

See the exact message with your values before it goes out.

Auto-logging

Every send is saved to the contact's conversation, and optionally noted back on the Zoho record.

Workflow automation

Optionally auto-send a template when a Lead is created or a field changes.

Before you start

  • A Zoho CRM account with admin access (Professional plan or higher).
  • A YVWhatsApp account with WhatsApp connected and at least one Meta-approved template.
  • Your YVWhatsApp Webhook Secret (Step 1 below).
1

Get your Webhook Secret

Log in to YVWhatsApp and go to Settings → Integrations → Zoho CRM. Copy your Webhook Secret, you'll paste it into Zoho in Step 3.

This single secret links your Zoho org to your YVWhatsApp workspace, no connection or developer setup required.

2

Install the YVWhatsApp extension

Open the private install link you received (or find YVWhatsApp in your Zoho Marketplace) and click Install. Choose to install for all users or selected profiles.

The extension adds a Send WhatsApp button to your Leads and Contacts, no Connections, Widgets, or Functions to configure.

3

Paste your Webhook Secret

Go to Setup → Marketplace → All → YVWhatsApp → Settings and fill in:

Webhook Secret (yvwa_secret)paste the secret from Step 1
API URL (yvwa_api_url)https://wpapp.yogicverse.com (leave as-is)

Save. Your secret is stored securely and used only server-side, it never appears in the browser.

4

Send your first message

  1. Open a Lead/Contact that has a phone number.
  2. Click the Send WhatsApp button.
  3. Search and pick a template, the message shows in the preview.
  4. Fill any variables (pre-filled from the record).
  5. Click Send WhatsApp.

That's it, in-record sending is live.

5

Optional, automate from a Workflow

To auto-send a template (e.g. a welcome message on new Lead), go to Setup → Automation → Workflow Rules → Create Rule on Leads. Set a trigger, then under Actions → Function → Write your own (Deluge) paste the script provided by YVWhatsApp and set your apiUrl, webhookSecret, and templateName. Map number${Leads.Phone}, then Save & Execute with a test number.

Troubleshooting

Templates don't load / "Could not reach YVWhatsApp"

Your Webhook Secret isn't set. Open the extension's Settings and paste it into yvwa_secret.

"Webhook Secret is not set"

Same fix, add your secret in the extension Settings, then reopen the widget.

"No approved templates found"

Approve at least one template in WhatsApp/Meta, then reopen the widget.

"No phone number found"

Add a phone number to the Lead/Contact first.

Send WhatsApp button missing

Make sure the extension is installed and active. Reinstall the latest version from your private link.

Widget opens blank

Reinstall the latest extension version, then hard-refresh the record page.

Ready to set it up?

Grab your Webhook Secret and start with Step 1.