tocaan/gowasl-package

此软件包的最新版本(dev-main)没有提供许可信息。

一个简单的 Laravel 软件包,用于连接 WhatsApp 并发送消息

dev-main 2024-08-12 00:43 UTC

This package is auto-updated.

Last update: 2024-09-12 00:49:41 UTC


README

一个简单的 Laravel 软件包,用于连接 WhatsApp 并发送消息。

安装

composer require tocaan/gowasl-package

更新 composer 后,将 ServiceProvider 添加到 config/app.php 文件中的 providers 数组。

WAIntegration\WAServiceProvider::class, 

可选地,您可以使用 Facade 以缩短代码。将其添加到您的 facades 中

'Instance' => WAIntegration\Facades\InstanceFacade::class, 
'Message' => WAIntegration\Facades\MessageFacade::class, 

更多功能即将推出。

最后,您可以发布配置文件

 php artisan vendor:publish --provider="WAIntegration\WAServiceProvider"  

配置

对此配置文件(config/wa_integration.php)的主要更改将填充您的渠道凭证。

例如,当通过 composer 加载时,该行应如下所示

 'id'                    => env('WA_CHANNEL_ID','YOUR_CHANNEL_ID_HERE'),
 'token'                 => env('WA_CHANNEL_TOKEN','YOUR_CHANNEL_TOKEN_HERE'),
 'identifier'            => env('WA_CHANNEL_IDENTIFIER','YOUR_CHANNEL_OWNER_IDENTIFIER_HERE'), 

用法

您可以为消息或实例创建一个新的实例,并开始发送消息或获取 qr & 账户活动状态。

使用 facade

- 实例 Facade

   Instace::qr()

获取当前 qr

   Instance::status() 

检查账户状态是否为活动状态或断开连接

   Instance::disconnect() 

断开渠道连接

   Instance::clearInstance() 

删除渠道,使用时请小心

   Instance::clearInstanceData() 

清除与渠道关联的所有文件

- 消息 Facade

  • 通过 WhatsApp 发送文本消息
   Message::send([
      'phone' => '965xxxxxxxx',
      'body'  => 'Your Message Body Here'
   ]) 
  • 通过 WhatsApp 发送多媒体消息
  • 图片
   Message::sendImage([
      'phone' => '965xxxxxxxx',
      'url'  => 'url of your image',
      'caption' => 'image caption (optional)'
   ]) 
  • 视频
   Message::sendVideo([
      'phone' => '965xxxxxxxx',
      'url'  => 'url of your video',
      'caption' => 'image caption (optional)'
   ]) 
  • 音频
   Message::sendAudio([
      'phone' => '965xxxxxxxx',
      'url'  => 'url of your audio file',
   ]) 
  • 文档
   Message::sendFile([
      'phone' => '965xxxxxxxx',
      'url'  => 'url of your document file',
   ]) 
  • 链接
   Message::sendLink([
      'phone' => '965xxxxxxxx',
      'url'  => 'HTTPS URL',
      'title' => 'URL Title',
      'body' => 'URL Description',
   ]) 
  • 贴纸
   Message::sendSticker([
      'phone' => '965xxxxxxxx',
      'url'  => 'url of your Sticker',
   ]) 
  • 动图
   Message::sendGif([
      'phone' => '965xxxxxxxx',
      'url'  => 'url of your Gif',
      'caption' => 'Gif caption (optional)'
   ]) 
  • 位置
   Message::sendLocation([
      'phone' => '965xxxxxxxx',
      'lat'  => 'location latitude',
      'lng' => 'location longitude'
   ]) 
  • 联系人
   Message::sendContact([
      'phone' => '965xxxxxxxx',
      'name'  => 'Contact Name',
      'contact' => 'Contact Whatsapp Number',
      'organization' => 'Contact Organization (optional)',
   ]) 
  • 提及
   Message::sendMention([
      'phone' => '965xxxxxxxx',
      'mention' => 'Mention Whatsapp Number',
   ]) 

注意:您的连接状态必须是连接状态,这意味着您已经扫描了 QR。