Notifications d'appel

• Description : Donnez à cette notification d'appel un nom que vous reconnaîtrez en un coup d'œil. Seule votre équipe le voit, jamais l'appelant.
• Service : Choisissez où cette notification doit être envoyée : sélectionnez Personnalisé pour la configurer vous-même, ou Robin pour l'envoyer directement vers l'intégration Robin.
• URL du webhook : Collez l'URL complète du webhook, incluant https://, où vous souhaitez que ces notifications soient envoyées.

• Call notifications_send_summary_events : Si vous cochez cette case, les résumés d'appels seront inclus avec les notifications d'appel. Veuillez noter : Intelligence doit être activé pour que cela fonctionne.
• Call notifications_send_transcription_events : Si vous cochez cette case, les transcriptions d'appels seront incluses avec les notifications d'appel. Veuillez noter : Intelligence doit être activé pour que cela fonctionne.

Durant un appel, les informations sont envoyées à l'URL spécifiée à six moments différents pour les appels entrants, internes et sortants : Créé, Sonnerie, Répondu, Transfert accompagné, Transfert direct et Raccroché. Les notifications sont envoyées à l'URL spécifiée lors de divers événements importants pendant un appel. Les notifications sont envoyées sous forme de requête POST avec les données dans un document JSON. Ci-dessous, vous pouvez voir exactement quelles informations sont envoyées.

Créé

Un événement created est déclenché lorsqu'un appel entrant est initié.

• call_id : Une chaîne unique pour identifier l'appel.
• timestamp : La date et l'heure auxquelles le webhook est généré, au format ISO 8601.
• status : Le statut de l'appel. Pour ce type de notification, il est created.
• version : Un attribut de version qui peut être utilisé à l'avenir pour migrer vers une autre version des webhooks. Actuellement, il est toujours v2.
• direction : Indique si un appel est entrant (inbound) ou sortant (outbound). L'événement créé n'est envoyé que pour les appels entrants.
• caller : Informations sur l'appelant.
• number : Le numéro de téléphone que l'appelant utilise.
• name : Le nom de l'appelant.
• account_number : Cette information n'est pas envoyée avec l'événement created.
• user_numbers : Cette information n'est pas envoyée avec l'événement created.
• user_emails : Cette information n'est pas envoyée avec l'événement created.
• destination : Informations sur la destination de l'appel.
• number : Le numéro de téléphone que l'appelant a composé.

Sonnerie

Une notification ringing est envoyée lorsque les téléphones commencent à sonner en raison d'un appel entrant.

Il est possible que plusieurs notifications ringing soient envoyées successivement au fur et à mesure que de nouveaux appareils commencent à sonner.

• call_id : Une chaîne unique pour identifier l'appel.
• timestamp : La date et l'heure auxquelles le webhook est généré, au format ISO 8601.
• status : Le statut de l'appel. Pour ce type de notification, il est ringing.
• version : Un attribut de version qui peut être utilisé à l'avenir pour migrer vers une autre version des webhooks. Actuellement, il est toujours v2.
• direction : Indique si un appel est entrant (inbound) ou sortant (outbound). Les appels entre collègues sont marqués comme outbound.
• caller : Informations sur l'appelant.
• number : Le numéro de téléphone que l'appelant utilise.
• name : Le nom de l'appelant.
• account_number : Cette information n'est pas envoyée avec l'événement ringing.
• user_numbers : Cette information n'est pas envoyée avec l'événement ringing.
• user_emails : Cette information n'est pas envoyée avec l'événement ringing.
• destination : Informations sur la destination de l'appel.
• number : Le numéro de téléphone que l'appelant a composé.
• targets : Les téléphones qui sonnent pour cet appel. Les téléphones qui ne sont pas joignables ne sont pas affichés.
• number : Le numéro qui est appelé. Il s'agit généralement du même que destination.number, mais peut changer si l'appel est redirigé.
• name : Le nom de la personne appelée. Pour les appels entrants, il s'agit presque toujours de null.
• account_number : Les numéros internes des utilisateurs qui ont configuré leur Compte VoIP pour être joignables (lorsque disponible, peut être un tableau vide).
• user_numbers : Les numéros internes des utilisateurs qui sont joignables (lorsque disponible, peut être un tableau vide).
• user_emails : Les adresses e-mail des utilisateurs.

