Comment utiliser nos webhooks

Depuis votre dashboard Ringover https://dashboard.ringover.com/developer, vous pouvez renseigner des URL vous permettant de récupérer des informations que nous envoyons via des webhooks.

Nos webhooks vous permettent de déclencher des actions lors d'évènements Ringover (appels entrants, appels manqués, message répondeur, etc...)

Nous envoyons des requêtes POST au format JSON suivant :

Pour les appels qui sonnent :
{
"resource": "call",
"event": "ringing",
"timestamp": 1553605685,
"data": {
"id": "e61d54a9-973a-415e-9b38-7497d4021132",
"call_id": "15937972205296322620",
"start_time": 1553605685,
"direction": "inbound",
"from_number": "33184804007",
"to_number": "33970703301",
"is_internal": false,
"is_anonymous": false,
"is_ivr": false,
"user_id": "USER17667",
"status": "ringing"
},
"attempt": 0
}

Pour les appels raccrochés:
​{
"resource": "call",
"event": "hangup",
"timestamp": 1553601565,
"data": {
"id": "bb9437e1-c62b-4995-8919-11191e7edbfe",
"call_id": "3521735684772696995",
"start_time": 1553601559,
"direction": "outbound",
"from_number": "33970703301",
"to_number": "33184804007",
"is_internal": false,
"is_anonymous": false,
"is_ivr": false,
"user_id": "USER17667",
"status": "hangup",
"duration_in_seconds": 0,
"hangup_time": 1553601563,
"record": null
},
"attempt": 0
}


Pour les appels décrochés :
​{
"resource": "call",
"event": "answered",
"timestamp": 1553685903,
"data": {
"id": "83018bc2-a79b-4b9e-8ba8-d5dca6279f20",
"call_id": "2138692080094433177",
"start_time": 1553685896,
"direction": "outbound",
"from_number": "33970703301",
"to_number": "33184600690",
"is_internal": false,
"is_anonymous": false,
"is_ivr": false,
"user_id": "USER17667",
"status": "answered"
},
"attempt": 0
}

Pour les appels manqués :
​{
"resource": "call",
"event": "missed",
"timestamp": 1553687694,
"data": {
"id": "b5c9351f-481a-4521-9115-51b57034d026",
"call_id": "12769542669440355678",
"start_time": 1553687692,
"direction": "outbound",
"from_number": "33374472853",
"to_number": "33970703301",
"is_internal": true,
"is_anonymous": false,
"is_ivr": false,
"user_id": "USER21091",
"reason": "UNKNOWN",
"status": "missed",
"hangup_time": 1553687692
},
"attempt": 0
}

​Pour les voicemails :
{
"resource": "call",
"event": "voicemail",
"timestamp": 1553693015,
"data": {
"id": "2b7d6939-0e1c-47ec-b535-7c9de4841674",
"call_id": "8782705901990928605",
"start_time": 1553692941,
"direction": "inbound",
"from_number": "33184804007",
"to_number": "33970703301",
"is_internal": false,
"is_anonymous": false,
"is_ivr": false,
"user_id": "USER17667",
"reason": "UNKNOWN",
"status": "missed",
"hangup_time": 1553693013,
"message": "https://cdn77.ringover.com/messages/4647-7667/d2c37db3-afe7-46e9-bd86-2add5005a165-27-03-19-14h23-33184804007-33970703301.mp3"
},
"attempt": 0
}

Articles connexes

Prêt à téléphoner plus simplement ?

Contacter un conseiller Inscription