Tutorial pembangunan antara muka PHP: Melaksanakan fungsi hubungan luaran WeChat perusahaan

Tutorial Pembangunan Antara Muka PHP: Melaksanakan Fungsi Hubungan Luaran Enterprise WeChat

Pengenalan:
Dengan populariti dan perkembangan pesat Enterprise WeChat (WeCom), semakin banyak perusahaan telah mula menggunakan Enterprise WeChat untuk membina hubungan dengan pihak luar menghubungi Saluran komunikasi untuk mengurus pelanggan, pembekal dan rakan kongsi dengan lebih baik. Artikel ini akan memperkenalkan cara menggunakan antara muka pembangunan PHP untuk melaksanakan fungsi hubungan luaran Enterprise WeChat, termasuk fungsi seperti mencipta kenalan luaran, mendapatkan senarai kenalan luaran dan menghantar mesej kenalan luaran.

1. Persediaan persekitaran:
Untuk membangunkan fungsi hubungan luaran Enterprise WeChat, anda perlu memastikan penyediaan persekitaran berikut:

1. Kebenaran untuk aplikasi WeChat Enterprise: Dalam latar belakang Enterprise WeChat, cipta aplikasi yang dibina sendiri dan dapatkan ID kebenaran aplikasi dan Rahsia untuk panggilan antara muka berikutnya.
2. Persekitaran PHP: Pastikan pelayan anda telah memasang penterjemah PHP dan modul cURL didayakan.
3. Alat pembangunan: Anda boleh memilih mana-mana editor teks, seperti Teks Sublime, PHPStorm, dsb.

2. Dapatkan access_token:
Sebelum membuat panggilan antara muka, kita perlu mendapatkan access_token sebagai bukti kelayakan untuk panggilan antara muka. Access_token mempunyai tempoh sah tertentu dan perlu diperoleh semula selepas tamat tempoh.

Alamat antara muka:
https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
(Nota: Gantikan ID dan RAHSIA dengan ID dan Rahsia aplikasi binaan sendiri WeChat perusahaan )

Pengembalian antara muka:
{

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

}

Simpan access_token secara setempat untuk panggilan antara muka yang berikutnya.

3. Cipta kenalan luaran:
Kini kita boleh mula melaksanakan fungsi mencipta kenalan luaran. Berikut ialah contoh panggilan antara muka untuk membuat kenalan luaran:

Alamat antara muka:
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add?access_token=ACCESS_TOKEN

Parameter antara muka:

Penggunaan parameter antara muka Lulus dalam format JSON, contohnya adalah seperti berikut:
{

"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"]

}

Antara muka kembali:
{

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

}

Dalam contoh di atas, kami menyerahkan butiran kenalan luar, termasuk ID hubungan luar, nama, Nama Panggilan, jantina, jawatan, nama syarikat dan maklumat hubungan, dsb. Pada masa yang sama, kami juga boleh menetapkan kakitangan susulan untuk membenarkan pengguna WeChat perusahaan yang berkaitan memberi perhatian kepada hubungan luar.

4. Dapatkan senarai kenalan luaran:
Seterusnya, mari laksanakan fungsi mendapatkan senarai kenalan luaran. Berikut ialah contoh panggilan antara muka untuk mendapatkan senarai kenalan luaran:

Alamat antara muka:
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list?access_token=ACCESS_TOKEN

Parameter antara muka:
{

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

}

Antara muka kembali:
{

"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"

}

Dalam contoh di atas, kami melepasi parameter untuk mendapatkan senarai kenalan luaran, termasuk ID pengguna, kursor dan had kuantiti untuk setiap pulangan, dsb. Dalam pemulangan antara muka, kami boleh mendapatkan maklumat senarai kenalan luar, termasuk ID kenalan luar, nama, jawatan, nama syarikat, jenis dan kakitangan susulan. Jika jumlah bilangan senarai melebihi had nombor yang dikembalikan setiap kali, anda boleh menggunakan next_cursor untuk pemerolehan paging.

5. Menghantar mesej kepada kenalan luar:
Akhir sekali, mari laksanakan fungsi menghantar mesej kepada kenalan luar. Berikut ialah contoh panggilan antara muka untuk menghantar mesej kenalan luaran:

Alamat antara muka:
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/message/send?access_token=ACCESS_TOKEN

Antaramuka parameter:
{

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

}

Antara muka kembali:
{

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

}

Dalam contoh di atas, kami lulus parameter untuk menghantar mesej, termasuk ID pengguna dan jenis mesej yang menerima mesej, di sini kami menggunakan jenis mesej teks. Dalam jenis mesej teks kita boleh menghantar kandungan teks yang akan dihantar.

Kesimpulan:
Melalui tutorial ini, kami mempelajari cara menggunakan PHP untuk membangunkan antara muka untuk melaksanakan fungsi hubungan luaran Enterprise WeChat, termasuk mencipta kenalan luaran, mendapatkan senarai kenalan luaran dan menghantar mesej kenalan luaran. Saya harap tutorial ini boleh membantu anda, dan anda dialu-alukan untuk mencuba dan mengembangkannya dalam aplikasi praktikal. Terima kasih kerana membaca!

Atas ialah kandungan terperinci Tutorial pembangunan antara muka PHP: Melaksanakan fungsi hubungan luaran WeChat perusahaan. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!