Coopération API
En utilisant l'API Chat&Messenger, vous pouvez facilement vous connecter à des systèmes et programmes externes.
L'intégration de l'API permet le traitement suivant.
- Se connecte au système interne et notifie les données de l'entreprise au salon de discussion
- Détecter les erreurs du système et informer les parties liées
- Lien vers des conférences Web à partir d'un logiciel de groupe interne
- Obtenez des informations sur les horaires et les réservations de salles de conférence et établissez des liens avec d'autres systèmes.
Jeton API et interface API
Obtention d'un jeton API depuis l'écran de gestion
Lors de l'intégration de l'API, obtenez d'abord un jeton API.
Veuillez transmettre l'apiToken/serverURL obtenu à JavaScript/curl comme décrit dans « Interface API » ci-dessous.
Interface API
La ligne de commande JavaScript/curl peut être utilisée comme interface API. Les deux exemples ci-dessous peuvent obtenir des informations d’inscription à une salle de conférence au format JSON.
Dans les environnements où SSL standard n'est pas appliqué, l'URL du serveur sera le port HTTP 8080.
Javascript
let config = {
"apiToken": "QIQVOSvRJHrQElDwj20x******",
"serverURL": "https://*****************"
}
let client = new CAMAPIClient(config);
let response = await client.getConferenceRooms();ligne de commande curl
curl -H "x-cam-apiToken:token******" ${serverURL}/getConferenceRoomsTout programme d'accès HTTP
Il peut également être lié à n’importe quel programme d’accès HTTP.
Exemple d'écran d'API
Il existe un exemple d'URL où vous pouvez facilement tester l'exécution de l'API. Si vous souhaitez l'utiliser pour des tests, veuillez nous contacter à partir du formulaire de demande.
API
* Il est prévu de s'étendre par étapes en commençant par les éléments à forte utilisation.
envoyer le message
Envoyer un message.
échantillon
Envoyer en spécifiant l'ID utilisateur dans Messenger
let response = await getAPIClient().sendMessage(
"messenger", // messenger を指定したダイレクトメッセージを指定
"Hello!", // 送信するメッセージ
false, // 封書は off
["user1@xxx.com", "user2@xxx.com"] // 宛先 Email アドレス
);curl -H "x-cam-apiToken:token******" -d message="{\"panelName\":\"messenger\",\"message\":\"Hello\",\"isOpened\":false,\"generalPurposes\":{\"users\":\"user1@xxx.com,user2@xxx.com\"}}" ${serverURL}/sendMessageSpécifiez la salle de discussion et envoyez
let response = await getAPIClient().sendMessage(
"ルーム名",
"Hello!",
false,
["user1@xxx.com", "user2@xxx.com"] // メンションとして Email アドレス指定
);curl -H "x-cam-apiToken:token******" -d message="{\"panelName\":\"ルーム名\",\"message\":\"Hello\",\"isOpened\":false,\"generalPurposes\":{\"users\":\"user1@xxx.com,user2@xxx.com\"}}" ${serverURL}/sendMessageargument
| envoyer |
|
| utilisateurs |
|
| message |
|
| joint |
|
envoyer des messages
Envoyez des messages en masse à partir d'un fichier json.
Veuillez enregistrer le fichier json dans le code de caractère UTF8.
échantillon
curl -H "x-cam-apiToken:token******" -d @messages.json ${serverURL}/sendMessages messages=[
{"message":"こんにちは 1","property":{"users":"user1@test.com,user2@test.com"}},
{"message":"こんにちは 2","property":{"users":"user1@test.com,user2@test.com"}},
{"message":"こんにちは 3","property":{"users":"user1@test.com,user2@test.com"}},
{"message":"こんにちは 4","property":{"users":"user1@test.com,user2@test.com"}},
]messages=[
{"send": "test", "message":"テスト 1"}
]créer un appel rapide
conférence Web rapide Créez une URL.
échantillon
Créer une URL de réunion rapide
let response = await getAPIClient().createQuickCall(
1624368868714, // クイック会議の期限(UnixTimeミリ)
"password!", // クイック会議のパスワードを指定
);argument
| date d'expiration |
|
| mot de passe |
|
mettre à jourChatRoom
Créer/mettre à jour une salle de discussion
échantillon
let chatRoom = {
"id":"1564831284702237059",
"name":"秘密会議"
"createUserId":"11u1pu9d32p8vuvjoZdd",
"adminUserId":"11u1pu9d32p8vuvjoZdd",
"isPublic":false,
"memberUids":{
"11u1pu9d32p8vuvjoZdd":true,
"1lmn7hoh3s1ja26fsazw":true,
"hhx10sfdv1jyou4la1ny":true,
"3400w9rfvs504c35dt99":true,
"309d32p8vuvjo5euuuwx":true
},
}
let response = await getAPIClient().updateChatRoom(chatRoom);
let errors = response['errors'];
if (errors) {
console.log(errors);
return;
}
console.log(response["chatRoom"]);argument
| tchat |
|
getConferenceMaster
Obtenez la liste principale des salles de conférence.
échantillon
let response = await getAPIClient().getConferenceMaster();
let errors = response['errors'];
if (errors) {
console.log(errors);
return;
}
console.log(response["conferenceRooms"]);argument
aucun
getConferenceRoomStatus
Obtenir une liste des statuts de réservation de salles de conférence
échantillon
let response = await getAPIClient().getConferenceRoomStatus("201908");
let errors = response['errors'];
if (errors) {
console.log(errors);
return;
}
console.log(response["conferenceRoomStatus"]);argument
| aaaaMMjj |
|