Introduction

Welcome to the WaBotick WhatsApp Business API documentation. WaBotick is a robust SAAS platform enabling automated message routing, interactive customer management, order catalog synchronization, automated sequences, and team collaborations.

Our API is built on REST principles and uses standard HTTP responses. All POST requests accept application/x-www-form-urlencoded payload headers by default unless specified otherwise. This documentation provides copyable code blocks, real-time code snippet updates based on parameter fields, and complete response payloads to integrate with your tech stack.

ℹ️

Official Client Note

Ensure you obtain your official apiToken from your dashboard profile before initializing the API integration.

                Quick Start cURL
              
                curl -X POST https://app.wabotick.com/api/v1/whatsapp/template/list \
  -d "apiToken=YOUR_API_TOKEN" \
  -d "phone_number_id=YOUR_PHONE_NUMBER_ID"

Authentication

Authentication to the WaBotick API is managed using an API key parameter passed inside the body variables as apiToken for all requests.

Never share your API Token publicly. Keep it securely stored in your server environment variables.

⚠️

Security Alert

Do not embed your apiToken directly in client-side code (frontend JavaScript). Always route queries through a backend system.

                Auth Parameter Definition
              
                {
  "apiToken": "YOUR_PERSONAL_API_TOKEN"
}

Configuration & Base URL

To configure your workspace quickly, fill in the Base URL and apiToken inputs in the top navbar. All endpoint code snippets on the right side of this page will instantly update with your parameters.

Standard endpoints use the following scheme:

https://app.wabotick.com/api/v1/...

Note: The Teams API endpoints route to our secondary server dashboard host: https://dash.teleobi.com/api/v1/....

Environment Variable	Default Value
`base_url`	`https://app.wabotick.com`
`apiToken`	`5637\|ciBhl9N15asdYAUd4P3acPc8gER2EXx7`

POST /api/v1/whatsapp/account/connect

Connect WhatsApp Account

Initialize or link a WhatsApp Business Account (WABA) to the user's workspace using API credentials and Meta's access token.

Request Body (urlencoded)

apiToken *

string

Your API token generated from your dashboard profile.

user_id *

string

The account owner's user identifier.

whatsapp_business_account_id *

string

Meta WhatsApp Business Account ID.

access_token *

string

Permanent system user access token retrieved from Meta App Dashboard.

Simulated Response

{
  "status": "success",
  "message": "WhatsApp Account connected successfully.",
  "data": {
    "account_id": 14022,
    "user_id": "YOUR_USER_ID",
    "whatsapp_business_account_id": "YOUR_WABA_ID",
    "connected_at": "2026-06-24T10:00:00.000Z"
  }
}

POST /api/v1/whatsapp/send/template

Send Template Message

Send an approved WhatsApp Business template message to a customer's registered phone number.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

Sender WhatsApp phone number ID.

template_id *

string

The identifier of the message template.

phone_number *

string

Recipient phone number with country code (no leading + or 00).

Simulated Response

{
  "status": "success",
  "message": "Template message sent successfully.",
  "data": {
    "message_id": "wamid.HBgLOTE5MDAwMDAwMDAwFQIAERgSRjQ1QzBCM0EyN0M4OTUzNkFFAA=="
  }
}

POST /api/v1/whatsapp/send

Send Message Inside 24 Hours Window

Send standard plain text messages to a subscriber. This is only available if the user initiated contact inside the last 24 hours.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

message *

string

Plain text body content of the message.

phone_number *

string

Simulated Response

{
  "status": "success",
  "message": "Message sent inside window.",
  "data": {
    "message_id": "wamid.HBgLOTE5MDAwMDAwMDAwFQIAERgSOTE3NjZDOTVDRkM5N0FBQUEyAA=="
  }
}

POST /api/v1/whatsapp/get/conversation

Get Conversation History

Fetch the chat history and logs between a phone number and the business agent with offset parameters.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

phone_number *

string

limit

number

Amount of records to return. Defaults to 20.

offset

number

Skip specific counts of chat logs for paging.

Simulated Response