Répondu (en cours)

Une notification in-progress est envoyée lorsqu'un appel reçoit une réponse.

Remarque ! La target qui répond à l'appel n'est pas toujours l'un des appareils qui ont initialement sonné. En raison de la prise d'appel, il se peut que l'appel soit répondu sur un appareil différent.

• call_id: Une chaîne unique pour identifier l'appel.
• timestamp: La date et l'heure de génération du webhook, au format ISO 8601.
• status: Le statut de l'appel. Pour ce type de notification, il s'agit de in-progress.
• version: Un attribut de version qui pourra être utilisé à l'avenir pour migrer vers une autre version des webhooks. Actuellement, il s'agit toujours de v2.
• direction: Indique si un appel est entrant (inbound) ou sortant (outbound). Les appels entre collègues sont marqués comme outbound.
• caller: Informations concernant l'appelant.
• number: Le numéro de téléphone utilisé par l'appelant.
• name: Le nom de l'appelant.
• account_number: Le numéro interne du Compte VoIP (lorsque disponible, pour les appels entrants, il s'agit presque toujours de null).
• user_numbers: Les numéros internes des utilisateurs qui sont joignables (lorsque disponibles, peut être un tableau vide).
• user_emails: Les adresses e-mail des utilisateurs.
• destination: Informations concernant la direction de l'appel.
• number: Le numéro de téléphone composé par l'appelant.
• targets: Les téléphones qui sonnent pour cet appel. Les téléphones qui ne sont pas joignables ne sont pas affichés.
• number: Le numéro appelé. Il s'agit généralement du même numéro que destination.number, mais il peut changer si l'appel est transféré.
• name: Le nom de la personne appelée. Pour les appels entrants, il s'agit presque toujours de null.
• account_number: Les numéros internes des utilisateurs qui ont configuré leur Compte VoIP pour être joignables (lorsque disponibles, peut être un tableau vide).
• user_numbers: Les numéros internes des utilisateurs qui sont joignables (lorsque disponibles, peut être un tableau vide).
• user_emails: Les adresses e-mail des utilisateurs.

Transfert avec annonce

Une notification warm-transfer est envoyée lorsqu'un appel est transféré « avec annonce ». Dans un transfert avec annonce, le transféreur appelle d'abord le nouveau participant, celui-ci répond, s'entretient avec le transféreur, puis l'appel est transféré.

L'appel du transféreur vers le tiers génère également des notifications ringing et in-progress avec leur propre call_id. Lors d'un transfert, ces deux appels sont essentiellement fusionnés en un seul appel. Le call_id de l'un des deux appels est alors utilisé pour l'appel après le transfert. L'autre call_id est inclus dans le transfert en tant que merged_id et est ensuite abandonné.

• call_id: Une chaîne unique pour identifier l'appel, reprise de l'un des appels précédents.
• merged_id: Le call_id de l'autre appel précédent, qui ne sera plus utilisé.
• timestamp: La date et l'heure de génération du webhook, au format ISO 8601.
• status: Le statut de l'appel. Pour ce type de notification, il s'agit de transfer.
• version: Un attribut de version qui pourra être utilisé à l'avenir pour migrer vers une autre version des webhooks. Actuellement, il s'agit toujours de v2.
• direction: Indique si un appel est entrant (inbound) ou sortant (outbound). Les appels entre collègues sont marqués comme outbound.
• caller: Informations concernant l'appelant.
• number: Le numéro de téléphone utilisé par l'appelant.
• name: Le nom de l'appelant.
• account_number: Le numéro interne du Compte VoIP (lorsque disponible, pour les appels entrants, il s'agit presque toujours de null).
• user_numbers: Les numéros internes des utilisateurs qui sont joignables (lorsque disponibles, peut être un tableau vide).
• user_emails: Les adresses e-mail des utilisateurs.
• destination: Informations concernant la direction de l'appel.
• number: Le numéro de téléphone composé par l'appelant.
• targets: Les téléphones qui sonnent pour cet appel. Les téléphones qui ne sont pas joignables ne sont pas affichés.
• number: Le numéro appelé. Il s'agit généralement du même numéro que destination.number, mais il peut changer si l'appel est transféré.
• name: Le nom de la personne appelée. Pour les appels entrants, il s'agit presque toujours de null.
• account_number: Les numéros internes des utilisateurs qui ont configuré leur Compte VoIP pour être joignables (lorsque disponibles, peut être un tableau vide).
• user_numbers: Les numéros internes des utilisateurs qui sont joignables (lorsque disponibles, peut être un tableau vide).
• user_emails: Les adresses e-mail des utilisateurs.
• redirector: Informations concernant le participant qui a effectué le transfert.
• number: Le numéro de téléphone utilisé par le redirecteur.
• name: Le nom du redirecteur.
• account_number: Le numéro interne du Compte VoIP (lorsque disponible, pour les appels entrants, il s'agit presque toujours de null).
• user_numbers: Les numéros internes des utilisateurs qui sont joignables (lorsque disponibles, peut être un tableau vide).
• user_emails : Les adresses e-mail des utilisateurs.

Transfert à froid

Une notification cold-transfer est envoyée lorsqu'un appel est transféré à froid. Dans un transfert à froid, le transféreur appelle le nouveau participant mais transfère l'appel sans attendre de voir si quelqu'un répond ou qui répond.

Il existe deux différences principales entre un cold-transfer et un warm-transfer :

• Dans un transfert à chaud, il y a toujours une partie appelée, tandis que dans un transfert à froid, il peut y en avoir plusieurs (par exemple, si l'appel est transféré vers un groupe d'appel).
• Pour un transfert à chaud, des notifications ringing et in-progress sont d'abord générées. Dans un transfert à froid, seule une notification ringing est envoyée, et une notification in-progress ne suit que si le tiers répond à l'appel.

L'appel du transféreur vers le tiers génère également une notification ringing avec son propre call_id. Lors d'un transfert, ces deux appels sont essentiellement fusionnés en un seul appel. Le call_id de l'un des deux appels est ensuite utilisé pour l'appel après le transfert. L'autre call_id est inclus dans le transfert en tant que merged_id et est ensuite abandonné.

• call_id : Une chaîne unique pour identifier l'appel, reprise de l'un des appels précédents.
• merged_id : Le call_id de l'autre appel précédent, qui ne sera plus utilisé.
• timestamp : La date et l'heure de génération du webhook, au format ISO 8601.
• status : Le statut de l'appel. Pour ce type de notification, il s'agit de transfer.
• version : Un attribut de version qui pourrait être utilisé à l'avenir pour migrer vers une autre version des webhooks. Actuellement, il s'agit toujours de v2.
• direction : Indique si un appel est entrant ou sortant. Actuellement, seuls les appels entrants sont pris en charge, cette valeur est donc toujours inbound.
• caller : Informations sur l'appelant.
• number : Le numéro de téléphone utilisé par l'appelant.
• name : Le nom de l'appelant.
• account_number : Le numéro interne du Compte VoIP (lorsque disponible, pour les appels entrants, il s'agit presque toujours de null).
• user_numbers : Les numéros internes des utilisateurs qui sont joignables (lorsque disponible, peut être un tableau vide).
• user_emails : Les adresses e-mail des utilisateurs.
• destination : Informations sur la destination de l'appel.
• number : Le numéro de téléphone composé par l'appelant.
• targets : Les téléphones qui sonnent pour cet appel. Les téléphones qui ne sont pas joignables ne sont pas affichés.
• number : Le numéro appelé. Il s'agit généralement du même numéro que destination.number, mais il peut changer si l'appel est redirigé.
• name : Le nom de la personne appelée. Pour les appels entrants, il s'agit presque toujours de null.
• account_number : Les numéros internes des utilisateurs qui ont configuré leur Compte VoIP pour être joignables (lorsque disponible, peut être un tableau vide).
• user_numbers : Les numéros internes des utilisateurs qui sont joignables (lorsque disponible, peut être un tableau vide).
• user_emails : Les adresses e-mail des utilisateurs.
• redirector : Informations sur le participant qui a effectué le transfert.
• number : Le numéro de téléphone utilisé par le transféreur.
• name : Le nom du transféreur.
• account_number : Le numéro interne du Compte VoIP (lorsque disponible, pour les appels entrants, il s'agit presque toujours de null).
• user_numbers : Les numéros internes des utilisateurs qui sont joignables (lorsque disponible, peut être un tableau vide).
• user_emails : Les adresses e-mail des utilisateurs.

Fin d'appel (ended)

Une notification ended est envoyée lorsqu'un appel est terminé. Il existe plusieurs raisons pour lesquelles un appel peut se terminer.

Une notification ended peut être envoyée après une notification in-progress si l'appel a été raccroché par l'un des participants, après une notification ringing si personne n'a répondu, ou comme seule notification si aucun appareil n'était joignable.

• call_id : Une chaîne unique pour identifier l'appel.
• timestamp : La date et l'heure de génération du webhook, au format ISO 8601.
• status : Le statut de l'appel. Pour ce type de notification, il s'agit de ended.
• reason : La raison pour laquelle l'appel s'est terminé. La raison peut être l'une des valeurs suivantes :
1. completed : L'appel s'est terminé avec succès.
2. busy : L'appel a été rejeté, l'appelé était occupé.
3. no-answer : Personne n'a répondu à l'appel pour diverses raisons.
4. failed : Une erreur s'est produite empêchant l'établissement de l'appel.
5. cancelled : L'appelant a raccroché avant que quelqu'un ne puisse répondre.
6. abandon : L'appelant a raccroché en attendant dans la file d'attente.
• version : Un attribut de version qui pourrait être utilisé à l'avenir pour migrer vers une autre version des webhooks. Actuellement, il s'agit toujours de v2.
• direction : Indique si un appel est entrant (inbound) ou sortant (outbound). Les appels entre collègues sont marqués comme outbound.
• caller : Informations sur l'appelant.
• number : Le numéro de téléphone utilisé par l'appelant.
• name : Le nom de l'appelant.
• account_number : Le numéro interne du Compte VoIP (lorsqu'il est disponible, pour les appels entrants cette valeur est presque toujours null).
• user_numbers : Les numéros internes des utilisateurs qui sont joignables (lorsqu'ils sont disponibles, peut être un tableau vide).
• user_emails : Les adresses e-mail des utilisateurs.
• destination : Informations concernant la destination de l'appel.
• number : Le numéro de téléphone composé par l'appelant.

Transcription créée

Une notification call_transcription est envoyée lorsque la transcription est prête.

Si Voys Intelligence est activé. Il s'agit du premier événement qui suivra une notification ended. Si les résumés d'appels sont activés, l'événement summary suivra sous peu.

{            
  "call_id": "ua0-grq-prd-1780997460.58680",
  "call_transcription": "Speaker 1: Hi how are you.\nSpeaker 2: Hey great that you called.",        
}

Résumé créé

Une notification summary est envoyée lorsque le résumé de l'appel est prêt.

Si Voys Intelligence est activé. Il s'agit du dernier événement pour un appel spécifique.

{
  "call_id": "ua0-grq-prd-1780997460.58680", 
  "summary": "This was a great call."
}

Enregistrement d'appel créé

Un événement call recording created est envoyé dès qu'un enregistrement d'appel est disponible.

Le contenu de l'événement se présente comme suit :

{
"call_id": "ua0-grq-prd-1741083170.160935",
"recording_url": "https://api.voys.nl/api/v2/clients/9f515223-c139-4704-a031-57342c8809a4/callrecordings/ua0-grq-prd-1741083170.160935/audio"
}

Vous pouvez utiliser recording_url directement pour récupérer l'enregistrement avec votre clé API. Nul besoin de construire l'URL vous-même ou de rechercher votre ID client.

Plusieurs notifications sont envoyées pour chaque appel. Les notifications envoyées dépendent de la manière dont l'appel est traité. Ci-dessous figure l'ordre des notifications pour les types d'appels les plus courants.

Appel simple

Un appel réussi avec deux participants :

• ringing - A appelle B
• in-progress - A appelle B
• ended - A appelle B (raison : completed)

Appel simple avec Voys Intelligence activé

Un appel réussi avec deux participants :

• ringing - A appelle B
• in-progress - A appelle B
• ended - A appelle B (raison : completed)
• call_transcription - la transcription de l'appel est prête
• summary - le résumé de l'appel est prêt

Pas de réponse

Le téléphone de l'appelé sonne mais l'appel n'est pas décroché.

• ringing - A appelle B
• ended - A appelle B (raison : busy ou no-answer selon l'appareil)

Appelé non disponible

L'appelé n'est pas disponible (par exemple, le téléphone est en mode Ne pas déranger), le téléphone ne sonne donc pas et l'appel n'est pas décroché.

• ended - A appelle B (raison : busy)

Transfert avec annonce

Lors d'un transfert avec annonce (transfert accompagné), A appelle d'abord B, puis l'un des participants transfère l'appel vers C. Le participant appelle d'abord C, et après avoir échangé avec lui, l'appel est transféré. Seuls les participants A et C restent dans l'appel.

• ringing - A appelle B
• in-progress - A appelle B
• ringing - B appelle C
• in-progress - B appelle C
• warm-transfer - B met en relation A et C
• ended - A et C raccrochent (raison : completed)
• call_transcription - la transcription de l'appel est prête (une par segment d'appel, si activée)
• summary - le résumé de l'appel est prêt (un par segment d'appel, si activé)

Transfert direct

Lors d'un transfert direct (transfert non accompagné), A appelle d'abord B, puis l'un des participants transfère l'appel vers C sans attendre de vérifier si C est disponible.

• ringing - A appelle B
• en cours - A appelle B
• sonnerie - B appelle C
• transfert direct - B connecte A et C
• en cours - A appelle C
• terminé - A n'appelle plus C (raison : completed)
• call_transcription - la transcription de l'appel est prête
• summary - le résumé de l'appel est prêt

Transfert semi-assisté

Dans un transfert semi-assisté (transfert tiède), A appelle d'abord B, puis l'un des participants transfère l'appel vers C. Le participant essaie d'abord d'appeler C mais transfère l'appel avant que C ne réponde.

• sonnerie - A appelle B
• en cours - A appelle B
• sonnerie - B appelle C
• transfert direct - B connecte A et C
• en cours - A appelle C
• terminé - A n'appelle plus C (raison : completed)
• call_transcription - la transcription de l'appel est prête
• summary - le résumé de l'appel est prêt

Prise d'appel

Lorsque deux téléphones se trouvent dans le même groupe de prise d'appels, il est possible de prendre un appel destiné à un autre téléphone depuis l'un d'eux.

• sonnerie - A appelle B
• en cours - A appelle C
• terminé - A n'appelle plus C (raison : completed)
• call_transcription - la transcription de l'appel est prête
• summary - le résumé de l'appel est prêt

Redirection d'appel

Lorsqu'un utilisateur configure son téléphone pour rediriger automatiquement les appels entrants vers un autre numéro.

• sonnerie - A appelle B
• sonnerie - A appelle B et C
• en cours ou terminé, selon que quelqu'un réponde ou non.
• call_transcription - la transcription de l'appel est prête
• summary - le résumé de l'appel est prêt