Nous avons mis en place un service vous permettant de recevoir les évènements des appels des utilisateurs.
Pour recevoir la notification des appels vous devrez :
- Configurez le webhook dans le formulaire utilisateur
- L'utilisateur doit être en mesure d'émettre et de recevoir des appels
Vous recevrez des évènements formatés de la façon suivante :
{
"type": "call_event",
"data": {
"answer_at": null,
"call_at": "2022-04-21T10:04:27.000Z",
"called_number": "4680",
"called_object_id": 6,
"called_object_type": "user",
"called_user_id": 6,
"caller_number": "+33183900909",
"caller_user_id": null,
"cti_context": [],
"id": 2548,
"original_called_number": "+33183909988",
"original_called_object_id": 6,
"original_called_object_type": "user",
"originate_action_id": null,
"state": "ringing",
"user_id": 6,
"xfer_call_id": null
}
}
Les numéros peuvent être des numéros internes ou des numéros au format E164.
- state contient l'état de l'appel. Les états possibles sont les suivants : ringing, answered, hold et completed
- id contient l'identifiant de l'appel
- caller_user_id contient l'id de l'appelant lorsque c'est un utilisateur ubefone
- called_user_id contient l'id de l'appelé lorsque c'est un utilisateur ubefone
- user_id contient l'identifiant de l'utilisateur concerné par cet évènement
Lorsqu'on configure un même webhook pour deux utilisateurs, un appel interne entre ces deux utilisateurs va générer un flux d'évènement pour chaque user_id.
Vous pouvez recevoir plusieurs fois le même évènement pour le même appel. Par exemple si un utilisateur a plusieurs téléphones, vous pouvez recevoir un ringing par téléphone.
Vous pouvez tester ici par exemple : https://webhook.site