Get In Touch

Phone 201011827324
Location cairo

Overview

Connect your website, ERP, or CRM to WhatsApp through one HTTP endpoint. Authenticate with appkey + authkey, then send text, media, or a saved template.

Base URL: https://watsat.topbusiness.io
Message endpoint: POST https://watsat.topbusiness.io/api/create-message

Integration flow

Follow these steps once. After that, every order or event is one API call.

Create account & pick a plan

Register, subscribe, then open the user dashboard.

Connect a WhatsApp device

Add a device, scan the QR code, wait until status is connected.

Create an App + copy keys

My Apps โ†’ create app linked to the device (appkey). Auth Key page โ†’ copy authkey.

(Optional) Save a template

Build a reusable message with placeholders, then copy the template UUID.

Call create-message from your backend

On order paid / ticket created / reminder due โ†’ POST multipart form with keys + to + message or template_id.

(Optional) Receive inbound messages

Set the device hook URL to your HTTPS endpoint to receive customer replies.

Send message API

POST https://watsat.topbusiness.io/api/create-message ยท multipart/form-data

Field Required Description
appkeyYesApp key from My Apps
authkeyYesUser auth key
toYesReceiver number with country code
messageIf no templatePlain text, max 1000
fileNoPublic file URL: jpg,jpeg,png,webp,pdf,docx,xlsx,csv,txt
template_idIf no messageTemplate UUID
variablesNoArray of placeholder replacements

Code examples

cURL

curl --location --request POST 'https://watsat.topbusiness.io/api/create-message' \
--form 'appkey="YOUR_APP_KEY"' \
--form 'authkey="YOUR_AUTH_KEY"' \
--form 'to="2010XXXXXXXX"' \
--form 'message="Order #1001 confirmed"'

Text + file

curl --location --request POST 'https://watsat.topbusiness.io/api/create-message' \
--form 'appkey="YOUR_APP_KEY"' \
--form 'authkey="YOUR_AUTH_KEY"' \
--form 'to="2010XXXXXXXX"' \
--form 'message="Invoice attached"' \
--form 'file="https://example.com/invoice.pdf"'

Template

curl --location --request POST 'https://watsat.topbusiness.io/api/create-message' \
--form 'appkey="YOUR_APP_KEY"' \
--form 'authkey="YOUR_AUTH_KEY"' \
--form 'to="2010XXXXXXXX"' \
--form 'template_id="TEMPLATE_UUID"' \
--form 'variables[{name}]="Ahmed"' \
--form 'variables[{order}]="ORD-1001"'

PHP

$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://watsat.topbusiness.io/api/create-message',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => [
    'appkey'  => 'YOUR_APP_KEY',
    'authkey' => 'YOUR_AUTH_KEY',
    'to'      => '2010XXXXXXXX',
    'message' => 'Hello from API',
  ],
]);
echo curl_exec($curl);
curl_close($curl);

Errors

HTTP Meaning
200message_status: Success
401Invalid keys, expired plan, missing template, or send failed
403Unsupported file type
422 / JSONValidation errors (phone, required fields)

Success body

{
  "message_status": "Success",
  "data": {
    "from": "SENDER_NUMBER",
    "to": "RECEIVER_NUMBER",
    "status_code": 200
  }
}

Inbound webhook

To receive customer replies into your system:

  1. Open the connected device settings
  2. Set Hook URL to your HTTPS endpoint
  3. WhatSender posts the inbound payload to that URL

Keyword chatbot replies can also run inside the panel without your server.

Go-live checklist

  • Device status is connected
  • App is active and linked to that device
  • Plan is not expired
  • Monthly message limit not exceeded
  • Test one real number before production traffic