Wildix Web API Guide Rapide Version: 11.12.2013
API Web Wildix s'intègre avec les logiciels CRM, ERP, les solutions et web applications Fias / Fidelio. L'API de téléphonie Javascript vous permet de contrôler les appareils connectés à l'entreprise Wildix PBX. Informations générales 3 Téléchargement de la librairie Javascript 3 Exigences 4 Caractéristiques 4 Plugin de Téléphonie 4 Plugin du Chat 5 Plugin de Présence 5 Plugin des Groupes d Appel 6 Démo Web API 7 Demo de la Console 7 Demo du Chat 8 Subscription Demo 9 Demo des Groupes d Appel 10 Wildix Web Api Guide Rapide 2
Informations générales Web API est une API de téléphonie Javascript qui vous permet de contrôler les appareils (compatibles) connectés à votre PBX Wildix à partir d'une page web. Web API transforme n'importe quelle page Web en un Poste Opérateur permettant d'effectuer et de recevoir des appels via votre téléphone ou le client Zéro Distance en un seul clic. Vous pouvez avoir une page séparée pour la communication ou incluant l'application dans n'importe quelle page web existante que les employés peuvent utiliser pour surveiller, faire, recevoir et gérer tous les appels internes et externes. Web API prend en charge également le Chat et le Service de Présence. Les utilisateurs peuvent voir l'état de présence de chacun et les échanges de messages via le Chat entre collègues. Introduire l'api Web peut apporter un changement positif considérable à la routine quotidienne des employés. API Web est une solution idéale pour le réceptionniste, le secrétaire, les opérateurs puisque vous pouvez intégrer l'api n'importe où dans votre page Web ou votre application web. Les employés peuvent gérer tous les appels sans avoir à ouvrir une autre page web, une application séparée, ou même regarder l'écran de leur téléphone. Un employeur peut surveiller les appels directement depuis l'application web utilisée par l'entreprise. Prenons l'exemple d'un responsable des réservations ou d'un agent de voyage. Celui-ci parle au téléphone avec le client en essayant en même temps de trouver la meilleure solution possible à lui offrir. L'API de téléphonie, visible dans le coin de la page Web, permet à l'employé de surveiller et gérer les appels de la même page Web. Il peut démarrer et arrêter l'enregistrement d'un appel d'un simple clic sur un bouton, mettre un appel en attente et lancer un autre appel interne ou externe. Il peut également voir les notifications au sujet d'autres appels entrants, répondre à ces derniers ou les refuser sans être distrait du travail qu'il fait à ce moment. Tirez parti des solutions Wildix pour améliorer votre service clientèle, afin d'accélérer, de faciliter votre travail et augmenter votre efficacité! La mise en œuvre de l'api Web Wildix ne nécessite pas un développeur expert en JavaScript. L'architecture de l'api est évolutive, flexible et permet d'ajouter des caractéristiques supplémentaires très efficaces. À l'heure actuelle, toutes les fonctionnalités de téléphonie de base sont prises en charge: passer un appel, répondre à l'appel, mettre un appel en attente, reprendre un appel, raccrochage, démarrer et arrêter un enregistrement d'appel ou encore de surveiller les appels actifs. La bibliothèque javascript offre des fonctions de rappel qui peuvent être utilisées pour générer les pop-ups et qui permet l'intégration facile avec d'autres environnements. Téléchargement de la librairie Javascript La bibliothèque Javascript et ses éventuelles mises à jour peuvent être téléchargées à partir du PBX, en utilisant cette adresse: http://% PBX_IP% / public / wtapi.js Exemple: http://192.168.1.124/public/wtapi.js La version de la bibliothèque disponible sur le PBX est toujours compatible avec la version du firmware PBX installée. Wildix Web Api Guide Rapide 3
Exigences Un serveur web Les licences Wildix: - CTIconnect PRO - W-TAPI L'application a été testée sur les navigateurs suivants: - Firefox 21 - Opera 12 - Google Chrome 27 - Safari 6 - IE 10 Caractéristiques Plugin de Téléphonie Le Plugin de Téléphonie (Console) permet de contrôler les périphériques pris en charge connectés au PBX Wildix et enregistrés sur votre poste. Fonctionnalités de téléphonie pris en charge actuellement : Émettre un appel. Répondre ou refuser un appel. Mettre un appel en attente et le reprendre. Transfert masqué. Pont entre deux appels (transfert de préposé). Démarrer et d'arrêter l'enregistrement d'appel. Raccrochage. Surveiller vos appels actifs et recevoir de nouvelles notifications d'appel. Wildix Web Api Guide Rapide 4
Périphériques pris en charge: Les téléphones WP Wildix (sauf WP400) Le client Zéro Distance* * L'application Wildix Zéro Distance est nécessaire Un utilisateur connecté via l'api Web apparaît en ligne pour tous les autres utilisateurs du système connecté à CTIconnect PRO. Plugin du Chat Le plugin du Chat permet d'échanger (envoyer et recevoir) des messages chatter avec tous les utilisateurs du système. Plugin de Présence Le Plugin de Présence vous permet de surveiller l'état de présence des collègues, leur emplacement (géolocalisation si indiquée) et de montrer votre propre état de présence et d'emplacement. Wildix Web Api Guide Rapide 5
Plugin des Groupes d Appel Le module vous permet de surveiller l activité du centre d appels et de gérer les groupes d appel. Fonctions: Recevoir la liste de tous les groupes d appel avec la liste des membres Surveiller les appels en cours Voir le temps de conversation et le temps d inactivité pour chaque membre Ajouter les membres aux groupes d appel de manière dynamique Mettre un utilisateur en pause dans le groupe d appel Voir la liste des appelants, ainsi que l information sur le canal et le temps d attente pour chaque appelant dans la file d attente Remarques sur l utilisation: Il n est pas possible d ajouter un utilisateur à un groupe d appel sur le WMS Network de manière dynamique. Pour un utilisateur qui a été ajouté à un groupe d appel de manière dynamique, les préférences d utilisateur ne fonctionnent pas (NPD, mobilité, transfert d appel), Appel en attente n est pas active. Pour les membres qui ont été ajoutés à travers le WMS, les préférences d utilisateur fonctionnent, Appel en attente est active. L action de l ACL peut / ne peut pas gérer le centre d appel (WMS > Utilisateurs > Groupes) permet à un utilisateur d effectuer les actions sur les membres: mettre un membre en pause dans le groupe, ajouter des utilisateurs aux groupes d appel. Dans le cas où le groupe ACL de l utilisateur ne lui permet pas de gérer le centre d appel, il peut effectuer les actions seulement sur soi-même: ajouter soi-même aux groupes d appel, mettre soi-même en pause dans les groupes d appel. Wildix Web Api Guide Rapide 6
Démo Web API Le paquet contient une bibliothèque Javascript et un exemple de code html. Un accès direct à la documentation du développeur est fourni sur la page de connexion de la démonstration (http://www.wildix.com/webapi/doc/). La démo Web API est un exemple de travail, téléchargez la sur votre serveur Web pour un essai! L'API Web en version de démonstration peut être trouvée sur le site Wildix: http://pbx.wildix.com/webapi/ Installation: - Téléchargez le paquet. - Décompressez l'archive dans un dossier sur votre serveur web. - Ouvrez le navigateur et tapez le chemin d'accès au dossier de l'api Web dans l'url: l'adresse IP du serveur, l'adresse et le dossier dans lequel l'api Web réside. Exemple: http://192.168.1.198/webapi/ Connection: Vous devez avoir un ou plusieurs périphériques pris en charge connectés au PBX et enregistrés sur votre extension Wildix. - Ouvrez le navigateur et tapez l'adresse IP du serveur en l'url. Exemple: http://192.168.1.198/webapi/ - Entrez vos informations et votre adresse de PBX ou d'un domaine nom et ajouter à la fin le chemin: /cticonnect/http-bind/ - Cliquez enfin sur "Connect" Demo de la Console Lancer un appel - Tapez le numéro de poste dans champ (par exemple "3241") - Sélectionnez le périphérique pour faire un appel. Par exemple, cliquez sur "Call via..." pour faire un appel ou appuyez sur la flèche pour sélectionner un autre appareil. Wildix Web Api Guide Rapide 7
Recevoir un appel - Chaque fois que vous recevez un appel, un message sur la page de démonstration s'affiche. - Appuyez sur Answer using... ", ou si vous avez plusieurs appareils enregistrés sur votre extension, cliquez sur la flèche pour changer le périphérique. - Appuyez sur "Refuser" pour refuser un appel entrant. Gérer un appel L'application vous permet de surveiller et de gérer tous les appels actifs. - Appuyez sur "Hangup" pour terminer l'appel. - Appuyez sur "Hold" pour mettre un appel en attente et sur "Resume" pour reprendre un appel. - Appuyez sur ''Record'' pour démarrer un enregistrement d'appel. Appuyez sur "Stop Record" pour arrêter l'enregistrement de l'appel. - Appuyez sur "Transfer" pour faire un transfert masqué. Dans le cas où vous avez plusieurs appels actifs, vous pouvez appuyez sur le bouton "Transfer" et sélectionnez un autre appel en cours pour unir deux appels et effectuer un transfert assisté. Demo du Chat Pour rédiger un nouveau message de discussion, entrez un numéro de poste dans le champ et cliquez sur "+" Votre message de discussion appuyez sur "Entrée". Wildix Web Api Guide Rapide 8
Subscription Demo - En ligne - L'utilisateur a mis en place le statut "Absent" - L'utilisateur a mis en place le statut " Ne pas déranger" - Hors ligne (déconnecté) - L'utilisateur a mis en place le statut "Absent" avant de se déconnecter - L'utilisateur a mis en place le statut «DND» avant de se déconnecter - Appel entrant - L utilisateur parle au téléphone L'icône indique que l'utilisateur a configuré sa géolocalisation Placez le curseur sur le numéro du poste pour voir l'ensemble des informations de présence: - Le statut de présence de l'utilisateur - Message d'état (si indiqué) - Jusqu'à (date d'expiration d'un message d'état, si cela est indiqué par l'utilisateur) - Géolocalisation (si indiquée) Abonnez-vous pour suivre l'état de présence des utilisateurs qui ne sont pas dans votre liste: Entrez le numéro de poste dans le champ et cliquez sur "+" pour l'ajouter manuellement à la liste. Cliquez sur "-" pour supprimer un contact de la liste. Dans le cas où un utilisateur est présent dans votre liste, vous ne pouvez pas le supprimer manuellement de la liste. Modifier votre état de présence personnelle Cliquez sur l'icône de votre état de présence et sélectionner un nouveau statut. En outre, vous pouvez ajouter un message de statut. Dans le cas où vous avez mis en place un statut "NPD" ou "Absent" vous pouvez entrer la date d'expiration ce statut comme une information supplémentaire pour les collègues. Cliquez sur Apply après que vous ayez choisi un nouveau statut. Wildix Web Api Guide Rapide 9
Demo des Groupes d Appel Appuyez Subscribe pour s abonner à surveiller les groupes d appel: La liste des groupes d appel avec les listes des membres va être affichée sur la page: L information sur les appelants en file d attente, ainsi que l information sur le canal et le temps d attente (la colonne Time ) sont affichées pour chaque appelant. Pour chaque membre d un groupe d appel les informations sur le statut de dispositif, le nombre d appels, le temps de conversation ou le temps d inactivité sont affichées. La colonne Status Pour les membres qui ont été ajoutés de manière dynamique, l information sur le statut de dispositif est correcte: not_inuse, inuse, ringing. Pour les membres qui ont été ajoutés à travers le WMS, le statut inuse signifie que l utilisateur reçoive en appel, le statut not_inuse est affiché dans tous les autres cas. La colonne Talk Le temps de conversation est indiqué avec des valeurs positives tandis que le temps d inactivité est indiqué dans la colonne avec des valeurs négatives. Dés que le membre répond à un appel, le compteur du temps de conversation commence. Dés que le membre raccroche, le compteur du temps d inactivité commence. Les actions Pour mettre en pause un membre dans le groupe, cliquez sur l icône Pour ajouter un membre à un groupe, cliquez le touche Add user et entrez l extension, puis cliquez sur Add Pour effacer un utilisateur qui a été ajouté à un groupe de manière dynamique, cliquez sur l icône x Wildix Web Api Guide Rapide 10
Contacts France: +33 176 747 980 support@wildix.fr Italie: +39 0461.1715112 support@wildix.com Wildix Web Api Guide Rapide 11