Pour utiliser la téléphonie Verimor dans Mavibot, vous devez obtenir une clé API depuis votre compte Verimor et la saisir dans les paramètres d'intégration.

Verimor est un fournisseur de télécommunications turc. Son produit Bulut Santralim est un PBX cloud : les employés travaillent avec des extensions internes, et les appels sont acheminés via ces extensions.

Le bot peut connecter un employé avec un client, transférer et terminer des appels, récupérer des enregistrements et envoyer des événements d'appel à la conversation.

Obtention des données requises

  1. Activez le service Bulut Santralim avec Verimor et créez des extensions internes pour vos employés.
  2. Ouvrez Online İşlem Merkezi → Bulut Santralim → Santral Ayarlarım et copiez la clé API. Elle ressemble à ceci :
K12345678-1234-5678-4321-123456789012
  1. Notez les extensions internes des employés. Vous devrez les spécifier dans les paramètres d'accès.

La clé API est partagée sur l'ensemble du PBX et est utilisée à la fois pour les appels et pour la réception des événements. Si vous la régénérez dans le tableau de bord Verimor, assurez-vous de réenregistrer le formulaire de connexion. Sinon, les appels et les événements de conversation cesseront de fonctionner.

Connexion

Dans l'onglet téléphonie, sélectionnez Verimor et saisissez :

  • Clé API — la clé de la section Santral Ayarlarım.
  • Numéro sortant — le numéro externe que le client verra, au format 908505320000. Ce champ est facultatif. S'il est laissé vide, le numéro attribué à l'extension interne de l'employé sera utilisé.


L'intégration est maintenant connectée.

Pour déconnecter l'intégration, effacez le champ Clé API et enregistrez les paramètres.

Vous n'avez pas besoin de configurer manuellement l'URL de notification. Mavibot la définit automatiquement dans votre PBX lorsque la clé API est enregistrée.

Employés

Dans les paramètres de l'employé, renseignez l'extension interne (dahili) de l'employé — généralement 3 à 4 chiffres, par exemple 1001.

Saisissez l'extension interne du PBX, pas le numéro de téléphone mobile de l'employé. Sans elle, le bouton d'appel dans la fiche client ne fonctionnera pas pour cet employé.

Appel depuis la fiche client

Un bouton d'appel apparaîtra à côté du numéro de téléphone du client dans la fiche de conversation.

Le PBX appelle d'abord l'extension interne de l'employé. Ce n'est qu'après que l'employé répond que le client est appelé.

Cet ordre est intentionnel : le client n'entendra pas de silence sur la ligne car l'employé est déjà connecté lorsque le téléphone du client commence à sonner.

Fonctions du calculateur

Appel Employé vers Client

verimor_employee_call(client_phone, employee_extension, caller_id)

Paramètres :

  • client_phone — le numéro de téléphone du client. Requis. Utilisez le format turc 908505320000, ou 00493027590915 pour les appels internationaux.
  • employee_extension — l'extension interne de l'employé dont le téléphone sonnera. Requis.
  • caller_id — le numéro que le client verra. Facultatif. S'il est omis, le numéro sortant des paramètres de connexion est utilisé.

La fonction retourne call_uuid — l'identifiant de l'appel. Il est également enregistré dans la variable verimor_call_uuid.

Transférer un appel

verimor_transfer_call(employee_extension, call_uuid)

Transfère l'appel en cours vers une autre extension interne.

Paramètres :

  • employee_extension — l'extension interne vers laquelle l'appel sera transféré. Requis.
  • call_uuid — l'identifiant de l'appel. Facultatif. S'il est omis, l'appel le plus récent du client est utilisé.

Terminer un appel

verimor_hangup_call(call_uuid)

Paramètres :

  • call_uuid — l'identifiant de l'appel. Facultatif. S'il est omis, l'appel le plus récent du client est utilisé.

Obtenir le lien d'enregistrement de l'appel

verimor_get_record_link(call_uuid)

Demande un lien frais vers l'enregistrement de l'appel.

Paramètres :

  • call_uuid — l'identifiant de l'appel. Facultatif. S'il est omis, l'appel le plus récent du client est utilisé.

Rappels pendant un appel

Au fur et à mesure que l'appel progresse, des rappels sont envoyés à la conversation au format suivant :

verimor_call_event answer

Événements possibles :

