Notifications d'appel

Que sont les Notifications d'appel ?

Le module Notifications d'appel vous permet d'envoyer automatiquement des données d'appel vers une URL de votre choix. Ces notifications d'appel sont envoyées à l'URL spécifiée pour tous les appels au sein de votre environnement de portail.

Lorsque vous intégrez ces notifications d'appel à votre logiciel CRM, vous pouvez voir qui a appelé, l'heure de l'appel et sa durée.

Les notifications d'appel sont déclenchées pour les appels entrants, internes et sortants. Vous pouvez également utiliser les notifications d'appel à d'autres fins, comme mesurer les statistiques d'appel.

N'hésitez pas à consulter Webhooks pour maximiser les capacités de votre service téléphonique.

‣

Les déclencheurs de notification d'appel

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 durant 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 lire précisément 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 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 created.
version : Un attribut de version qui pourra ê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 utilisé par l'appelant.
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 composé par l'appelant.

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 à mesure que de nouveaux appareils commencent à sonner.

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 ringing.
version : Un attribut de version qui pourra ê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 utilisé par l'appelant.
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 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 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 peut arriver 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 est toujours défini sur 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 disponible, 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.
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.

Transfert accompagné

Une notification warm-transfer est envoyée lorsqu'un appel est transféré de manière « accompagnée ». Dans un transfert accompagné, 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 est toujours défini sur 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 disponible, 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.
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 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 disponible, peut être un tableau vide).
user_emails : Les adresses e-mail des utilisateurs.

Transfert direct

Une notification cold-transfer est envoyée lorsqu'un appel est transféré de manière directe. Dans un transfert direct, 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 clés entre un cold-transfer et un warm-transfer :

