Pour utiliser la téléphonie VoIPstudio dans Mavibot, vous devez créer une clé API dans votre compte VoIPstudio, la saisir dans les paramètres d'intégration et configurer la livraison des événements vers l'URL que Mavibot affiche après la connexion de l'intégration.

VoIPstudio est un PBX cloud avec des numéros de téléphone disponibles dans plus de 70 pays. Contrairement à un opérateur télécom traditionnel, il prend en charge les utilisateurs internes, les groupes de sonnerie, les files d'attente et les menus IVR, tandis que le bot fonctionne au-dessus de ce PBX.

Le bot peut initier des appels vers les clients au nom des employés, transférer et terminer des appels, enregistrer des enregistrements et envoyer des événements d'appel dans la conversation.

Obtention des informations requises

  1. Inscrivez-vous sur voipstudio.com et achetez un numéro de téléphone dans le pays requis.
  2. Créez des utilisateurs dans le PBX — un pour chaque employé qui recevra des appels. Les appels sont livrés à tous les appareils enregistrés pour un utilisateur, vous n'avez donc pas besoin de spécifier un numéro de téléphone séparé pour chaque employé.
  3. Allez dans Paramètres → API, créez une clé API et copiez-la.

Connexion de l'intégration

Dans les paramètres de téléphonie, sélectionnez VoIPstudio et saisissez :

  • Clé API — la clé de votre compte VoIPstudio.

L'intégration est maintenant connectée. Pour la déconnecter, effacez le champ Clé API et enregistrez les paramètres.

Après l'enregistrement, une URL de notification apparaîtra sur la page. Copiez-la :

https://chatter.mavibot.ai/voipstudio_webhook/<votre-clé-de-projet>

Ne publiez pas cette URL et ne la partagez avec personne. Si vous déconnectez et reconnectez l'intégration, la clé reste la même, vous n'aurez donc pas besoin de reconfigurer les notifications.

Ensuite, dans votre compte VoIPstudio, allez dans Intégrations → Webhooks → Activer → Ajouter un webhook, collez l'URL copiée et sélectionnez les événements suivants :

  • Changement d'état d'appel — ou sélectionnez individuellement Appel en sonnerie, Appel connecté, Appel terminé et Appel manqué ;
  • Enregistrement d'appel prêt — si vous avez besoin d'enregistrements d'appels.

Sans cette configuration, les appels sortants fonctionneront toujours, mais les événements d'appel n'apparaîtront pas dans la conversation.

Employés

Dans les paramètres de l'employé, remplissez le champ ID utilisateur VoIPstudio — l'identifiant numérique de l'utilisateur dans votre PBX, par exemple 10002.

Saisissez l'ID utilisateur du PBX, pas un numéro de téléphone. Vous pouvez trouver l'ID dans la liste des utilisateurs de votre compte VoIPstudio. Sans cela, 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.

VoIPstudio appelle d'abord l'employé sur tous ses appareils enregistrés simultanément. Une fois que l'employé répond, VoIPstudio appelle le client et connecte les deux parties.

Si l'employé ne répond pas, le client ne sera pas appelé.

Fonctions du calculateur

Appel employé vers client

voipstudio_employee_call(client_phone, employee_user_id, caller_id)

Paramètres :

  • client_phone — le numéro de téléphone du client. Requis.
  • employee_user_id — l'ID utilisateur VoIPstudio de l'employé qui doit recevoir le premier appel. Requis.
  • caller_id — le numéro de téléphone affiché au client. Optionnel. Vous pouvez passer anonymous pour masquer l'identifiant de l'appelant.

Transférer un appel

voipstudio_transfer_call(phone, call_id)

Transfère un appel actif vers un autre numéro de téléphone.

Paramètres :

  • phone — le numéro de téléphone vers lequel l'appel doit être transféré. Requis et doit être le premier paramètre.
  • call_id — l'identifiant de l'appel. Optionnel. S'il est omis, l'appel actuel du client est pris à partir de la variable voipstudio_call_id.

Terminer un appel

voipstudio_hangup_call(call_id)

Termine un appel actif.

Paramètres :

  • call_id — l'identifiant de l'appel. Optionnel. S'il est omis, l'appel actuel du client est utilisé.

Obtenir un lien d'enregistrement d'appel

