README

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

功能

• 设备信息
• 重启设备
• 断开设备
• 检查手机
• 发送短信
• 发送媒体消息（图片、视频、音频、文档）
• 发送按钮消息
• 发送页脚消息
• 发送模板消息
• 发送位置消息
• 发送列表消息
• 从本地发送文件（图片、视频、音频、文档）
• 根据ID重新发送消息
• 上传文件
• 计划消息
• 根据ID取消计划
• 根据ID删除计划
• 根据ID取消挂起消息
• 取消所有挂起消息
• 撤回消息
• 报告发送消息
• 添加联系人
• 阻止联系人
• 解除阻止联系人

警告

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.

安装步骤

composer require silvanix/wablas

环境

# 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=

设备

1. info();

2. restart();

3. disconnect();

4. set_webhook($url);

5. set_tracking($url);

6. incoming($status);

示例

      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

检查

使用此功能检查WhatsApp号码是否活跃

1. phone($phones);

   • 您可以使用逗号（,）分隔多个电话号码

     示例

      use Silvanix/Wablas/Check;

      $check = new Check();

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

消息

1. 单条消息

   • 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是可选的
     • 您可以使用逗号（,）分隔多个电话号码
     • header是可选的

     示例

     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);

示例OTP消息

1. 重新发送消息，取消和撤回

   • again($id);

     重新发送已取消的消息

   • cancel($id);

     根据ID取消挂起消息

   • cancel_all();

     取消所有挂起消息

   • revoke($id);

     根据ID取消挂起消息

     • 您可以使用逗号（,）分隔多个电话号码

     示例

      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);

发送多条消息

• 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',
              ],
          ]
      ];
      

1. 文件上传

   • local_upload($file);

   示例

   • 控制器

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

   • 路由

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

• 视图

      <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>
    

1. 计划消息

   • new_message($payload);

     示例

     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);

   • 多个类别

      $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);

     示例

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

2. 发送本地文件（图片、音频、视频、文档）

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

     音频和文档消息没有标题

   示例

   • 控制器

       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::post('.../store', [App\Http\Controllers\SomeController::class, 'store'])->name('store');

   • 视图

       <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>

3. 报告

   • real_time($data);

     获取报告API发送今天的消息，$data是可选的。

     示例

     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;

4. 联系人

   • create($data);

     将联系人添加到Wablas联系人。

     示例

     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)

     阻止联系人接收来自设备的通知，Wablas不会保存此号码的收件箱。

     示例

     use Silvanix\Wablas\Contact;
     
     $phone ='081393971212';
     $contact = new Contact();
     $response = $contact->block($phone);
     
     echo $response;

   • unblock($phone)

     解除阻止联系人

     示例

     use Silvanix\Wablas\Contact;
     
     $phone ='081393971212';
     $contact = new Contact();
     $response = $contact->unblock($phone);
     
     echo $response;

许可

Aladdin Free Public License

捐赠

如果这个项目帮助您节省开发时间，您可以给我一杯咖啡：）