README

Ini merupakan package yang dikembangkan oleh Wablas.com, untuk mempermudah dalam melakukan implementasikan fitur-fitur yang dimiliki oleh Wablas.com.

Fitur

Info Device
Restart Device
Disconnect Device
Check Phone
Send Text Message
Send Media Message (Image, Video, Audio, Document)
Send Button Message
Send Footer Message
Send Template Message
Send Location Message
Send List Message
Send File From Local (Image, Video, Audio, Document)
Resend Message by ID
Upload File
Schedule Message
Cancel Schedule by ID
Delete Schedule by ID
Cancel Pending Message by ID
Cancel All Pending Message
Revoke Message
Report Send Message
Add Contact
Block Contact
Unblock Contact

Peringatan

Aplikasi ini gratis dan open source dan boleh digunakan siapa saja tanpa dikenai biaya apapun.
Hal yang tidak boleh dilakukan adalah memperjualbelikan/mengambil keuntungan dari aplikasi ini dalam bentuk apapun tanpa seijin pembuat software (PT. Manunggal Teknologi Indonesia).
Bagi yang dengan sengaja memperjualbelikan/mengambil keuntungan dari aplikasi ini, kami sumpahi sial dan melarat 1.000.000 turunan.
Karena kami tidak rela karya kami dibajak tanpa ijin.

Tahapan Instalasi

composer require silvanix/wablas

Enviroment

# Tambahkan di file .env 
# Token bisa didapatkan di wablass.com pada menu device - setting
WABLAS_TOKEN=

# tentukan dimana akun anda terdaftar diwablas.com. saat ini server yang ada di wablas adalah: solo, pati, kudus, jogja, texas dan eu.
WABLAS_SERVER=

Device

info();
restart();
disconnect();
set_webhook($url);
set_tracking($url);
incoming($status);

Example :

      use Silvanix/Wablas/Device;

      $device = new Device();

      $info = $device->info();
      $restart = $device->restart();
      $disconnect = $device->disconnect();
      
      $url = 'https://www.mywebhook.com/webhook';
      $set = $device->set_webhook($url);
      
      $incoming = $device->incoming('active');
      //for now anything than 'active' = incoming message disable

Check

use this to check Whatsapp Number is active or not

phone($phones);
- you can use multiple phone separated by comma(,)
  
  Example :

      use Silvanix/Wablas/Check;

      $check = new Check();

      $phones ='08121211111,089888888,07812121212';
      $check_phone = $check->phone($phones);

Message

Single Message
- single_text($phone,$message);
- single_image($phone,$image_url,$caption);
- single_audio($phone,$audio_url);
- single_video($phone,$video_url,$caption);
- single_document($phone,$document_url);
- footer_message($phone,$message,$footer,$header);
- otp($phone,$code);
- custom_otp($payload);
  - $caption is optional
  - you can use multiple phone separated by comma(,)
  - header is optional
  Example :

     use Silvanix/Wablas/Message;

     $send = new Message();

     $phones ='08121211111,089888888,07812121212';
     $message = 'hello';
     $image = 'https://i.imgur.com/OB0y6MR.jpg';

     $send_text = $send->single_text($phones,$message);
     $send_image =  $send->single_image($phones,$image,$message);
     
     
     ///send OTP Message

     $code = '12213';
     $phone = '081212121221';
     
     $send_otp = $send->otp($phone,$code);
     
     $header = 'Verification Code';
     $content = "Your verifiction code : $code";
     $footer = "supported by Wablas"; // footer is optional
     
     $send_custom_otp = $send->custom_otp($phone,$code,$header,$content,$footer);

Example OTP Message

Resend Message , Cancel & Revoke
- again($id);
  
  resend canceled message
- cancel($id);
  
  cancel pending message by ID
- cancel_all();
  
  cancel all pending messages
- revoke($id);
  
  cancel pending message by ID
  - you can use multiple phone separated by comma(,)
  Example :

      use Silvanix/Wablas/Message;

      $send = new Message();

      $message_id ='sakdj798-lkasjndl-k8792173kjas';
      
      $resend = $send->again($message_id);
      $cancel = $send->cancel($message_id);
      $cancel_all = $send->cancel_all();
      $revoke = $send->revoke($message_id);

. Send Multiple Message