voipstudio_get_record_link(call_id)

Renvoie un lien vers l'enregistrement de l'appel. Le lien est normalement enregistré automatiquement lorsque l'événement d'enregistrement prêt est reçu. Cette fonction est utile si cet événement n'a pas été reçu.

Paramètres :

  • call_id — l'identifiant de l'appel. Optionnel. S'il est omis, l'appel actuel du client est utilisé.

La fonction recherche les 100 enregistrements les plus récents du compte. Pour un appel plus ancien sur un PBX à fort volume, elle peut ne pas trouver l'enregistrement. Dans ce cas, récupérez l'enregistrement directement depuis votre compte VoIPstudio.

Rappels pendant un appel

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

voipstudio_call_event call.hangup

Le nom de l'événement est transmis exactement comme reçu de VoIPstudio, par exemple call.ringing, call.connected, call.hangup, et autres. Les événements disponibles dépendent des événements que vous avez sélectionnés lors de la configuration des notifications.

Si aucun nom d'événement n'est fourni, l'état de l'appel est utilisé à la place :

INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP.

Un rappel séparé est envoyé lorsque l'enregistrement est prêt :

voipstudio_call_event recording

Attendez le rappel recording avant d'utiliser le lien d'enregistrement. L'enregistrement est traité après la fin de l'appel, donc la variable voipstudio_record_link est encore vide lorsque call.hangup est reçu.

Si deux employés de votre propre PBX se parlent, les rappels ne sont pas envoyés à la conversation et aucune fiche client n'est créée.

Variables client après un appel

Variable Valeur
voipstudio_call_id ID de l'appel dans VoIPstudio
voipstudio_call_state État de l'appel : INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP
voipstudio_call_duration Durée de l'appel en secondes
voipstudio_call_cause Raison de la fin de l'appel
voipstudio_terminated_by Qui a terminé l'appel : caller ou callee
voipstudio_record_link Lien vers l'enregistrement de l'appel
voipstudio_record_id ID de l'enregistrement dans VoIPstudio

Enregistrements d'appels

L'enregistrement des appels est activé dans les paramètres VoIPstudio et est géré par le PBX lui-même. Si vous avez besoin d'enregistrements, activez l'enregistrement des appels dans votre compte VoIPstudio et sélectionnez l'événement Enregistrement d'appel prêt lors de la configuration des notifications.

L'URL voipstudio_record_link est protégée par une clé d'accès. Elle ne peut pas être ouverte directement dans un navigateur ni partagée avec un client. Vous pouvez télécharger l'enregistrement depuis votre compte VoIPstudio dans la section historique des appels.

L'enregistrement des appels est soumis aux lois applicables. En Allemagne, en France, en Espagne et dans la plupart des États américains, le consentement des deux parties peut être requis, et dans certaines juridictions, un avis verbal au début de l'appel peut également être nécessaire. Le propriétaire du compte VoIPstudio est responsable du respect de ces exigences.

Dépannage

Erreur Cause
Erreur d'autorisation lors de la création d'un appel La clé API est incorrecte ou expirée. Assurez-vous que la clé a été créée sous Paramètres → API plutôt que d'être obtenue via une requête login.
Les appels fonctionnent, mais aucun rappel n'apparaît dans la conversation Aucun webhook n'a été créé dans VoIPstudio, l'interrupteur Activer est désactivé, ou une URL incorrecte a été saisie. Copiez l'URL complète depuis la page d'intégration, y compris la clé à la fin.
L'appel ne peut pas être créé ou les appareils de l'employé ne sonnent pas Un numéro de téléphone a été saisi au lieu de l'ID utilisateur VoIPstudio, ou l'utilisateur n'a pas d'appareils enregistrés.
Le rappel recording n'est pas reçu L'enregistrement des appels n'est pas activé dans VoIPstudio, ou l'événement Enregistrement d'appel prêt n'a pas été sélectionné.

VoIPstudio est facturé directement par VoIPstudio : il y a des frais d'abonnement pour chaque utilisateur du PBX, plus des frais d'appel. Cela diffère des opérateurs qui facturent par minute sans abonnement récurrent. Lors de l'estimation des coûts, tenez compte du nombre d'utilisateurs configurés, pas seulement du volume d'appels.