{
  "status": "success",
  "data": [
    {
      "direction": "incoming",
      "message": "Hey there! I am interested in your pricing.",
      "timestamp": "2026-06-24T09:45:00.000Z"
    },
    {
      "direction": "outgoing",
      "message": "Hello from Postman",
      "timestamp": "2026-06-24T10:00:00.000Z"
    }
  ]
}

POST /api/v1/whatsapp/trigger-bot

Trigger Bot Flow

Force-trigger a specific automated bot visual builder sequence or conversational flow for a targeted customer.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

bot_flow_unique_id *

string

Unique identifier generated in flow canvas.

phone_number *

string

Simulated Response

{
  "status": "success",
  "message": "Flow initiated successfully for 919000000000."
}

POST /api/v1/whatsapp/template/list

Get Template List

Download and display lists of Meta WhatsApp Business templates that are approved and synced with the user account.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

Simulated Response

{
  "status": "success",
  "data": [
    {
      "template_id": "welcome_notification",
      "category": "UTILITY",
      "language": "en",
      "status": "APPROVED",
      "components": [
        {
          "type": "BODY",
          "text": "Hello, thank you for subscribing to our updates."
        }
      ]
    }
  ]
}

POST /api/v1/whatsapp/subscriber/get

Get Subscriber

Inspect CRM profile details, attributes, custom fields, and labels mapped to a subscriber phone number.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

phone_number *

string

Simulated Response

{
  "status": "success",
  "data": {
    "subscriber_id": 9822,
    "first_name": "Dishang",
    "last_name": "M",
    "phone_number": "919000000000",
    "gender": "male",
    "labels": ["Lead", "Active"],
    "custom_fields": {
      "company": "WaBotick"
    }
  }
}

POST /api/v1/whatsapp/subscriber/create

Create Subscriber

Directly inject a new contact into your marketing workspace databases manually.

Request Body (urlencoded)

apiToken *

string

phoneNumberID *

string

Please note key is case-sensitive (camelCase: phoneNumberID).

name *

string

phoneNumber *

string

Please note key is case-sensitive (camelCase: phoneNumber).

Simulated Response

{
  "status": "success",
  "message": "Subscriber created successfully.",
  "data": {
    "subscriber_id": 9823,
    "name": "User Name",
    "phone_number": "919000000000"
  }
}

POST /api/v1/whatsapp/subscriber/list

List Subscribers

Retrieve paginated lists of workspace subscribers with flexible order sorting.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

limit

number

offset

number

orderBy

string

Sort order parameters (e.g. id DESC or created_at ASC).

Simulated Response

{
  "status": "success",
  "data": [
    {
      "subscriber_id": 9822,
      "name": "Dishang M",
      "phone_number": "919000000000"
    }
  ],
  "pagination": {
    "total": 1,
    "limit": 20,
    "offset": 0
  }
}

POST /api/v1/whatsapp/subscriber/update

Update Subscriber

Update specific details such as name, gender, label association, and demographic attributes for an existing contact.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

phone_number *

string

first_name

string

last_name

string

gender

string

label_ids

string

Comma-separated list of label IDs to assign.

Simulated Response

{
  "status": "success",
  "message": "Subscriber updated successfully."
}

POST /api/v1/whatsapp/subscriber/delete

Delete Subscriber

Remove a contact and clear associated telemetry tracking databases permanently.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

phone_number *

string

Simulated Response

{
  "status": "success",
  "message": "Subscriber deleted successfully."
}

POST https://dash.teleobi.com/api/v1/whatsapp/subscriber/chat/assign-to-team-member

Assign Chat to Team Member

Assign a customer conversation to a specific agent, dashboard support agent, or team member.

ℹ️

External Endpoint Domain

This endpoint communicates directly with dash.teleobi.com instead of the standard base URL.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

phone_number *

string

team_member_id *

string

Agent user ID to assign the chat logic.

Simulated Response

{
  "status": "success",
  "message": "Chat successfully assigned to team member."
}

POST /api/v1/whatsapp/subscriber/reset/user-input-flow

Reset User Input Flow

Clear current conversation contexts or prompt variables to force the customer to re-enter a bot canvas automation from step one.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

phone_number *

string

Simulated Response

{
  "status": "success",
  "message": "User input flow reset successfully."
}