Événement Quand il est déclenché
ringing L'appel sonne
answer L'appel a été répondu
hangup L'appel a été terminé
user_hangup L'employé a terminé l'appel

Les appels entre employés n'apparaissent pas dans la conversation.

Un scénario typique "pas de réponse → envoyer un message dans le messager" peut être déclenché par hangup et la vérification de la variable verimor_call_answered.

Variables client après un appel

Variable Valeur
verimor_call_uuid Identifiant de l'appel
verimor_call_direction Direction : inbound — le client vous appelle, outbound — vous appelez le client
verimor_call_extension Extension interne de l'employé qui a géré l'appel
verimor_call_duration Durée de l'appel en secondes
verimor_call_answered 1 — l'appel a été répondu, 0 — il ne l'a pas été
verimor_hangup_cause Code indiquant pourquoi l'appel a été terminé
verimor_has_record 1 — un enregistrement existe, 0 — aucun enregistrement n'existe
verimor_record_link Lien vers l'enregistrement de l'appel après avoir appelé verimor_get_record_link()

Codes de cause de raccrochage

Les valeurs les plus courantes de verimor_hangup_cause sont :

Code Signification
NORMAL_CLEARING L'appel a été terminé et s'est déroulé normalement
USER_BUSY Occupé
NO_ANSWER Pas de réponse
ORIGINATOR_CANCEL L'appelant a raccroché avant que l'appel ne soit répondu
CALL_REJECTED L'appel a été rejeté
UNALLOCATED_NUMBER Numéro invalide
NO_USER_RESPONSE L'abonné est indisponible
NOT_ALLOWED_BY_IYS Pas de permission dans İYS, le registre de consentement turc pour les appels commerciaux

Enregistrements d'appels

L'enregistrement des appels doit être activé dans les paramètres de votre PBX Verimor. Les enregistrements sont stockés dans votre compte Verimor.

⏳ Les liens d'enregistrement restent valides pendant 60 minutes à partir du moment où ils sont demandés. Après cela, ils cessent de fonctionner. Verimor permet également au maximum cinq demandes de lien d'enregistrement par minute par clé API.

Ce que cela signifie :

  • La variable verimor_record_link n'est pas remplie automatiquement. Vous devez d'abord appeler verimor_get_record_link().
  • Dans un scénario qui envoie un enregistrement, appelez verimor_get_record_link() au moment de l'envoi de l'enregistrement, pas à l'avance.
  • Vérifiez d'abord verimor_has_record pour ne pas gaspiller la limite de demandes sur des appels sans enregistrement.
  • Si vous devez conserver un enregistrement de manière permanente, enregistrez le fichier dans votre propre stockage immédiatement après l'appel.
  • L'archive des enregistrements reste disponible dans le tableau de bord Verimor, où les enregistrements peuvent être lus et téléchargés ultérieurement.

L'enregistrement des appels est réglementé par la loi. En Turquie, il est soumis aux exigences KVKK : le client doit être informé de l'enregistrement, et le stockage des données personnelles doit avoir une base légale. Le propriétaire du compte Verimor est responsable du respect des exigences applicables.

Dépannage

Erreur Cause / Solution
Gecersiz anahtar Clé API invalide. Obtenez la clé actuelle depuis la section Santral Ayarlarım.
extension 1005 not found L'extension interne n'existe pas dans votre PBX. Assurez-vous que les paramètres de l'employé contiennent un dahili existant.
"Verimor internal extension is not specified" Les paramètres de l'employé sont vides ou contiennent un numéro de téléphone mobile au lieu d'une extension interne.
Les appels fonctionnent, mais aucun rappel n'apparaît dans la conversation L'URL de notification n'a pas été configurée. Enregistrez à nouveau le formulaire de connexion.
Les appels ont cessé de fonctionner après avoir changé la clé API La clé a été régénérée dans le tableau de bord Verimor. Saisissez la nouvelle clé dans le formulaire de connexion et enregistrez-le.
Le lien d'enregistrement ne s'ouvre pas Le lien a expiré. Demandez un lien frais avec verimor_get_record_link() ou ouvrez l'enregistrement dans le tableau de bord Verimor.
Le lien d'enregistrement n'est pas retourné La limite de cinq demandes par minute a été atteinte, ou l'appel n'a pas d'enregistrement. Vérifiez verimor_has_record.