MazBot API Documentation

Introduction

The MazBot API enables seamless WhatsApp messaging integration for your applications. Explore endpoints, request/response formats, and examples below.

Authentication

Authenticate to obtain a JWT token for API requests.

Login Endpoint

Request Parameters

Request Headers

PHP Example

curl_setopt_array($curl, [
  CURLOPT_URL => 'https://mazbot.net/api/login',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => http_build_query([
    'email' => '[email protected]',
    'password' => 'your_password'
  ]),
  CURLOPT_HTTPHEADER => ['apiKey: your_api_key'],
]);

$response = curl_exec($curl);
curl_close($curl);

$loginResponse = json_decode($response, true);
$jwtToken = $loginResponse['data']['token'] ?? null;

if (!$jwtToken) {
  throw new Exception('Login failed: ' . ($loginResponse['message'] ?? 'Unknown error'));
}Copy

Python Example

import requests

url = 'https://mazbot.net/api/login'
headers = {'apiKey': 'your_api_key'}
data = {
    'email': '[email protected]',
    'password': 'your_password'
}

response = requests.post(url, headers=headers, data=data)
login_response = response.json()
jwt_token = login_response.get('data', {}).get('token')

if not jwt_token:
    raise Exception(f"Login failed: {login_response.get('message', 'Unknown error')}")
Copy

JavaScript Example

const url = 'https://mazbot.net/api/login';
const headers = { 'apiKey': 'your_api_key' };
const data = {
  email: '[email protected]',
  password: 'your_password'
};

fetch(url, {
  method: 'POST',
  headers: headers,
  body: new URLSearchParams(data)
})
.then(response => response.json())
.then(data => {
  const jwtToken = data.data?.token;
  if (!jwtToken) {
    throw new Error(`Login failed: ${data.message || 'Unknown error'}`);
  }
})
.catch(error => console.error(error));
Copy

HTTP Example

POST /api/login HTTP/1.1
Host: mazbot.net
apiKey: your_api_key
Content-Type: application/x-www-form-urlencoded

email=your_email%40example.com&password=your_password
Copy

Success Response

{
  "success": true,
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}Copy

Error Response

{
  "success": false,
  "message": "Invalid credentials"
}Copy

Sending WhatsApp Messages

Use your JWT token to send WhatsApp template messages.

Payment Reminder:

Account Name: {{1}}
Current Plan Expiry Date: {{2}}

Please make the payment now to avoid service interruption.

Kindly ignore this message if you have already made the payment.

$templateData = [
  'template_id' => '93',
  'mobile' => '20123456789',
  'body_values' => [
    '1' => 'Ahmed',
    '2' => '2024-09-01'
  ],
  'body_matchs' => [
    '1' => 'input_value',
    '2' => 'input_value'
  ]
];Copy

Send Template Endpoint

Request Parameters

Request Headers

PHP Example (With Variables)

$templateData = [
  'template_id' => '93',
  'mobile' => '20123456789',
  'body_values' => [
    '1' => 'Ahmed',
    '2' => '2024-09-01'
  ],
  'body_matchs' => [
    '1' => 'input_value',
    '2' => 'input_value'
  ]
];

$curl = curl_init();
curl_setopt_array($curl, [
  CURLOPT_URL => 'https://mazbot.net/api/whatsapp/send-template',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => json_encode($templateData),
  CURLOPT_HTTPHEADER => [
    'Content-Type: application/json',
    'apiKey: your_api_key',
    'Authorization: Bearer your_jwt_token'
  ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;Copy

Python Example (With Variables)

import requests
import json

template_data = {
    'template_id': '93',
    'mobile': '20123456789',
    'body_values': {
        '1': 'Ahmed',
        '2': '2024-09-01'
    },
    'body_matchs': {
        '1': 'input_value',
        '2': 'input_value'
    }
}

url = 'https://mazbot.net/api/whatsapp/send-template'
headers = {
    'Content-Type': 'application/json',
    'apiKey': 'your_api_key',
    'Authorization': 'Bearer your_jwt_token'
}

response = requests.post(url, headers=headers, data=json.dumps(template_data))
print(response.text)
Copy

JavaScript Example (With Variables)

const templateData = {
  template_id: '93',
  mobile: '20123456789',
  body_values: {
    '1': 'Ahmed',
    '2': '2024-09-01'
  },
  body_matchs: {
    '1': 'input_value',
    '2': 'input_value'
  }
};

fetch('https://mazbot.net/api/whatsapp/send-template', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'apiKey': 'your_api_key',
    'Authorization': 'Bearer your_jwt_token'
  },
  body: JSON.stringify(templateData)
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error(error));
Copy

HTTP Example (With Variables)

POST /api/whatsapp/send-template HTTP/1.1
Host: mazbot.net
Content-Type: application/json
apiKey: your_api_key
Authorization: Bearer your_jwt_token

{
  "template_id": "93",
  "mobile": "20123456789",
  "body_values": {
    "1": "Ahmed",
    "2": "2024-09-01"
  },
  "body_matchs": {
    "1": "input_value",
    "2": "input_value"
  }
}
Copy

Success Response

{
  "success": true,
  "data": {
    "message_id": "ABEGkYZI4pQIDAgASkQw",
    "status": "sent"
  }
}Copy

Error Handling

Common errors and solutions:

Best Practices

• Securely store JWT tokens
• Validate phone numbers
• Implement retry logic
• Cache template IDs