agp/pacote-alobot

消息发送包。

1.0.5 2021-03-10 23:53 UTC

This package is not auto-updated.

Last update: 2024-09-20 19:03:43 UTC


README


License


关于Alobot

本包旨在简化AGAPE模块的消息发送过程。

使用本包,您可以发送文本、图片和文件到WhatsApp和Telegram社交网络。

导入包后需要做什么

导入alobot包后,需要执行publish命令以将配置文件导入到项目中。

php artisan vendor:publish --provider="Agp\Alobot\AgpAlobotServiceProvider" --tag=config

第二步是设置在导入的配置文件中使用的变量,并将它们放入.env文件中。

ALOBOT_API= value
ALOBOT_ID_INTEGRACAO= value
ALOBOT_TOKEN= value

现在,请按照说明使用它!

如何使用包

首先,您需要创建一个Alobot实例。

然后,使用Alobot实例的send方法,传入AlobotMensagemTexto类以发送文本,或AlobotMensagemDocumento类以发送文件或图片。

    $alobot = new Alobot();
    
    /**
    * @param string $numero
    * @param string $texto
    * @param UploadedFile|base64 $file
    */
    $alobot->send([
        new AlobotMensagemTexto($numero, $texto),
        new AlobotMensagemDocumento(AlobotMensagemDocumento::TP_ARQUIVO, $numero, $file),
        new AlobotMensagemDocumento(AlobotMensagemDocumento::TP_IMAGEM, $numero, $file)
    ]);

Alobot

实例化这个类时,构造函数会设置用于请求的token和集成标识符。这些信息应在.env文件中提供,并且alobot.php配置文件应添加到项目中,内容应与alobot包中的文件相同。

     $alobot = new Alobot();

AlobotMensagemTexto

本类请求的参数仅为消息文本和接收短信的电话号码。

    /**
    * @param string $numero
    * @param string $texto
    */
    $alobot->send([
        new AlobotMensagemTexto($numero, $texto)
    ]);

AlobotMensagemDocumento

本类请求的参数包括文档类型、电话号码和要发送的文件。

注意:$file接受的格式仅为UploadedFile对象或base64编码的字符串。

    /**
    * @param string $numero
    * @param UploadedFile|base64 $file
    */
    $alobot->send([
        new AlobotMensagemDocumento(AlobotMensagemDocumento::TP_ARQUIVO, $numero, $file),
        new AlobotMensagemDocumento(AlobotMensagemDocumento::TP_IMAGEM, $numero, $file)
    ])

如何创建集成

要创建集成,请访问https://alobot.com.br,使用与.env文件中提供的token相同的用户,创建一个号码,并将id作为变量$ALOBOT_ID_INTEGRACAO的值放入.env文件中。

//Exemplo fictício, não necessariamente o valor utilizado aqui será o seu.
ALOBOT_ID_INTEGRACAO= 1