dmanetwork/slack

与Slack (slack.com) 交互的接口。这里的API尚未完全实现,目前只支持向频道发送消息。

v2.0.0 2016-02-26 01:59 UTC

This package is auto-updated.

Last update: 2024-09-05 17:55:29 UTC


README

用于通过Slack API向频道发送消息的Slack (slack.com) 小工具。

安装

使用Composer。

简单用法

在配置应用程序配置时尽早定义Slack选项。您必须指定的唯一选项是API访问令牌,您可以在登录到http://api.slack.com时生成此令牌。

Nether\Option::Set('slack-token','YOUR-SLACK-TOKEN');

创建一个客户端实例以与Slack API交互。

$slack = new DMA\Slack\Client;

然后您可以发送消息。

$slack->Send('Hello from our Slack enabled app.');

如果您不更改其他任何选项,您应该在您的#general频道中看到来自Optimus Prime的消息。

高级用法

在应用程序配置时间提供更多选项...

这些都是在应用程序配置时间可以设置的选项。

Nether\Option::Set([
	'slack-token' => 'YOUR-SLACK-TOKEN',
	'slack-default-channel' => '#channel',
	'slack-default-name' => 'bot name of choice',
	'slack-default-icon' => 'url to public accessable image for chat icon',
	'slack-channels' => [ 'action-name' => 'channel', ... ]
]);

在实例时间提供更多选项(覆盖前一个选项)...

这些是在创建实例时间可以设置的选项。

$slack = new DMA\Slack\Client([
	'DefaultChannel' => '#channel',
	'DefaultName' => 'bot name of choice',
	'DefaultIcon' => 'url to icon',
	'Token' => 'YOUR-SLACK-TOKEN'
]);

在发送消息时间提供更多选项...

在发送消息时间可以设置的选项。

$slack->Send('message here',[
	'Channel' => '#DifferentChannel',
	'Name' => 'Different Bot Name',
	'Icon' => 'url to different icon'
]);

如果您只想发送到默认频道或用户以外的其他频道。

$slack->SendToChannel($chan,$msg);

或者发送到由任何配置的操作指定的不同频道。

// send user-add action notifications to the team.
$slack->SendToChannel('--user-add',$msg);

发送我们没有包装的API请求...

$slack->SendRequest(string method, array args);

方法名称是Slack文档中指定的API URL的最后部分。然后,参数数组将是一个关联数组,其中的键是Slack中提到的参数名称,值是要发送的值。

版权

本软件版权所有(c)2014 Dream Machine Association, LLC。有关更多信息,请参阅捆绑的LICENSE文件(BSD-2-Clause)。