# DingComBot

**Repository Path**: mengxingadmin/DingComBot

## Basic Information

- **Project Name**: DingComBot
- **Description**: 钉钉企业webhook机器人
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2020-04-03
- **Last Updated**: 2022-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 钉钉企业内部webhook机器人扩展

## 安装

> 需要使用curl

在composer.json里面添加

```php
"require": {
		"phalapi/ding-com-bot":"dev-master",
    },
```

控制台执行 `composer update`

## 配置

```php
//./path/to/app.php
return array(
	//    钉钉企业内部webhook机器人 
    // @link https://ding-doc.dingtalk.com/doc#/serverapi2/elzz1p
    'DingBot' => array(
		'AppSecret'=>'<your AppSecret>', 
        'webHook'=>'<your dingbot webHook>' 
    ),
);
```

## 注册

```php
//./path/to/di.php
//钉钉机器人
$di->ddBot = new PhalApi\DingBot\Lite($di->config->get('app.DingBot'));
```

## 接收消息

### 测试

```php
<?php
//path/to/public

require_once dirname(__FILE__) . '/init.php';

$server = new PhalApi\DingComBot\Lite($di->config->get('app.DingBot'));
//默认使用内置的消息处理 \PhalApi\DingComBot\Server
$server->Server();
```

上述操作完成后，正常状态下@机器人发消息 将会受到回复。

### 实现自身业务

添加自定义类

```php
<?php
/**
 * Created by PhpStorm.
 * User: Chen Kaihang <cmxds@hotmail.com>
 * Date: 2020/4/3
 * Time: 19:48
 */

namespace App\DingBot;


use PhalApi\DingComBot\Server;

/**
 * Class DingBotServer
 * @package App\DingBot
 *继承PhalApi\DingComBot\Server 重写其中的方法即可
 */
class DingBotServer extends Server
{

    public function text($msg)
    {
        // do something
    }
}
```

注册自身业务

```php
<?php
//path/to/public

require_once dirname(__FILE__) . '/init.php';

$server = new PhalApi\DingComBot\Lite($di->config->get('app.DingBot'));
//默认使用内置的消息处理 \PhalApi\DingComBot\Server
$server->Server('\\App\\DingBot\\DingBotServer');
```



## 发送消息

> Text类型消息

```php
\PhalApi\DI()->ddBot->Text('测试');
```

> Link类型消息

```php
\PhalApi\DI()->ddBot->Link('链接','标题','https://www.dingtalk.com');
```

> Markdown类型消息

```php
\PhalApi\DI()->ddBot->Markdown('天气',"#### 杭州天气 @156xxxx8827\n");
```

> ActionCard类型消息，整体跳转ActionCard

```php
\PhalApi\DI()->ddBot
    ->ActionCard('标题','内容','点击标题','https://www.dingtalk.com');
```

> ActionDialog类型消息，独立跳转ActionCard

```php
\PhalApi\DI()->ddBot->ActionDialog('标题','内容',array(
    array('title'=>'标题1','actionURL'=>'https://www.dingtalk.com/'),
    array('title'=>'标题2','actionURL'=>'https://www.dingtalk.com/')
)));
```

> FeedCard类型消息

```php
\PhalApi\DI()->ddBot->FeedCard(array(
    array('title'=>'标题1',
        'messageURL'=>'https://www.dingtalk.com/',
          'picURL'=>'https://www.dingtalk.com/'),
    array('title'=>'标题2',
         'messageURL'=>'https://www.dingtalk.com/',
          'picURL'=>'https://www.dingtalk.com/')
)));
```

更多详细内容参考钉钉官方文档：https://ding-doc.dingtalk.com/doc#/serverapi2/krgddi