Wapkit Official Documentation

Wapkit Knowledge & Developer Docs

Everything you need to deploy, automate, and scale WhatsApp Business with Wapkit, including our certified Zoho CRM integration and developer REST APIs.

Table of Contents
Platform Overview

About Wapkit

Wapkit is an enterprise-grade WhatsApp Business solution designed for modern marketing, customer support, and sales teams. Powered by Meta’s official WhatsApp Cloud API, Wapkit unifies conversational messaging, AI-driven automation, shared inbox collaboration, and full two-way CRM synchronization into one seamless platform.

Official Meta Cloud API

Direct integration with Meta servers. High-throughput delivery, verified green tick support, and end-to-end reliability with no third-party proxies.

Conversational AI & Voice

Context-aware AI copilot trained on your private knowledge base. Capable of instant message replies, qualification, and automated outbound voice calls.

Deep CRM Bi-Directional Sync

Native integrations with Zoho CRM, Shopify, and webhooks. Every contact, conversation note, and call transcript stays synchronised in real time.

Getting Started

Quickstart Guide

Get your team up and running with Wapkit in 4 simple steps:

1

Create your Wapkit Workspace

Register your account at wapkit.com/register. Set your organization name and invite key team members.

2

Connect Your WhatsApp Number

Use Meta’s Embedded Signup flow under Settings → WhatsApp. You can connect a new phone number or migrate an existing WhatsApp Business number with zero downtime.

3

Connect Zoho CRM

Navigate to Settings → Integrations → Zoho CRM. Click Connect Zoho to authorize OAuth access and enable bi-directional sync of contacts, messages, and call recordings.

4

Deploy AI Copilot & Automations

Upload your product FAQs or PDF brochures into the Knowledge Base. Configure greeting flows in the Flow Builder, and test with the live simulator.

Meta Cloud API

WhatsApp Cloud API Setup & Requirements

Wapkit utilizes Meta’s direct Cloud API to provide guaranteed message throughput and low-latency delivery.

Prerequisites for Connection

  • •Meta Business Account: An active Meta Business Suite manager account with admin privileges.
  • •Phone Number: A phone number capable of receiving SMS or Voice OTP for verification. The number must not be registered on WhatsApp Personal/Business mobile apps at the time of connection.
  • •Business Verification: Recommended for higher messaging tier limits (Tier 1: 1,000 conversations/24h, Tier 2: 10,000, Tier 3: 100,000, Unlimited).
Zoho CRM Official Integration Guide

Wapkit for Zoho CRM Integration

Zoho Marketplace Certified

Connect your WhatsApp Business conversations directly to Zoho CRM. Seamlessly capture leads, log incoming and outgoing message threads as Notes, sync AI voice call summaries, and trigger WhatsApp notifications directly from Zoho CRM automation workflows.

How Wapkit & Zoho CRM Work Together

1. WhatsApp Message

Customer texts your verified WhatsApp Business number.

2. Wapkit Automation & AI

AI qualifies lead, handles questions, or passes to human agent.

3. Zoho CRM Sync

Lead created, transcript logged, call summary attached instantly.

Step-by-Step Setup & Authorization

1Initiate OAuth Connection

In the Wapkit Dashboard, navigate to Settings → Integrations → Zoho CRM. Click the "Connect Zoho CRM" button.

2Select Zoho Data Center & Log In

Select your Zoho domain region (accounts.zoho.com, accounts.zoho.in, accounts.zoho.eu, or accounts.zoho.com.au). Sign in with your Zoho CRM administrator credentials.

3Grant Required Permissions (OAuth Scopes)

Wapkit requests only the minimal necessary permissions required to sync WhatsApp contacts and conversation records:

• ZohoCRM.modules.ALL — To create & update Leads, Contacts, and Notes.
• ZohoCRM.users.READ — To map Wapkit inbox agents to Zoho CRM users.
• ZohoCRM.settings.ALL — To read custom fields for attribute mapping.
4Configure Field Mapping & Sync Preferences

Customize how WhatsApp data translates to your Zoho CRM records:

  • Lead vs Contact preference: Choose whether new numbers create a Lead or a Contact.
  • Conversation Logging: Automatically append closed chat transcripts as a Note under the customer timeline.
  • AI Call Logs: Save AI audio call summaries, key action points, and sentiment score to the Lead description.
  • Tags Mapping: Sync Wapkit tags (e.g. "VIP", "High Intent") into Zoho CRM tag attributes.

Secure Token Handling & Data Privacy

Zoho OAuth tokens and refresh tokens are encrypted at rest using AES-256-GCM. Wapkit performs automatic background token rotation before expiry. You can revoke access at any time from Wapkit Settings or via your Zoho Account Authorized Applications screen.

Team Collaboration

Shared Team Inbox

The Wapkit Inbox brings WhatsApp, Instagram Direct, and Messenger conversations into a single collaborative workspace.

Multi-Agent Assignment & Folders

Assign incoming chats to specific agents or teams. Filter by "Assigned to Me", "Unassigned", "Resolved", or custom tag folders. Prevent agent collision with real-time presence indicators.

Quick Replies & Rich Media

