DEVELOPER PLATFORM

Connect HelloBotz With Any Application

Build mission-critical integrations between HelloBotz and your website, CRM, ERP, mobile app or custom backend using lightning-fast REST APIs and real-time webhook events.

Explore Endpoints → Webhook Events Talk to Developer
Your Application→ REST API / Webhook→ HelloBotz Core→ WhatsApp Cloud→ Customer
Integration Models

API & Webhooks: Two-Way Synchronization

Whether pushing data from your backend or reacting to customer replies in real time, HelloBotz gives developers complete bidirectional control.

Outbound & Actions

REST API

Your server requests HelloBotz to perform an immediate action such as dispatching a template message, importing contacts, or triggering a chatbot flow.

Your App → HTTP POST → HelloBotz API → WhatsApp Message

Key Endpoints: Send Message · Trigger Flow · Create Contact · Query Conversations · Retrieve Reports

Model: Pull / Push on-demand
Inbound & Real-time

Event Webhooks

HelloBotz notifies your server instantaneously the exact millisecond an event occurs—such as a customer replying, reading a message, or opting in.

WhatsApp Event → HelloBotz → HTTP POST → Your Webhook Listener

Key Events: message.received · message.delivered · message.read · template.approved · flow.completed

Model: Real-time event streaming (< 250ms)
Interactive Sandbox

Simulate an API Request

Experience the sub-second execution cycle of HelloBotz’s cloud messaging infrastructure.

Click the button above to simulate: Client Request → Authentication → Cloud API → 200 OK Response
SDKs & Examples

Simple Integration. Enterprise Scale.

Clean JSON payloads, standard Bearer token authentication, and comprehensive language support.

POST https://api.hellobotz.com/v1/messages 
curl -X POST "https://api.hellobotz.com/v1/messages" \
  -H "Authorization: Bearer inb_live_sec_918050854445" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "+918050854445",
    "type": "template",
    "template": {
      "name": "order_confirmation",
      "language": { "code": "en_US" },
      "components": [
        {
          "type": "body",
          "parameters": [
            { "type": "text", "text": "Aanya Kapoor" },
            { "type": "text", "text": "ORD-84920" },
            { "type": "text", "text": "₹2,499" }
          ]
        }
      ]
    }
  }'
HTTP/1.1 200 OK Content-Type: application/json
Latency: 118ms 
{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+918050854445",
      "wa_id": "918050854445"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLOTE4MDUwODU0NDQ1FQIAEhgWM0VCMDAxMkJFQ0QwNDk5OTQyM0I0MQA=",
      "message_status": "accepted"
    }
  ]
}
Real-Time Callbacks

Webhook Architecture & Event Stream

Subscribe to critical conversation and delivery events with 99.99% webhook delivery guarantees and automated exponential retries.

1. Customer Sends Message→ 2. Meta WhatsApp Cloud→ 3. HelloBotz Ingestion→ 4. Webhook HTTP POST→ 5. Your Backend CRM / DB
INBOUND EVENT STREAM ● LIVE
EVENT: message.received
SENDER: +91 98765 43210 (Karan Patel)
PAYLOAD: "Hi, I would like to book a consultation tomorrow at 3 PM"
DESTINATION: https://crm.yourcompany.com/webhooks/hellobotz
STATUS: 200 OK (Processed in 118ms)
Developer Solutions

What Can You Build with HelloBotz APIs?

From automated transactional alerts to two-way CRM sync, create tailored WhatsApp workflows.

Custom CRM Synchronization

Sync WhatsApp conversations, leads, and customer tags directly into HubSpot, Salesforce, Zoho or proprietary internal databases.

E-Commerce Order Lifecycle

Trigger automated WhatsApp alerts for order placed, dispatch tracking links, OTP cash-on-delivery confirmations, and return updates.

Appointment & Event Booking

Connect your booking system to send instant calendar invites, Google Meet links, 24-hour reminder pings, and automated rescheduling.

Payment Links & Invoicing

Dispatch dynamic UPI / Razorpay payment links, automated invoice PDFs, subscription renewal reminders, and instant payment receipts.

Lead Routing & Scoring

When leads submit a website form or ad, qualify them via bot questions and route high-value prospects to active sales reps instantly.

AI Agent Custom Workflows

Integrate your own LLM / LangChain / OpenAI agent with HelloBotz’s messaging pipe for tailored conversational intelligence.

Status Codes

Predictable HTTP Status Codes & Errors

Clear error structures make debugging integrations effortless.

Status Code Type Description Recommended Action
200 OK Success Message or action successfully validated & queued. Store message_id for delivery status tracking.
400 Bad Request Client Error Missing parameters or invalid template variable format. Verify JSON payload matches template specification.
401 Unauthorized Auth Error Invalid, expired, or missing Bearer API token. Generate new API key in HelloBotz Developer Dashboard.
429 Rate Limit Rate Exceeded API call limit exceeded (default 80 req/sec). Implement exponential backoff or request tier upgrade.
500 Server Error Meta / Server Meta WhatsApp Cloud downtime or upstream timeout. HelloBotz retries automatically with 5 retry intervals.
Workflow Tester

Interactive Trigger & Action Simulator

Test automation logic directly inside your browser.

Select a trigger + action, then click "Execute Simulated Automation".

Ready to Build with HelloBotz APIs?

Get API credentials in minutes, explore comprehensive postman collections, and integrate enterprise WhatsApp automation.

Generate Free API Keys → Read Documentation Talk to Developer Support Download Data