Quick guide to connecting DingTalk interface with PHP

Quick Interconnection Guide between DingTalk Interface and PHP

DingTalk is an enterprise-level instant messaging tool that is widely used for internal communication and collaboration within the company. As developers, we can use the DingTalk interface to integrate with DingTalk to implement some automated functions, such as message push, attendance check-in, etc. This article will introduce how to use PHP to quickly connect to the DingTalk interface, and provide some code examples for reference.

1. Preparation

Before we start, we need to register a developer account on the DingTalk open platform and create a self-built application. In the process of creating an application, we need to obtain the following important parameters: corpid (enterprise ID), appkey, appsecret (application credential password) key) and agent_id (the agent ID of the self-built application). These parameters will be used in subsequent interface calls.

2. Obtain Access Token

Before calling the DingTalk interface, we need to obtain the Access Token for identity authentication. The method of obtaining Access Token is as follows:

<?php
function getAccessToken($corpid, $appkey, $appsecret) {
    $url = "https://oapi.dingtalk.com/gettoken?corpid={$corpid}&corpsecret={$appsecret}";
    $result = file_get_contents($url);
    $result = json_decode($result, true);
    return $result['access_token'];
}

// 使用示例
$accessToken = getAccessToken("your_corpid", "your_appkey", "your_appsecret");
echo $accessToken;
?>

3. Send message

1. Send text message

<?php
function sendTextMessage($accessToken, $agentId, $userIdList, $content) {
    $url = "https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token={$accessToken}";
    $data = array(
        "agent_id" => $agentId,
        "userid_list" => implode(',', $userIdList),
        "msg" => array(
            "msgtype" => "text",
            "text" => array(
                "content" => $content
            )
        )
    );
    $data = json_encode($data);
    $header = array(
        'Content-Type: application/json',
        'Content-Length: ' . strlen($data)
    );
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    
    $result = curl_exec($ch);
    curl_close($ch);
    
    return json_decode($result, true);
}

// 使用示例
$userIdList = array("user1", "user2", "user3");
$content = "这是一条测试消息";
$result = sendTextMessage($accessToken, $agentId, $userIdList, $content);
print_r($result);
?>

2. Send link message

<?php
function sendLinkMessage($accessToken, $agentId, $userIdList, $title, $content, $url, $image) {
    $url = "https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token={$accessToken}";
    $data = array(
        "agent_id" => $agentId,
        "userid_list" => implode(',', $userIdList),
        "msg" => array(
            "msgtype" => "link",
            "link" => array(
                "title" => $title,
                "text" => $content,
                "messageUrl" => $url,
                "picUrl" => $image
            )
        )
    );
    $data = json_encode($data);
    $header = array(
        'Content-Type: application/json',
        'Content-Length: ' . strlen($data)
    );
    
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
    curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
    
    $result = curl_exec($ch);
    curl_close($ch);
    
    return json_decode($result, true);
}

// 使用示例
$userIdList = array("user1", "user2", "user3");
$title = "这是一条链接消息";
$content = "这是链接消息的正文";
$url = "https://www.example.com";
$image = "https://www.example.com/image.jpg";
$result = sendLinkMessage($accessToken, $agentId, $userIdList, $title, $content, $url, $image);
print_r($result);
?>

4. Other functions

In addition to sending messages, the DingTalk interface also provides a wealth of other functions, such as obtaining user information, creating calendar events, obtaining department lists, etc. We can achieve these functions by calling the corresponding API. The usage method is similar to the above example, just call the corresponding interface URL and pass in the required parameters.

Summary

This article introduces how to use PHP to quickly connect to the DingTalk interface, and provides code examples for sending text messages and link messages for reference. By docking the DingTalk interface, we can integrate with DingTalk to implement some automated functions and improve work efficiency. Of course, the interface provided by DingTalk has many other functions that we can learn more about and try to use. I hope this article will be helpful to you in connecting the DingTalk interface with PHP.

The above is the detailed content of Quick guide to connecting DingTalk interface with PHP. For more information, please follow other related articles on the PHP Chinese website!