Tutoriel de développement d'interface PHP : Implémentation de la fonction de contact externe de l'entreprise WeChat

Tutoriel de développement d'interface PHP : Implémentation de la fonction de contact externe d'Enterprise WeChat

Introduction :
Avec la popularité et le développement rapides d'Enterprise WeChat (WeCom), de plus en plus d'entreprises ont commencé à utiliser Enterprise WeChat pour établir des relations avec des partenaires externes. contacts Canaux de communication pour mieux gérer les clients, fournisseurs et partenaires. Cet article explique comment utiliser l'interface de développement PHP pour implémenter la fonction de contact externe d'Enterprise WeChat, y compris des fonctions telles que la création de contacts externes, l'obtention de listes de contacts externes et l'envoi de messages de contacts externes.

1. Préparation de l'environnement :
Pour développer la fonction de contact externe d'Enterprise WeChat, vous devez d'abord assurer la préparation de l'environnement suivante :

1. Autorisations de l'application Enterprise WeChat : En arrière-plan d'Enterprise WeChat, créez une application auto-construite et obtenez l’ID et le secret des autorisations de l’application pour les appels d’interface ultérieurs.
2. Environnement PHP : assurez-vous que l'interpréteur PHP est installé sur votre serveur et que le module cURL est activé.
3. Outils de développement : vous pouvez choisir n'importe quel éditeur de texte, tel que Sublime Text, PHPStorm, etc.

2. Obtenir access_token :
Avant de passer un appel d'interface, nous devons obtenir un access_token comme identifiant pour l'appel d'interface. Le access_token a une certaine période de validité et doit être obtenu à nouveau après expiration.

Adresse de l'interface :
https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
(Remarque : remplacez ID et SECRET par l'ID et le secret de l'application d'entreprise WeChat auto-construite )

L'interface renvoie :
{

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

}

Enregistrez le access_token localement pour les appels d'interface ultérieurs.

3. Créer des contacts externes :
Nous pouvons maintenant commencer à mettre en œuvre la fonction de création de contacts externes. Voici un exemple d'appel d'interface pour créer un contact externe :

Adresse de l'interface :
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add?access_token=ACCESS_TOKEN

Paramètres de l'interface :

Utilisation des paramètres d'interface Passé au format JSON, l'exemple est le suivant :
{

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

}

L'interface renvoie :
{

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

}

Dans l'exemple ci-dessus, nous avons transmis les coordonnées du contact externe, dont le ID du contact externe, nom, surnom, sexe, poste, nom de l'entreprise et coordonnées, etc. Dans le même temps, nous pouvons également désigner du personnel de suivi pour permettre aux utilisateurs WeChat concernés de l'entreprise de prêter attention aux contacts externes.

4. Obtenez la liste de contacts externes :
Ensuite, implémentons la fonction d'obtention de la liste de contacts externes. Voici un exemple d'appel d'interface pour obtenir une liste de contacts externes :

Adresse d'interface :
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list?access_token=ACCESS_TOKEN

Paramètres d'interface :
{

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

}

L'interface renvoie :
{

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

}

Dans l'exemple ci-dessus, nous avons transmis les paramètres pour obtenir la liste de contacts externes, y compris l'ID utilisateur, le curseur et la limite de quantité pour chaque retour, etc. Dans le retour de l'interface, nous pouvons obtenir les informations de la liste des contacts externes, y compris l'identifiant du contact externe, son nom, son poste, le nom de l'entreprise, son type et le personnel de suivi. Si le nombre total de listes dépasse la limite de nombre renvoyée à chaque fois, vous pouvez utiliser next_cursor pour l'acquisition de pagination.

5. Envoi de messages à des contacts externes :
Enfin, implémentons la fonction d'envoi de messages à des contacts externes. Voici un exemple d'appel d'interface pour envoyer un message de contact externe :

Adresse de l'interface :
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/message/send?access_token=ACCESS_TOKEN

Interface paramètres :
{

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

}

L'interface renvoie :
{

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

}

Dans l'exemple ci-dessus, nous avons transmis les paramètres d'envoi du message, y compris l'ID utilisateur et le type de message qui a reçu le message, ici nous utilisé le type de message texte. Dans le type de message texte, nous pouvons transmettre le contenu du texte à envoyer.

Conclusion : 
Grâce à ce didacticiel, nous avons appris à utiliser PHP pour développer des interfaces permettant d'implémenter les fonctions de contact externe d'Enterprise WeChat, notamment la création de contacts externes, l'obtention de listes de contacts externes et l'envoi de messages de contacts externes. J'espère que ce didacticiel pourra vous être utile et vous êtes invités à essayer de le développer dans des applications pratiques. Merci d'avoir lu!

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!