POST /api/v1/whatsapp/subscriber/chat/assign-custom-fields

Assign Custom Fields

Attach dynamic properties or custom metadata fields (JSON string form) to a targeted chat profile.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

phone_number *

string

custom_fields *

string (JSON)

A JSON string containing the fields to update.

Simulated Response

{
  "status": "success",
  "message": "Custom fields assigned successfully."
}

POST /api/v1/whatsapp/subscriber/chat/assign-labels

Assign Labels to Subscriber

Append a set of tag classifications to a subscriber profile using target Label IDs.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

phone_number *

string

label_ids *

string

Comma-separated label identifiers.

Simulated Response

{
  "status": "success",
  "message": "Labels assigned successfully."
}

POST /api/v1/whatsapp/subscriber/chat/remove-labels

Remove Labels from Subscriber

Remove specified label tag relations from a subscriber profile.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

phone_number *

string

label_ids *

string

Simulated Response

{
  "status": "success",
  "message": "Labels removed successfully."
}

POST /api/v1/whatsapp/subscriber/chat/assign-sequence

Assign Sequences to Subscriber

Enroll a subscriber in automated message scheduler drip campaigns using sequence IDs.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

phone_number *

string

sequence_ids *

string

Comma-separated sequence identifier list.

Simulated Response

{
  "status": "success",
  "message": "Sequences assigned successfully."
}

POST /api/v1/whatsapp/subscriber/chat/remove-sequence

Remove Sequences from Subscriber

Unsubscribe a contact from specified campaign sequences.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

phone_number *

string

sequence_ids *

string

Simulated Response

{
  "status": "success",
  "message": "Sequences removed successfully."
}

POST /api/v1/whatsapp/label/list

List Labels

Retrieve a list of all active labels configured in the user workspace.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

Simulated Response

{
  "status": "success",
  "data": [
    {
      "id": 1,
      "name": "Lead",
      "color": "#3B82F6"
    },
    {
      "id": 2,
      "name": "VIP Customer",
      "color": "#10B981"
    }
  ]
}

POST /api/v1/whatsapp/label/create

Create Label

Create a new tag designation to segment, sort, and trigger bot sequence assignments.

Request Body (urlencoded)

apiToken *

string

phone_number_id *

string

label_name *

string

Simulated Response

{
  "status": "success",
  "message": "Label created successfully.",
  "data": {
    "label_id": 3,
    "name": "VIP Customer"
  }
}

POST /api/v1/whatsapp/catalog/list

Get Catalog List

Fetch details regarding connected product catalogs synced from Facebook Business Manager.

Request Body (urlencoded)

apiToken *

string

Simulated Response

{
  "status": "success",
  "data": [
    {
      "catalog_id": "902110283",
      "name": "WaBotick Main Store",
      "status": "CONNECTED"
    }
  ]
}

POST /api/v1/whatsapp/catalog/sync

Catalog Sync

Force updates and synchronize store collection catalogs with the Meta Commerce Manager.

Request Body (urlencoded)

apiToken *

string

whatsapp_catalog_id *

string

Commerce catalog identifier key.

Simulated Response

{
  "status": "success",
  "message": "Catalog sync job dispatched successfully."
}

POST /api/v1/whatsapp/catalog/order/list

Catalog Order List

Retrieve WhatsApp order checkout cart details initiated by subscribers in WhatsApp chat catalogs.

Request Body (urlencoded)

apiToken *

string

whatsapp_catalog_id *

string

Simulated Response

{
  "status": "success",
  "data": [
    {
      "order_id": 48210,
      "order_unique_id": "ORD-7762A",
      "amount": 2500,
      "currency": "INR",
      "cart_status": "Approved",
      "items": [
        {
          "product_retailer_id": "SKU-990",
          "quantity": 2,
          "item_price": 1250
        }
      ]
    }
  ]
}

POST /api/v1/whatsapp/catalog/order/status-change

Update Catalog Order Status

Approve, decline, or process checkout cart orders received through WhatsApp storefronts.

Request Body (urlencoded)

apiToken *

string

order_unique_id *

string

cart_status *

string

Simulated Response

{
  "status": "success",
  "message": "Order status updated successfully."
}