PHP インターフェース開発チュートリアル: エンタープライズ WeChat の外部連絡先機能の実装

PHP インターフェイス開発チュートリアル: Enterprise WeChat の外部連絡先機能の実装

はじめに:
Enterprise WeChat (WeCom) の急速な普及と発展に伴い、さらにWeChat Enterprise を使用して外部連絡先とのコミュニケーション チャネルを構築し、顧客、サプライヤー、パートナーをより適切に管理する企業が増えています。この記事では、PHP 開発インターフェイスを使用して、外部連絡先の作成、外部連絡先リストの取得、外部連絡先メッセージの送信などの機能を含む、Enterprise WeChat の外部連絡先機能を実装する方法を紹介します。

1. 環境の準備:
Enterprise WeChat の外部連絡先機能を開発するには、まず次の環境を準備する必要があります:

1. Enterprise WeChat アプリケーションの権限: Enterprise WeChat バックグラウンドで、自己構築アプリケーションを作成し、後続のインターフェイス呼び出し用のアプリケーション ID とシークレットを取得します。
2. PHP 環境: サーバーに PHP インタープリターがインストールされ、cURL モジュールが有効になっていることを確認してください。
3. 開発ツール: Sublime Text、PHPStorm などのテキスト エディターを選択できます。

2. access_token の取得:
インターフェイス呼び出しを行う前に、インターフェイス呼び出しの資格情報として access_token を取得する必要があります。 access_tokenには一定の有効期限があり、期限切れ後は再度取得する必要があります。

インターフェイス アドレス:
https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
(注: ID と SECRET を Enterprise WeChat ID と作成されたアプリケーションのシークレット)

インターフェイスは次を返します:
{

"errcode": 0,
"errmsg": "ok",
"access_token": "ACCESS_TOKEN",
"expires_in": 7200

}

後続のインターフェイス呼び出しのために access_token をローカルに保存します。

3. 外部連絡先の作成:
これで、外部連絡先を作成する機能の実装を開始できます。以下は、外部連絡先を作成するインターフェイス呼び出しの例です:

インターフェイス アドレス:
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add?access_token=ACCESS_TOKEN

インターフェイス パラメーター:

インターフェイス パラメーターは JSON 形式で渡されます。例は次のとおりです:
{

"external_contact": {
    "external_userid": "external_userid",
    "name": "contact_name",
    "nickname": "contact_nickname",
    "gender": 1,
    "position": "contact_position",
    "corp_name": "corporation_name",
    "type": 1
},
"follow_user": ["user_id_1", "user_id_2"]

}

インターフェイスの戻り値:
{

"errcode": 0,
"errmsg": "ok",
"external_contact": {
    "external_userid": "external_userid"
}

}

上記の例では、外部連絡先 ID、名前、ニックネーム、性別、役職、会社名、連絡先情報などを含む外部連絡先の詳細を渡しました。 。同時に、関連する企業 WeChat ユーザーが外部連絡先に注意を払うようにフォローアップ担当者を指定することもできます。

4. 外部連絡先リストの取得:
次に、外部連絡先リストを取得する機能を実装しましょう。以下は、外部連絡先リストを取得するためのインターフェイス呼び出しの例です。

インターフェイス アドレス:
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list?access_token= ACCESS_TOKEN

インターフェイス パラメーター:
{

"userid": "userid",
"cursor": "",
"limit": 100

}

インターフェイスの戻り値:
{

"errcode": 0,
"errmsg": "ok",
"external_contact_list": [
    {
        "external_userid": "external_userid_1",
        "name": "contact_name_1",
        "position": "contact_position_1",
        "corp_name": "corporation_name_1",
        "type": 1,
        "follow_user": ["user_id_1"]
    },
    {
        "external_userid": "external_userid_2",
        "name": "contact_name_2",
        "position": "contact_position_2",
        "corp_name": "corporation_name_2",
        "type": 2,
        "follow_user": ["user_id_2", "user_id_3"]
    }
],
"next_cursor": "next_cursor"

}

In上の例では、ユーザー ID、カーソル、毎回返される数の制限など、外部連絡先リストを取得するためのパラメーターを渡しました。インターフェースリターンでは、外部連絡先のID、名前、役職、会社名、種類、フォロー担当者などのリスト情報を取得できます。リストの総数が毎回返される数の制限を超える場合は、next_cursor を使用してページングを取得できます。

5. 外部連絡先にメッセージを送信する:
最後に、外部連絡先にメッセージを送信する機能を実装しましょう。以下は、外部連絡先メッセージを送信するためのインターフェイス呼び出しの例です。

インターフェイス アドレス:
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/message/send? access_token=ACCESS_TOKEN

インターフェイス パラメーター:
{

"touser": "user_id",
"msgtype": "text",
"text": {
    "content": "Hello, world!"
}

}

インターフェイスの戻り値:
{

"errcode": 0,
"errmsg": "ok"

}

上記の例では、メッセージを受信したユーザー ID やメッセージ タイプなど、メッセージを送信するためのパラメーターを渡しましたが、ここではテキスト メッセージ タイプを使用しました。テキスト メッセージ タイプでは、送信するテキスト コンテンツを渡すことができます。

結論:
このチュートリアルを通じて、PHP を使用して、外部連絡先の作成、外部連絡先リストの取得、外部連絡先メッセージの送信など、Enterprise WeChat の外部連絡先機能を実装するインターフェイスを開発する方法を学びました。などの機能。このチュートリアルがお役に立てば幸いです。実際のアプリケーションで試して拡張してみてください。読んでくれてありがとう！

以上がPHP インターフェース開発チュートリアル: エンタープライズ WeChat の外部連絡先機能の実装の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。