multiple_text($payload);

      use Silvanix/Wablas/Message;

      $send = new Message();

      $payload = [
        [
            'phone' => '6281229889541',
            'message' => 'Test Pesan 1',
        ],
        [
            'phone' => '6281229889541',
            'message' => 'Hello {name} Pesan with spintax',
            'spintax' => true,
            'source' => 'for personal'
        ],
        [
            'phone' => '6285867765107',
            'message' => 'Hello Pesan 3',
            'secret' => true,
        ],
        [
            'phone' => '6287817274185-1632192971',
            'message' => 'Test Group',
            'isGroup' => true,
            'source' => 'group personal'
        ],
     ];
    $send_text = $send->multiple_text($payload);

multiple_image($payload);

      $payload = [
           [
               'phone' => '6281229889541',
               'image' => 'https://cdn-asset.jawapos.com/wp-content/uploads/2019/01/keluarga-pawang-di-jepang-maafkan-macan-putih-yang-membunuhnya_m_.jpg',
               'caption' => 'caption here',
           ],
           [
               'phone' => '6287817274185-1632192971',
               'image' => 'https://farm4.staticflickr.com/3075/3168662394_7d7103de7d_z_d.jpg',
               'caption' => 'Image to group',
               'isGroup' => true,
           ],
       ];

multiple_audio($payload);

         $payload = [
             [
                 'phone' => '6281229889541',
                 'audio' => 'https://prof3ssorst3v3.github.io/media-sample-files/jimmy-coffee.mp3',
                 'caption' => 'caption here',
             ],
             [
                 'phone' => '6287817274185-1632192971',
                 'audio' => 'https://prof3ssorst3v3.github.io/media-sample-files/jimmy-coffee.mp3',
                 'isGroup' => true,
             ],
         ];

multiple_video($payload);

       $payload = [
           [
               'phone' => '6281229889541',
               'video' => 'https://prof3ssorst3v3.github.io/media-sample-files/lion-sample.mp4',
               'caption' => 'this caption optional',
           ],
           [
               'phone' => '6287817274185-1632192971',
               'video' => 'https://prof3ssorst3v3.github.io/media-sample-files/lion-sample.mp4',
                'caption' => 'Image to group',
               'isGroup' => true,
           ],
       ];

multiple_document($payload);

        $payload = [
            [
                'phone' => '6281229889541',
                'document' => 'https://africau.edu/images/default/sample.pdf',
            ],
            [
                'phone' => '6287817274185-1632192971',
                'document' => 'https://africau.edu/images/default/sample.pdf',
                'isGroup' => true,
            ],
      ];

template_message($payload);

      $payload = [
         [
            'phone' => '6285867765107',
             'message'=> [
                 'title' => [
                     'type' => 'text',
                     'content' => 'template text',
                 ],
                 'buttons' => [
                     'url' => [
                         'display' => 'wablas.com',
                         'link' => 'https://wablas.com',
                     ],
                     'call' => [
                         'display' => 'contact us',
                         'phone' => '081223644xxx',
                     ],
                     'quickReply' => ["reply 1","reply 2"],
                 ],
                 'content' => 'sending template message...',
                 'footer' => 'footer template here',
             ]
         ]
     ];

list_message($payload);

      $payload = [
         [
             'phone' => '6285867765107',
             'message'=> [
                 'title' => 'Title Here',
                 'description' => 'This is template message',
                 'buttonText' => 'Opsi',
                 'lists' => [
                     [
                         'title' => 'List 1',
                         'description' => 'This is list 1',
                     ],
                     [
                         'title' => 'List 2',
                         'description' => 'This is list 2',
                     ],
                 ],
                 'footer' => 'Footer message here.',
             ],
         ]
     ];
   
 ```
          
- location_message($payload);
 
```PHP
     $payload = [
         [
             'phone' => '6285867765107',
             'message' => [
                 'name' => 'place name',
                 'address' => 'street name',
                 'latitude' => 24.121231,
                 'longitude' => 55.1121221,
             ],
         ]
     ];

button_message($payload);

      $payload = [
          [
              'phone' => '6285867765107',
              'message' => [
                  'buttons' => ["Reply 1","Reply 2","Reply 3"],
                  'content' => 'This is example button message',
                  'footer' => 'this is footer message',
              ],
          ]
      ];

File Upload

local_upload($file);

Example :

Controller

    use Silvanix\Wablas\File;
    public function store(Request $request)
    {
        $file = $request->file('file');
        $upload = new File();
        $url = $upload->local_upload($file);
        echo $url;
    }

Route

  ...
    Route::post('.../store', [App\Http\Controllers\SomeController::class, 'store'])->name('store');

View

      <form class="needs-validation" novalidate method="post" action="{{ route('store') }}" enctype="multipart/form-data" >
       @csrf
          <input type="file" name="file">
          <button type="submit"> Submit</button>
      </form>

Schedule Message

new_message($payload);

Example :