Dans un transfert accompagné, il y a toujours un destinataire appelé, tandis que dans un transfert direct il peut y en avoir plusieurs (par exemple, si l'appel est transféré vers un Groupe d'appel).
Pour un transfert accompagné, des notifications ringing et in-progress sont d'abord générées. Dans un transfert direct, seule une notification ringing est envoyée, et une notification in-progress suit uniquement 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 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 supprimé.

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 est toujours 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 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 (lorsqu'il est disponible, pour les appels entrants, il s'agit presque toujours de 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 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 non 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 (lorsqu'ils sont disponibles, peut être un tableau vide).
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.

redirector : Informations concernant 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 (lorsqu'il est disponible, pour les appels entrants, il s'agit presque toujours de 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.

Raccrocher (terminé)

Une notification ended est envoyée lorsqu'un appel est terminé. Plusieurs raisons peuvent expliquer la fin d'un appel.

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 en tant que 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 :

completed: The call was successfully completed.
busy: The call was rejected, the callee was busy.
no-answer: No one answered the call for various reasons.
failed: An error occurred preventing the call from being established.
cancelled: The caller hung up before anyone could answer.
abandon: The caller hung up while waiting in the queue.

version : Un attribut de version qui pourra ê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 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 (lorsqu'il est disponible, pour les appels entrants, il s'agit presque toujours de 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 direction de l'appel.

number : Le numéro de téléphone composé par l'appelant.

‣

Ordre des notifications

Plusieurs notifications sont envoyées pour chaque appel. Les notifications envoyées dépendent de la façon dont l'appel est traité. Voici 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)

Pas de réponse

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

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

Appelé indisponible

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

ended - A appelle B (raison : busy)

Transfert accompagné

Lors d'un transfert accompagné (transfert avec annonce), A appelle d'abord B, puis l'un des participants transfère l'appel à C. Le participant appelle d'abord C et, après avoir échangé, 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 connecte A et C
ended - A et C raccrochent (raison : completed)

Transfert direct

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

ringing - A appelle B
in-progress - A appelle B
ringing - B appelle C
cold-transfer - B connecte A et C
in-progress - A appelle C
ended - A n'appelle plus C (raison : completed)

Transfert semi-accompagné

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

ringing - A appelle B
in-progress - A appelle B
ringing - B appelle C
cold-transfer - B connecte A et C
in-progress - A appelle C
ended - A n'appelle plus C (raison : completed)

Prise d'appel

Lorsque deux téléphones sont 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.

ringing - A appelle B
in-progress - A appelle C
ended - A n'appelle plus C (raison : completed)

Redirection d'appel

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

ringing - A appelle B
ringing - A appelle B & C
in-progress ou ended, selon que quelqu'un répond ou non.

‣

Configuration des Notifications d'appel

‣

Exemples d'intégrations

FAQ

‣

Quelle est la différence entre les notifications d'appel et les webhooks ?

‣

Pour quels appels les notifications d'appel peuvent-elles être utilisées ?

‣

Quel format de données est envoyé ?

‣

Quelle méthode de requête HTTP dois-je utiliser ?

Pages associées

Voys Intelligence

Obtenir automatiquement les transcriptions d'appels avec N8N

Statistiques

Statistiques de file d'attente

Webhooks

Notifications d'appel

Que sont les Notifications d'appel ?

Lorsque vous intégrez ces notifications d'appel à votre logiciel CRM, vous pouvez voir qui a appelé, l'heure de l'appel et sa durée.

N'hésitez pas à consulter Webhooks pour maximiser les capacités de votre service téléphonique.

‣

Les déclencheurs de notification d'appel

Créé

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

{
  "call_id": "ua9-grq-prd-1693575683.22973164",
  "timestamp": "2023-09-01T13:41:25.972110+00:00",
  "status": "created",
  "version": "v2",
  "direction": "inbound",
  "caller": {
    "number": "+31507009920",
    "name": "Johan",
    "account_number": null,
    "user_numbers": [],
    "user_emails": []
  },
  "destination": {
    "number": "+31332022074"
  }
}

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 created.
version : Un attribut de version qui pourra ê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 utilisé par l'appelant.
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 composé par l'appelant.

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 à mesure que de nouveaux appareils commencent à sonner.

{
  "call_id": "ua9-grq-prd-1693575683.22973164",
  "timestamp": "2023-09-01T13:41:26.020742+00:00",
  "status": "ringing",
  "version": "v2",
  "direction": "inbound",
  "caller": {
    "number": "+31507009920",
    "name": "Johan",
    "account_number": null,
    "user_numbers": [],
    "user_emails": []
  },
  "destination": {
    "number": "+31332022074",
    "targets": [
      {
        "number": "+31332022074",
        "name": null,
        "account_number": "201",
        "user_numbers": [
          "610"
        ],
        "user_emails": [
          "email@email.com"
        ]
      }
    ]
  }
}

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 ringing.
version : Un attribut de version qui pourra ê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 utilisé par l'appelant.
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 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 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.

{
  "call_id": "ua9-grq-prd-1693575683.22973164",
  "timestamp": "2023-09-01T13:41:26.992074+00:00",
  "status": "in-progress",
  "version": "v2",
  "direction": "inbound",
  "caller": {
    "number": "+31507009920",
    "name": "Johan",
    "account_number": null,
    "user_numbers": [],
    "user_emails": []
  },
  "destination": {
    "number": "+31332022074",
    "target": {
      "number": "+31332022074",
      "name": null,
      "account_number": "201",
      "user_numbers": [
        "610"
      ],
      "user_emails": [
        "email@email.com"
      ]
    }
  }
}

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 est toujours défini sur 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 disponible, 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.
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.

Transfert accompagné

{
  "call_id": "ua7-ams-prd-1693576700.23986757",
  "merged_id": "ua7-ams-prd-1693576711.23987220",
  "timestamp": "2023-09-01T13:58:44.399054+00:00",
  "status": "warm-transfer",
  "version": "v2",
  "direction": "inbound",
  "caller": {
    "number": "+31507009920",
    "name": "Johan N",
    "account_number": null,
    "user_numbers": [],
    "user_emails": []
  },
  "destination": {
    "number": "629",
    "target": {
      "number": "629",
      "name": null,
      "account_number": "203",
      "user_numbers": [
        "629"
      ],
      "user_emails": [
        "email2@email.com"
      ]
    }
  },
  "redirector": {
    "number": "610",
    "name": "Johan N",
    "account_number": "201",
    "user_numbers": [
      "610"
    ],
    "user_emails": [
      "email@email.com"
    ]
  }
}

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 est toujours défini sur 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 disponible, 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.
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 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 disponible, peut être un tableau vide).
user_emails : Les adresses e-mail des utilisateurs.

Transfert direct

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

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

{
  "call_id": "ua4-grq-prd-1693576927.25584586",
  "merged_id": "ua4-grq-prd-1693576937.25585499",
  "timestamp": "2023-09-01T14:02:17.054643+00:00",
  "status": "cold-transfer",
  "version": "v2",
  "direction": "inbound",
  "caller": {
    "number": "+31507009920",
    "name": "Johan N",
    "account_number": null,
    "user_numbers": [],
    "user_emails": []
  },
  "destination": {
    "number": "629",
    "targets": [
      {
        "number": "629",
        "name": null,
        "account_number": "203",
        "user_numbers": [
          "629"
        ],
        "user_emails": [
          "email2@email.com"
        ]
      }
    ]
  },
  "redirector": {
    "number": "+31332022074",
    "name": null,
    "account_number": "201",
    "user_numbers": [
      "610"
    ],
    "user_emails": [
      "email@email.com"
    ]
  }
}

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 est toujours 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 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 (lorsqu'il est disponible, pour les appels entrants, il s'agit presque toujours de 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 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 non 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 (lorsqu'ils sont disponibles, peut être un tableau vide).
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.

redirector : Informations concernant 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 (lorsqu'il est disponible, pour les appels entrants, il s'agit presque toujours de 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.

Raccrocher (terminé)

Une notification ended est envoyée lorsqu'un appel est terminé. Plusieurs raisons peuvent expliquer la fin d'un appel.

{
  "call_id": "ua4-ams-prd-1766999450.29340564",
  "timestamp": "2025-12-29T09:11:55.875026+00:00",
  "status": "ended",
  "reason": "completed",
  "version": "v2",
  "direction": "inbound",
  "caller": {
    "number": "+31507009920",
    "name": "Johan | Voys",
    "account_number": null,
    "user_numbers": [],
    "user_emails": []
  },
  "destination": {
    "number": "+31332022074",
    "target": {
      "number": "+31332022074",
      "name": null,
      "account_number": "101",
      "user_numbers": [],
      "user_emails": []
    }
  }
}

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 :

completed: The call was successfully completed.
busy: The call was rejected, the callee was busy.
no-answer: No one answered the call for various reasons.
failed: An error occurred preventing the call from being established.
cancelled: The caller hung up before anyone could answer.
abandon: The caller hung up while waiting in the queue.

version : Un attribut de version qui pourra ê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 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 (lorsqu'il est disponible, pour les appels entrants, il s'agit presque toujours de 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 direction de l'appel.

number : Le numéro de téléphone composé par l'appelant.

‣

Ordre des notifications

Appel simple

Un appel réussi avec deux participants :

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

Pas de réponse

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

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

Appelé indisponible

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

ended - A appelle B (raison : busy)

Transfert accompagné

ringing - A appelle B
in-progress - A appelle B
ringing - B appelle C
in-progress - B appelle C
warm-transfer - B connecte A et C
ended - A et C raccrochent (raison : completed)

Transfert direct

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

ringing - A appelle B
in-progress - A appelle B
ringing - B appelle C
cold-transfer - B connecte A et C
in-progress - A appelle C
ended - A n'appelle plus C (raison : completed)

Transfert semi-accompagné

ringing - A appelle B
in-progress - A appelle B
ringing - B appelle C
cold-transfer - B connecte A et C
in-progress - A appelle C
ended - A n'appelle plus C (raison : completed)

Prise d'appel

Lorsque deux téléphones sont 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.