[ API DOCUMENTATION ]
This documentation will provide instructions on how to quickly integrate wahgreat.com messaging services into various solutions by using HTTP API. wahgreat.com API is based on REST standards. In order to interact with our API, any HTTP client in any programming language can be used. Our apis are very strong . You can integrate our api with any kind of software or website . We are offering PHP , Javascript , Python , C# , VB.NET , Java , NodsJS and much more . Our api support single request/multiple request also supported with schedule option.
How to get started
Easy. Only two steps actually:
1. Create an account at wahgreat.com
In order to use our API, you will need credentials. You will need api_key. These credentails can be obtained by creating an account and then by logging in cutomer portal
Login
2: Scan Qr Code
Scan Qr Code To Connect Your WhatsApp (Scan)
All requests are submitted through the HTTP GET / POST Method
https://wahgreat.com/api/send.php?api_key=XXX&mobile=923xxxx&priority=0&message=HelloWorld!
Our Postman Collections for WhatsApp API
You can find our api collections on Postman https://documenter.getpostman.com/view/9576087/2s9Ykraevk
Parameters For API
api_key * | Your Api Key (API-KEY) |
mobile * | Phone with international format e.g. 923001234567 |
message * | Text Message |
priority | This parameter is optional, You can use it to create a professional queue for messages The Messages with less priority value are sent first. example of usage : priority = 0: for High priority like OTP messages. priority = 10: used with general messages. priority =20: Non-urgent notifications to your customers. priority =30: Non-urgent promotional offers to your customers. Default value : 10 |
type | 0=Text, 1= Images, 2= Documents Default Value: 0=Text type=1 => send images Supported extensions ( jpg , jpeg , gif , png , svg , webp , bmp ) . Max file size : 3 MB . type=2 => send documents Supported most extensions like ( zip , xlsx , csv , pptx , docx ....etc ) . . Max file size : 3 MB Images & Documents Can be Sent Via A Live URL Path i.e (url=https://sample-url.com/image.jpg) OR Directly Upload From Your System (file=C:/Users/Downloads/sample.jpg) Send Images Sample Code Send Documents Sample Code |
url (optional) | image / documents HTTP Link (URL Address) (if type = 1 or 2)
https://sample-videos.com/img/Sample-jpg-image-50kb.jpg |
file (optional) | use the following parameter file to send a direct file instead of any URL, Example: file=C:/Users/Downloads/sample.jpg |
schedule | Schedule Your Messages schedule=1 schedule_time=2024-12-29 00:55:18 Sample Code |
personalized | Send Customized SMS (Text Data Will Be Change In Each & Every Messages) personalized=1 message=[{"mobile":923101234567,"message":"Hello Ahmad Shahzad"},{"mobile":923011234567,"message":"Hello Ali Ahmad"},{"mobile":923331234567,"message":"Hello Mustafa Kamal"}] Sample Code |
API Sample Codes
php - cURL
<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://wahgreat.com/api/send.php', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS => 'api_key=YOUR-SECRET-API-KEY&mobile=923XXX&message=HelloWorld', CURLOPT_HTTPHEADER => array( 'Content-Type: application/x-www-form-urlencoded' ), )); $response = curl_exec($curl); curl_close($curl); echo $response; ?>
Axios Method
var axios = require('axios'); var qs = require('qs'); var data = qs.stringify({ 'api_key': 'YOUR-SECRET-API-KEY', 'mobile': '923XXXX', 'message': 'HelloWorld' }); var config = { method: 'post', maxBodyLength: Infinity, url: 'https://wahgreat.com/api/send.php', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, data : data }; axios(config) .then(function (response) { console.log(JSON.stringify(response.data)); }) .catch(function (error) { console.log(error); });
jQuery Method
var settings = { "url": "https://wahgreat.com/api/send.php", "method": "POST", "timeout": 0, "headers": { "Content-Type": "application/x-www-form-urlencoded" }, "data": { "api_key": "YOUR-SECRET-API-KEY", "mobile": "923XXXX", "message": "HelloWorld" } }; $.ajax(settings).done(function (response) { console.log(response); });
http.client Method
import http.client conn = http.client.HTTPSConnection("wahgreat.com") payload = 'api_key=YOUR-SECRET-API-KEY&mobile=923XXXX&message=HelloWorld' headers = { 'Content-Type': 'application/x-www-form-urlencoded' } conn.request("POST", "/api/send.php", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
cURL (Bash)
curl --location --request POST 'https://wahgreat.com/api/send.php' \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data-urlencode 'api_key=YOUR-SECRET-API-KEY' \ --data-urlencode 'mobile=923XXXX' \ --data-urlencode 'message=HelloWorld'
OkHttp - Method
OkHttpClient client = new OkHttpClient().newBuilder() .build(); MediaType mediaType = MediaType.parse("application/x-www-form-urlencoded"); RequestBody body = RequestBody.create(mediaType, "api_key=YOUR-SECRET-API-KEY&mobile=923XXXX&message=HelloWorld"); Request request = new Request.Builder() .url("https://wahgreat.com/api/send.php") .method("POST", body) .addHeader("Content-Type", "application/x-www-form-urlencoded") .build(); Response response = client.newCall(request).execute();
VB.NET
Imports System.Net Imports System.Text Module example Sub Main() Dim WebRequest As HttpWebRequest WebRequest = HttpWebRequest.Create("https://wahgreat.com/api/send.php") Dim postdata As String = "api_key={TOKEN}&mobile=&body=HellowWordld" Dim enc As UTF8Encoding = New System.Text.UTF8Encoding() Dim postdatabytes As Byte() = enc.GetBytes(postdata) WebRequest.Method = "POST" WebRequest.ContentType = "application/x-www-form-urlencoded" WebRequest.GetRequestStream().Write(postdatabytes) 'WebRequest.GetRequestStream().Write(postdatabytes, 0, postdatabytes.Length) Dim ret As New System.IO.StreamReader(WebRequest.GetResponse().GetResponseStream()) console.writeline(ret.ReadToEnd()) End Sub End Module
C# API
var options = new RestClientOptions("https://wahgreat.com") { MaxTimeout = -1, }; var client = new RestClient(options); var request = new RestRequest("/api/send.php", Method.Post); request.AddHeader("Content-Type", "application/x-www-form-urlencoded"); request.AddParameter("api_key", "YOUR-SECRET-API-KEY"); request.AddParameter("mobile", "923XXXX"); request.AddParameter("message", "HelloWorld"); RestResponse response = await client.ExecuteAsync(request); Console.WriteLine(response.Content);