Respond in seconds with pre-saved canned replies triggered by /shortcut. Send images, PDFs, audio voice notes, and interactive WhatsApp buttons without leaving the thread.

Contact Profile & Custom Attributes

View customer lifetime value, order history, tags, and custom fields right alongside the conversation. Changes automatically reflect in your connected CRM.

Human Handoff & Takeover

When an AI agent is handling a chat, agents can pause the bot with a single click to intervene manually. The AI automatically pauses for a configurable duration.

AI Copilot & Voice

AI Agents & Knowledge Base

Deploy autonomous AI agents that understand your brand guidelines, speak over 50 languages, and reference your business knowledge accurately without hallucination.

Knowledge Base Ingestion (RAG)

Upload your documents directly into Wapkit:

PDFs & Documents

Brochures, manuals, policies

Q&A / FAQs

Custom question & answer pairs

Website Scraping

Sync documentation or help centers

AI Voice Calling

Wapkit includes integrated AI voice calling. When an inbound lead requires high-touch contact or requests a phone callback, Wapkit initiates an AI voice call to qualify interest, answer spoken questions, and push the call recording and sentiment back to Zoho CRM.

Visual Automation

Flow Builder & Automations

Build no-code visual bot flows with interactive buttons, conditional rules, CRM updates, and webhook actions.

Supported Canvas Nodes

Trigger NodesKeyword, ad click, webhook
Message NodesText, media, buttons, lists
Condition NodesBranch on customer tags, input
Action NodesZoho CRM sync, API callout
Campaigns & Marketing

Broadcasts & Template Messaging

Send bulk personalized WhatsApp campaigns using Meta-approved message templates. Reach thousands of opted-in customers with high delivery rates.

Audience Segmentation

Target broadcasts by tag, past purchase history, Zoho CRM lead status, or upload a CSV list of phone numbers with custom variables.

Opt-out & Compliance Guard

Wapkit automatically respects STOP / unsubscribe keywords to ensure compliance with WhatsApp Business policies and maintain Tier 1 quality rating.

Developer Documentation

REST API Authentication

Authenticate all REST API requests by providing your API Key in the Authorization header using the Bearer scheme.

Authorization: Bearer cx_<key_id>.<secret>

API keys are provisioned under Settings → Developer → API Keys. Never expose your secret key in client-side code.

API Endpoints

Send Messages API

Send outbound text, template, or media messages programmatically to any WhatsApp user worldwide.

POST /api/v1/messages/send
curl -X POST https://api.wapkit.com/api/v1/messages/send \
  -H "Authorization: Bearer cx_live_xyz.secret_123" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "15551234567",
    "type": "text",
    "text": "Hello! Your support ticket #4928 has been updated."
  }'

Example Response (200 OK)

{
  "success": true,
  "messageId": "msg_89f02c91834a",
  "metaMessageId": "wamid.HBgLMTU1NTEyMzQ1NjcVAgARGBI1QTAx",
  "deliveryStatus": "SENT"
}
Webhook Events

Inbound Webhooks & Real-Time Events

Subscribe your server to real-time events. Wapkit delivers an HTTP POST request to your endpoint whenever a message is received, delivered, or read.

Supported Event Types

  • • message.received (Customer replied)
  • • message.delivered (Delivered to phone)
  • • message.read (Blue ticks / read)
  • • lead.created (New contact saved)
  • • call.ended (AI voice call finished)
Security

HMAC SHA-256 Webhook Verification

Every webhook payload includes an X-Wapkit-Signature header containing an HMAC SHA-256 signature calculated with your endpoint secret. Always verify this signature to prevent spoofing.

import crypto from 'crypto';

function verifyWebhookSignature(payloadBody, signatureHeader, secret) {
  const hmac = crypto.createHmac('sha256', secret);
  const digest = 'sha256=' + hmac.update(payloadBody).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(digest), Buffer.from(signatureHeader));
}
Compliance & Security

Security, Data Protection & Meta Policies

Wapkit strictly follows Meta’s WhatsApp Business Messaging Policy and global privacy standards.

24-Hour Customer Service Window

When a user sends a message, a 24-hour window opens where you can send free-form session messages. Outside the window, messages must use pre-approved Meta message templates.

Encryption & Data Deletion

All data is encrypted with TLS 1.3 in transit and AES-256 at rest. Users can request complete account and data removal via our automated Data Deletion endpoint.

Help & Support

Troubleshooting & Support

How do I re-authorize or reconnect my Zoho CRM account?

Navigate to Settings → Integrations → Zoho CRM. Click "Disconnect" and then click "Connect Zoho CRM" to start a new OAuth session and refresh tokens.

Why did my WhatsApp message template get rejected by Meta?

Common causes include generic parameter samples, aggressive promotional claims, or incorrect category selection (e.g. submitting a Marketing template under Utility). Check the Template Manager for Meta’s rejection reason.

How can I reach Wapkit technical support?

Enterprise and Zoho Marketplace users can reach our dedicated support desk at support@wapkit.com or via the in-app chat widget. Average response time is under 1 hour during business hours.

Have questions about your integration?

Our developer team is here to assist with custom workflows and Zoho CRM configuration.

Contact Support