DingTalk インターフェースを PHP に接続するためのクイックガイド

DingTalk インターフェイスと PHP 間の相互接続クイック ガイド

DingTalk は、社内の内部コミュニケーションやコラボレーションに広く使用されているエンタープライズ レベルのインスタント メッセージング ツールです。開発者は、DingTalk インターフェイスを使用して DingTalk と統合し、メッセージ プッシュや出席チェックインなどの自動化機能を実装できます。この記事では、PHP を使用して DingTalk インターフェイスにすばやく接続する方法を紹介し、参考用のコード例をいくつか示します。

1. 準備

開始する前に、DingTalk オープン プラットフォームに開発者アカウントを登録し、自己構築アプリケーションを作成する必要があります。アプリケーションの作成プロセスでは、次の重要なパラメータを取得する必要があります: corpid (エンタープライズ ID)、appkey、appsecret (アプリケーション資格情報のパスワード) キー) および agent_id (自己構築アプリケーションのエージェント ID)。これらのパラメータは後続のインターフェイス呼び出しで使用されます。

2. アクセス トークンの取得

DingTalk インターフェイスを呼び出す前に、ID 認証用のアクセス トークンを取得する必要があります。アクセス トークンの取得方法は次のとおりです:

<?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. メッセージの送信

1. テキスト メッセージの送信

<?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. リンク メッセージの送信

<?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. その他の機能

DingTalk インターフェースは、メッセージの送信以外にも、ユーザー情報の取得、カレンダーイベントの作成、部門リストの取得、等これらの機能は、対応する API を呼び出すことで実現できます。使用方法は上記の例と似ており、対応するインターフェイス URL を呼び出して必要なパラメーターを渡すだけです。

概要

この記事では、PHP を使用して DingTalk インターフェイスにすばやく接続する方法を紹介し、テキスト メッセージとリンク メッセージを送信するためのコード例を参考として示します。 DingTalk インターフェイスをドッキングすることで、DingTalk と統合していくつかの自動化機能を実装し、作業効率を向上させることができます。もちろん、DingTalk が提供するインターフェイスには、さらに詳しく学んで使用してみることができる機能が他にもたくさんあります。この記事が、DingTalk インターフェイスと PHP を接続する際に役立つことを願っています。

以上がDingTalk インターフェースを PHP に接続するためのクイックガイドの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。