Connecter la téléphonie

Le connecteur de téléphonie relie Portail ZAPP à l'opérateur de téléphonie de l'entreprise : Ringover, Aircall, 3CX (V20) ou Teams Phone. Un seul opérateur est actif à la fois. L'écran est réservé aux administrateurs ; l'entrée Téléphonie se trouve dans le menu Administration › Connecteurs et automatisation.

Sans connecteur, rien ne casse : les numéros restent des liens qui ouvrent l'application d'appel de chacun. Le connecteur ajoute, dans le CRM, l'appel en un clic, la fiche du correspondant à l'appel entrant et le journal d'appel automatique (voir Téléphonie dans la documentation du CRM).

Préparer les identifiants

Les clés et secrets ne se saisissent jamais dans cet écran : rangez-les d'abord dans le Coffre de secrets, puis choisissez leur nom.

Choisissez aussi le pays par défaut : il sert aux numéros saisis sans indicatif (« 06 12 34 56 78 »).

Déclarer le webhook

Après l'enregistrement, le cadre Connexion affiche l'adresse du webhook. Déclarez-la chez l'opérateur :

• Ringover : webhooks d'appel (sonné, décroché, raccroché, manqué) ;
• Aircall : un webhook sur les événements d'appel (call.created, call.ringing_on_agent, call.answered, call.ended, call.voicemail_left) ;
• 3CX : l'intégration CRM côté serveur. La recherche de contact appelle l'adresse avec event=lookup&number=[Number]&agent=[Agent] ; le journal d'appel envoie event=journal, number, agent, type ([CallType]), start ([DateTime]) et duration ([Duration]).

Teams Phone n'utilise pas de webhook : les appels terminés sont relevés automatiquement toutes les cinq minutes.

L'adresse contient un jeton secret : ne la communiquez qu'à l'opérateur. Régénérer l'adresse en crée une nouvelle, et l'ancienne cesse aussitôt de fonctionner.

Tester la connexion vérifie les identifiants auprès de l'opérateur.

Associer les utilisateurs

Dans Correspondance des utilisateurs, associez chaque compte à son identité chez l'opérateur :

• Ringover : son user_id et son numéro Ringover, celui qui sonne pour l'appel en un clic ;
• Aircall : son identifiant d'utilisateur Aircall ;
• 3CX : son numéro de poste ;
• Teams Phone : l'Object ID de son compte Entra ID.

Sans correspondance, une personne n'a pas l'appel en un clic et ses appels ne sont pas journalisés.

Un numéro de ligne n'est associé qu'à un seul compte. Un numéro partagé (standard) ne désigne personne : ses appels sont gardés dans le journal technique, mais ne sont attribués à aucun commercial.

Ce que chaque opérateur permet

Données conservées

Le connecteur garde un journal technique des appels (pour reconnaître un envoi répété) pendant 30 jours par défaut (réglable de 1 à 365 jours). Les appels eux-mêmes sont conservés dans le CRM, sous forme d'activités.