use Silvanix\Wablas\Schedule;
   
  $payload = [
      [
          'category' => 'text',
          'phone' => '6285867765107',
          'scheduled_at' => '2022-09-22 09:46:30',
          'text' => 'Hallo kakak',
      ]
  ];
  
  $shedule = new Schedule();
  $create = $schedule->new_message($payload);

Multiple Category

 $payload = [
         [
             'category' => 'image',
             'phone' => '62812185122343',
             'scheduled_at' => '2022-05-20 13:20:00',
             'text' => 'Cover Novel',
             'url' => ' https://solo.wablas.com/image/20220315081917.jpeg',
         ],
         [
             'category' => 'template',
             'phone' => '6281218567323',
             'scheduled_at' => '2022-05-20 13:20:00',
             'text' => [
                 'title' => [
                     'type' => 'image',
                     'content' => 'https://farm4.staticflickr.com/3075/3168662394_7d7103de7d_z_d.jpg',
                 ],
                 'buttons' => [
                     'url' => [
                         'display' => 'wablas.com',
                         'link' => 'https://wablas.com',
                     ],
                     'call' => [
                         'display' => 'contact us',
                         'link' => '081223644660',
                     ],
                     'quickReply' => ["reply 1","reply 2"],
                 ],
                 'content' => 'sending template message...',
                 'footer' => 'footer template here',
             ],
         ],
         [
             'category' => 'button',
             'phone' => '62812112121212',
             'scheduled_at' => '2022-05-20 13:20:00',
             'text' => [
                 'buttons' => ["button 1","button 2","button 3"],
                 'content' => 'sending template message...',
                 'footer' => 'footer template here',
             ],
         ],
     ];

cancel($id);

delete($id);

Example :

 use Silvanix\Wablas\Schedule;
 
 $shedule = new Schedule();
 
 $id = 'kajbdiuwe-8723yjhasbds-asdknasd8y';
 $cancel = $schedule->cancel($id);
 $delete = $schedule->delete($id);

Send Local File (Image, Audio, Video, Document)

local_file($file,$phones,$caption);

There is No Caption For Audio & Document message

Example :

Controller

  use Silvanix\Wablas\Message;

  public function store(Request $request)
  {
      $phones = $request->phones;
      $caption = $request->caption;
      $file = $request->file('file');
      $send = new Message();
      $test = $send->local_file($file,$phones,$caption);
      echo $test;
  }

Route

...
Route::post('.../store', [App\Http\Controllers\SomeController::class, 'store'])->name('store');

View

  <form class="needs-validation" novalidate method="post" action="{{ route('store') }}" enctype="multipart/form-data" >
    @csrf
        <input type="text" placeholder="081393961320,0821212122,08128282812"name='phones'>
        <input type="text" name="caption">
        <input type="file" name="file">
        <button type="submit"> Submit</button>
    </form>

Report

real_time($data);

Get Report API Send Messages Today, $data is nullable.

Example :

use Silvanix\Wablas\Report;

$report = new Report();
$get_report = $report->real_time();
echo $get_report;

$data = [
  'message_id' => '71236812736812,8127368721', //Multiple Id separated by ID
  'page' => '2' // number page, data show per page is 10
];

$get_report = $report->real_time($data);
echo $get_report;

Contact

create($data);

Add Contact to Wablas Contact.

Example :

use Silvanix\Wablas\Contact;

 $data =
  [
      [
          'name' => 'Danu',
          'phone' => '6285867765222'
      ],
      [
          'name' => 'Karina Setya',
          'phone' => '6285867765777',
          'email' => 'karina.setya@gmail.com',
          'birth_day' => '1992-03-12',
          'address' => 'Kedokan RT 02/ RW 04 Klego Boyolali',
      ],
      [
          'name' => 'Danu',
          'phone' => '6285867765222'
      ]
  ];
  
$contact = new Contact();
$response = $contact->create($data);

echo $response;

block($phone)

Block Contact From Receiving Broadcast from Device & Wablas will not save inbox from this number.

Example :

use Silvanix\Wablas\Contact;

$phone ='081393971212';
$contact = new Contact();
$response = $contact->block($phone);

echo $response;

unblock($phone)

Unblock Contact.

Example :

use Silvanix\Wablas\Contact;

$phone ='081393971212';
$contact = new Contact();
$response = $contact->unblock($phone);

echo $response;

License

Aladdin Free Public License

Donation

If this project help you reduce time to develop, you can give me a cup of coffee :)

silvanix / wablas

Maintainers

Details

README

Fitur

Peringatan

Tahapan Instalasi

Device

Check

Message

License

Donation