This API is used to delete a device via API.

Before proceed, the only way to delete device is by giving correct OTP code.

The OTP code is sent to the whatsapp number on the setting menu.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.fonnte.com/delete-device',
  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 => array('otp' => ''),
  CURLOPT_HTTPHEADER => array(
    'Authorization: TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

There are 2 steps to use this API :

1. Request the OTP
2. Submit the OTP

To request the OTP, you can use the curl code above, with otp value empty.

After you got the OTP code, input the OTP code as otp value.

If you prefer to see on postman, see here.

The token is device token. see how to get token.

Response

Successfull response

{
    "detail": "device 08123456789 successfully deleted",
    "status": true
}

- invalid device : invalid token

{
    "reason": "invalid device",
    "status": false
}

- please wait x seconds before requesting new otp : wait 10 minutes before requesting new otp

{
    "reason": "please wait x seconds before requesting new otp",
    "status": false
}

- otp haven't requested : you are not following procedures, make a request first.

{
    "reason": "otp haven't requested",
    "status": false
}

- delete failed. try again in x seconds : invalid otp multiple time

{
    "reason": "delete failed. try again in x seconds",
    "status": false
}

- incorrect OTP : wrong OTP code

{
    "reason": "incorrect OTP",
    "status": false
}

This API will disconnect connected device.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.fonnte.com/disconnect',
  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_HTTPHEADER => array(
    'Authorization: TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

If you prefer to see on postman, see here.

TOKEN must be filled by your own token. See how to get token.

Response

Successfull response

{
    "detail": "device disconnected",
    "status": true
}

- Token invalid : token is not valid

{
    "detail": "token invalid",
    "status": false
}

- Device already disconnected : the device is disconnected already

{
    "detail": "device already disconnected",
    "status": false
}

This API is used to add device via API, so your application doesn't have to create manually on fonnte's dashboard.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.fonnte.com/add-device',
  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 => array('name' => 'device name','device' => '08123456789','autoread' => 'false','personal' => 'false','group' => 'false'),
  CURLOPT_HTTPHEADER => array(
    'Authorization: TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Available parameter

• name (required) (string) - device's name, min 2 max 30
• device (required) (string) - device's number (not neccessarily whatsapp number),must unique accross all user, min 8 max 15
• autoread (optional) (bool) : activate autoread chat feature, boolean
• personal (optional) (bool) : autoread personal chat, boolean
• group (optional) (bool) : autoread group chat, boolean

If you prefer to see on postman, see here.

The token is not device token! but account token.

You can only add up to 10 free devices.

example : you create 10 free devices for your clients, then 5 of them order and no longer free devices. so you can add 5 more of free devices.

However, you can only connect 1 free device out of all your free devices.

Response

Successfull response

{
    "autoread": "off",
    "device": "08123456789",
    "group": "off",
    "name": "device name",
    "personal": "off",
    "status": true,
    "token": "M@N!4Yr-Vs#CPtaopCkE"
}

on successfull device creation, you can get the basic info of the device including token.

- input invalid : there is something wrong with your data

{
    "reason": "input invalid",
    "status": false
}

- unknown user : invalid/empty account token

{
    "reason": "unknown user",
    "status": false
}

- too much free device : your account has already 10 free devices

{
    "reason": "too much free device",
    "status": false
}

- device already exist : the device number is already exist, may or may not in your account

{
    "reason": "device already exist",
    "status": false
}

This API is used to update your existing device via API

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.fonnte.com/update-device',
  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 => array('name' => 'device name','webhook' => 'https://webhookurl.com','webhookconnect' => 'https://webhookurl.com','webhookstatus' => 'https://webhookurl.com','webhookchaining' => 'https://webhookurl.com','autoread' => 'false','personal' => 'false','group' => 'false','quick' => 'false','resend' => 'false','target' => '08123456789','countryCode' => '62'),
  CURLOPT_HTTPHEADER => array(
    'Authorization: TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Available parameter

• name (required) (string) - device's name, min 2 max 30
• webhook (optional) (string) - url to receive incoming chat
• webhookconnect (optional) (string) - url to receive connection event
• webhookstatus (optional) (string) - url to receive updated message status
• webhookchaining (optional) (string) - url to receive response of chaining message
• device (required) (string) - device's number (not neccessarily whatsapp number),must unique accross all user, min 8 max 15
• autoread (optional) (bool) : activate autoread chat feature, boolean
• personal (optional) (bool) : autoread personal chat, boolean
• group (optional) (bool) : autoread group chat, boolean
• quick (optional) (bool) : autoread self chat, boolean
• resend (optional) (bool) : forward incoming attachment, boolean
• target (optional) (string) : target number for resend feature, string
• countryCode (optional) (string) : county code of the target,default 62

If you prefer to see on postman, see here.

The token is device token. see how to get token.

Response

Successfull response

{
    "detail": "device updated!",
    "status": true
}

- device not found : invalid token

{
    "reason": "device not found",
    "status": false
}

- start with webhook url : something wrong with your webhook url

{
    "reason": "webhook url *",
    "status": false
}

This API used to get information about your device

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.fonnte.com/device',
  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_HTTPHEADER => array(
    'Authorization: TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

If you prefer to see on postman, see here

TOKEN must be filled by your own token. See how to get token.

Result :

{
    "device": "6282227097005",
    "device_status": "connect",
    "expired": "18 November 2029",
    "messages": 16785,
    "name": "Fonnte admin",
    "package": "Reguler",
    "quota": "78",
    "status": true
}

Available JSON output

• device - device number
• device_status - connect or disconnect
• expired - when will this device expired
• messages - total messages requested
• name - device name
• package- package name
• quota - device's quota for sending message
• status - true

if somehow token is not correct, response status will be false

{
    "reason": "token invalid",
    "status": false
}

This API is used to get all devices information on an account.

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.fonnte.com/get-devices',
  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_HTTPHEADER => array(
    'Authorization: TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

The token is not device token! but account token.

If you prefer to see on postman, see here.

Response

Successfull response

{
    "connected": 0,
    "data": [
        {
            "autoread": "off",
            "device": "6287866250310",
            "expired": "1707782400",
            "name": "tutorial",
            "package": "Free",
            "quota": "1000",
            "status": "disconnect",
            "token": "sUqjkKH+UG+@3SmnKrhz"
        }
    ],
    "devices": 1,
    "messages": 0,
    "status": true,
    "type": "device"
}

Info :

• connected : how much is your connected device.
• data : each data represent your device data including :
  • autoread : autoread status
  • device : device number
  • expired : device expiration unix timestamp
  • name : device name
  • package : device package
  • quota : device's quota to send message
  • status : device status whether is connect or disconect
  • token : device token
• devices : total devices int this account
• messages : total messages requested in this account
• type : account type

- unknown user : your account token is invalid

{
    "reason": "unknown user",
    "status": false
}

On 14 January 2024, fonnte introduce another token which is primarily used to manage device API.

This account token will enable you to get all devices information, including how much is connect, how much is total messages requested, devices information, etc.

The other usage of this token is to do add device, update device and delete device programatically.

The device API is helping a lot on building your own integrated dashboard!

You can find this token on setting menu.

Webhook device status is used to get device status in real time.

This webhook is primarily used if you want to create your own dashboard, then when your client is connecting, the status of the device should also updated.

With this webhook, your device data should correctly updated and reduce the need of hitting api device profile repeatedly which is limited.

Furthermore, you can also use this webhook to notify your client when their device is disconnected along with it's reason.

The example below show how do you get the device status, you can modify as you need.

<?php
header('Content-Type: application/json; charset=utf-8');
$json = file_get_contents('php://input');
$data = json_decode($json, true);
$device = $data['device'];
$status= $data['status'];
$timestamp= $data['timestamp'];
$reason = isset($data['reason'])? $data['reason']:"";

Available parameter

• Device - Your device number (not connected device)
• Status - Device status, connect or disconnect
• Timestamp - Timestamp of the event
• Reason - The reason of disconnect

Poll menu is used to make a poll.

You can use the poll on send menu or autoreply menu.

example output :

The field you need to fill is shown below.

The fields of template is shown above.

• Name : poll's name
• Message : the message you want to send
• Choices: the choices provided for recipient to choose
• Select: can recipient choose multiple choices

After you finish adding the poll, you can click add and the poll will be added and ready to use.

Warning! The use of this API is not intended for frontend usage as it exposes a token that must be kept confidential. This API usage is highly not recommended unless there are specific issues with your environment preventing you from utilizing the POST method. Please use it wisely.

This API enable send message using GET method or simply using url.

you can run it on browser/put the link on button/href tag.

The url is simply using the same url as POST method.

https://api.fonnte.com/send/?queries

Queries is the query string with name and values.

If you prefer to see on postman, see here.

Available parameter

• token (required) (string) - your device's token, separate with comma for pick randomly from multiple devices
• target (required) (string) - target number, separate with comma, support variable
• message (optional) (string) - text message, support variable
• url (optional) (string) - support image, file, audio, video, optional
• filename (optional) (string) - custom filename, optional
• schedule (optional) (int) - unix timestamp to send message on schedule
• delay (optional) (string) - min 0, add - to random delay ex: 1-10 will produce random delay between 1 to 10 seconds, optional
• countryCode (optional) (string) - replace first zero with country code, default 62, set 0 to disable replacement, optional
• location (optional) (string) - format : latitude,longitude
• typing (optional) (bool) : typing indicator, default : false
• redirect (optional) (string) : redirect after process to an url
• choices (optional) (string) : poll choices, minimum 2, maximum 12, separate with comma
• select (optional) (string) : poll select limitation, single or multiple
• pollname (optional) (string) : poll name

note :

1. all value should be encoded before assigned to avoid any error/unexpected behaviour, see urlencode from php.
2. redirect parameter will redirect the page after used. if your environment support curl, it's recommended to verify and log the response before redirecting/action as not all get request will return success due to invalid value.
3. please note that file parameter not available in this method, to send a file must use url

Use Case

First of all, do not use this api in frontend! anyone can use your device to send message.

You can use this API for backend or internal use.

The only use case of this API is when your environment do not support POST method.

Sometime even curl is not available on some environment.

If that's the case, you can use it with care.

Response

All response will follow the response for API send message POST method