Telephony

The Vonage Business Telephony API enables you to manage calls and retrieve device registration information.

Télécharger la spécification OpenAPI
Opérations disponibles

Get list of active calls for a given account (paginated). Please use Reports API to get list of completed calls.

gethttps://api.vonage.com/t/vbc.prod/telephony/v3/cc/accounts/:account_id/calls

Authentification

CléDescriptionOùExemple
Authorization

Votre jeton OAuth.
En savoir plus sur les jetons OAuth

Headers

Bearer <access_token>

Demande de renseignements Paramètres

extension
string
exemple1234
page_size
string
Défaut100
exemple100

Return max this amount of calls in the response.

order
string
exempleasc

Either ascending or descending order.
Must be one of asc or desc.

start_time
string
exemple1595955770

Return the calls that occurred after this point in time.
Should be of type epoch with seconds precision.

end_time
integer
exemple1595955770

Return the calls that occurred before this point in time.
Should be of type epoch with seconds precision.

Trajectoire Paramètres

account_id
string
Exigée
exemple1234

Réponses
Type de contenu

200 response

calls
array
account_id
string
exemple1234
call_id
string
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6
direction
string
exempleinbound
Il doit s'agir de l'un d'entre eux :inboundoutbound
end_time
string(date-time)
exemple1595959736
from
string
exemple1235551111
legs
array
account_id
string
exemple1234

Account that this call leg belongs to

call_id
string(uuid)
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Call Id this call belongs to

direction
string
exempleinbound

Leg direction - either "inbound" or "outbound"

Il doit s'agir de l'un d'entre eux :inboundoutbound
end_time
string(date-time)
exemple1595959736

Call end time (if applicable)

from
string
exemple1231112222

The "from" DID or extension

leg_id
string(uuid)
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Globally unique leg Id

start_time
string(date-time)
exemple1595959736

Call start time

status
string
exemplebusy

current leg status

Il doit s'agir de l'un d'entre eux :busyfailedunansweredringingon-call
to
string
exemple1234567890

The "to" DID or extension

start_time
string(date-time)
exemple1595959736
status
string
exemplebusy
Il doit s'agir de l'un d'entre eux :busyfailedunansweredringingon-call
to
string
exemple1234567890
current_page
string
first_page_uri
string
exemple/cc/accounts/1234/calls?page_size=0&order=desc
next_page
string
exemple1
next_page_uri
string
exemple/cc/accounts/1234/calls?page_size=0&order=desc
order
string
exempledesc
page_size
string
exemple1
pages
string
exemple1
previous_page_uri
string
exemple/cc/accounts/1234/calls?page_size=0&order=desc

Exemple Réponse

{
   "calls": [
      {
         "account_id": 1234,
         "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "direction": "inbound",
         "end_time": 1595959736,
         "from": 1235551111,
         "legs": [
            {
               "account_id": 1234,
               "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
               "direction": "inbound",
               "end_time": 1595959736,
               "from": 1231112222,
               "leg_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
               "start_time": 1595959736,
               "status": "busy",
               "to": 1234567890
            }
         ],
         "start_time": 1595959736,
         "status": "busy",
         "to": 1234567890
      }
   ],
   "current_page": 0,
   "first_page_uri": "/cc/accounts/1234/calls?page_size=0&order=desc",
   "next_page": 1,
   "next_page_uri": "/cc/accounts/1234/calls?page_size=0&order=desc",
   "order": "desc",
   "page_size": 1,
   "pages": 1,
   "previous_page_uri": "/cc/accounts/1234/calls?page_size=0&order=desc"
}

Create a new call

posthttps://api.vonage.com/t/vbc.prod/telephony/v3/cc/accounts/:account_id/calls

Authentification

CléDescriptionOùExemple
Authorization

Votre jeton OAuth.
En savoir plus sur les jetons OAuth

Headers

Bearer <access_token>

Trajectoire Paramètres

account_id
string
Exigée
exemple1234

Corps de la demande
Type de contenu
application/json

from
object
destination
string
exemple1234
type
string
exempleextension
Il doit s'agir de l'un d'entre eux :deviceextensionfeature_code
to
object
destination
string
exemple1234567890
type
string
exemplepstn
Il doit s'agir de l'un d'entre eux :deviceextensionpstnfeature_code
type
string
exempleclick2dial
Il doit s'agir de l'un d'entre eux :click2dialclick2dialmeodrdefault

Exemple Demande

{
   "from": {
      "destination": 1234,
      "type": "extension"
   },
   "to": {
      "destination": 1234567890,
      "type": "pstn"
   },
   "type": "click2dial"
}

Réponses
Type de contenu

200 response

Exemple Réponse

L'exemple de prévisualisation n'est actuellement pas pris en charge pour le type de contenu : text/plain

Get details for a specific active call.

gethttps://api.vonage.com/t/vbc.prod/telephony/v3/cc/accounts/:account_id/calls/:call_id

Authentification

CléDescriptionOùExemple
Authorization

Votre jeton OAuth.
En savoir plus sur les jetons OAuth

Headers

Bearer <access_token>

Trajectoire Paramètres

account_id
string
Exigée
exemple1234
call_id
string
Exigée
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Réponses
Type de contenu

200 response

account_id
string
exemple1234
call_id
string
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6
direction
string
exempleinbound
Il doit s'agir de l'un d'entre eux :inboundoutbound
end_time
string(date-time)
exemple1595959736
from
string
exemple1235551111
legs
array
account_id
string
exemple1234

Account that this call leg belongs to

call_id
string(uuid)
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Call Id this call belongs to

direction
string
exempleinbound

Leg direction - either "inbound" or "outbound"

Il doit s'agir de l'un d'entre eux :inboundoutbound
end_time
string(date-time)
exemple1595959736

Call end time (if applicable)

from
string
exemple1231112222

The "from" DID or extension

leg_id
string(uuid)
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Globally unique leg Id

start_time
string(date-time)
exemple1595959736

Call start time

status
string
exemplebusy

current leg status

Il doit s'agir de l'un d'entre eux :busyfailedunansweredringingon-call
to
string
exemple1234567890

The "to" DID or extension

start_time
string(date-time)
exemple1595959736
status
string
exemplebusy
Il doit s'agir de l'un d'entre eux :busyfailedunansweredringingon-call
to
string
exemple1234567890

Exemple Réponse

{
   "account_id": 1234,
   "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
   "direction": "inbound",
   "end_time": 1595959736,
   "from": 1235551111,
   "legs": [
      {
         "account_id": 1234,
         "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "direction": "inbound",
         "end_time": 1595959736,
         "from": 1231112222,
         "leg_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
         "start_time": 1595959736,
         "status": "busy",
         "to": 1234567890
      }
   ],
   "start_time": 1595959736,
   "status": "busy",
   "to": 1234567890
}

Update an existing call

puthttps://api.vonage.com/t/vbc.prod/telephony/v3/cc/accounts/:account_id/calls/:call_id

Authentification

CléDescriptionOùExemple
Authorization

Votre jeton OAuth.
En savoir plus sur les jetons OAuth

Headers

Bearer <access_token>

Trajectoire Paramètres

account_id
string
Exigée
exemple12345
call_id
string
Exigée
exemplec91150a6-8cc4-4e73-9fef-17fd925c6448

Corps de la demande
Type de contenu
application/json

from
object
destination
string
exemple1234567890
type
string
exemplepstn
Il doit s'agir de l'un d'entre eux :deviceextensionpstn
state
string
Il doit s'agir de l'un d'entre eux :activeparked
to
object
destination
string
exemple1234567890
type
string
exemplepstn
Il doit s'agir de l'un d'entre eux :deviceextensionpstn

Exemple Demande

{
   "from": {
      "destination": 1234567890,
      "type": "pstn"
   },
   "state": "active",
   "to": {
      "destination": 1234567890,
      "type": "pstn"
   }
}

Réponses
Type de contenu
application/json

200 response

account_id
string(integer)
exemple1234
call_id
string(uuid)
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6
call_state
string
destination
string

Exemple Réponse

{
   "account_id": 1234,
   "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
   "call_state": "string",
   "destination": "string"
}

Delete a call resource

deletehttps://api.vonage.com/t/vbc.prod/telephony/v3/cc/accounts/:account_id/calls/:call_id

Authentification

CléDescriptionOùExemple
Authorization

Votre jeton OAuth.
En savoir plus sur les jetons OAuth

Headers

Bearer <access_token>

Trajectoire Paramètres

account_id
string
Exigée
exemple1234
call_id
string
Exigée
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Réponses
Type de contenu

200 response

account_id
string(integer)
exemple1234
call_id
string(uuid)
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6
call_state
string
destination
string

Exemple Réponse

{
   "account_id": 1234,
   "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
   "call_state": "string",
   "destination": "string"
}

Get list of legs for a given active call

gethttps://api.vonage.com/t/vbc.prod/telephony/v3/cc/accounts/:account_id/calls/:call_id/legs

Authentification

CléDescriptionOùExemple
Authorization

Votre jeton OAuth.
En savoir plus sur les jetons OAuth

Headers

Bearer <access_token>

Trajectoire Paramètres

account_id
string
Exigée
exemple1234
call_id
string
Exigée
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Réponses
Type de contenu

200 response

array
account_id
string
exemple1234

Account that this call leg belongs to

call_id
string(uuid)
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Call Id this call belongs to

direction
string
exempleinbound

Leg direction - either "inbound" or "outbound"

Il doit s'agir de l'un d'entre eux :inboundoutbound
end_time
string(date-time)
exemple1595959736

Call end time (if applicable)

from
string
exemple1231112222

The "from" DID or extension

leg_id
string(uuid)
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Globally unique leg Id

start_time
string(date-time)
exemple1595959736

Call start time

status
string
exemplebusy

current leg status

Il doit s'agir de l'un d'entre eux :busyfailedunansweredringingon-call
to
string
exemple1234567890

The "to" DID or extension

Exemple Réponse

[
   {
      "account_id": 1234,
      "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "direction": "inbound",
      "end_time": 1595959736,
      "from": 1231112222,
      "leg_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "start_time": 1595959736,
      "status": "busy",
      "to": 1234567890
   }
]

Get details for a specific active call leg

gethttps://api.vonage.com/t/vbc.prod/telephony/v3/cc/accounts/:account_id/calls/:call_id/legs/:leg_id

Authentification

CléDescriptionOùExemple
Authorization

Votre jeton OAuth.
En savoir plus sur les jetons OAuth

Headers

Bearer <access_token>

Trajectoire Paramètres

leg_id
string
Exigée
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6
account_id
string
Exigée
exemple1234
call_id
string
Exigée
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Réponses
Type de contenu

200 response

account_id
string
exemple1234

Account that this call leg belongs to

call_id
string(uuid)
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Call Id this call belongs to

direction
string
exempleinbound

Leg direction - either "inbound" or "outbound"

Il doit s'agir de l'un d'entre eux :inboundoutbound
end_time
string(date-time)
exemple1595959736

Call end time (if applicable)

from
string
exemple1231112222

The "from" DID or extension

leg_id
string(uuid)
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Globally unique leg Id

start_time
string(date-time)
exemple1595959736

Call start time

status
string
exemplebusy

current leg status

Il doit s'agir de l'un d'entre eux :busyfailedunansweredringingon-call
to
string
exemple1234567890

The "to" DID or extension

Exemple Réponse

{
   "account_id": 1234,
   "call_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
   "direction": "inbound",
   "end_time": 1595959736,
   "from": 1231112222,
   "leg_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
   "start_time": 1595959736,
   "status": "busy",
   "to": 1234567890
}

Modify a call leg.

puthttps://api.vonage.com/t/vbc.prod/telephony/v3/cc/accounts/:account_id/calls/:call_id/legs/:leg_id

Authentification

CléDescriptionOùExemple
Authorization

Votre jeton OAuth.
En savoir plus sur les jetons OAuth

Headers

Bearer <access_token>

Trajectoire Paramètres

account_id
string
Exigée
exemple1234
call_id
string
Exigée
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6
leg_id
string
Exigée
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Corps de la demande
Type de contenu
application/json

L'un des
L'un des
state
string
exempleheld

Exemple Demande

{
   "state": "held"
}

Réponses
Type de contenu
application/json

200 response

account_id
string(integer)
exemple1234
call_id
string(uuid)
call_state
string
destination
string
leg_id
string(uuid)
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Exemple Réponse

{
   "account_id": 1234,
   "call_id": "0d0a16ab-a508-4d58-bf24-5dc3cb248f3e",
   "call_state": "string",
   "destination": "string",
   "leg_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Delete a call leg.

deletehttps://api.vonage.com/t/vbc.prod/telephony/v3/cc/accounts/:account_id/calls/:call_id/legs/:leg_id

Authentification

CléDescriptionOùExemple
Authorization

Votre jeton OAuth.
En savoir plus sur les jetons OAuth

Headers

Bearer <access_token>

Trajectoire Paramètres

account_id
string
Exigée
exemple1234
call_id
string
Exigée
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6
leg_id
string
Exigée
exemple3fa85f64-5717-4562-b3fc-2c963f66afa6

Réponses
Type de contenu

204 response

Get account device's registration info

gethttps://api.vonage.com/t/vbc.prod/telephony/v3/registration/accounts/:account_id/devices

Authentification

CléDescriptionOùExemple
Authorization

Votre jeton OAuth.
En savoir plus sur les jetons OAuth

Headers

Bearer <access_token>

Demande de renseignements Paramètres

page_size
string
Défaut100
exemple10

Return max this number of devices in the response.

order
string
exempleasc

Either ascending or descending order.
Must be one of asc or desc.

start_time
string
exemple1595955770

Return the devices that were registered after this point in time.
Should be of type epoch with seconds precision.

end_time
integer
exemple1595955770

Return the devices that were registered before this point in time.
Should be of type epoch with seconds precision.

Trajectoire Paramètres

account_id
string
Exigée
exemple1234

Réponses
Type de contenu

200 response

current_page
string
exemple1
devices
array
account_id
string
exemple1234
device_ip
string
exemple150.24.83.17
last_request
string
exemple1595937421
last_success
string
exemple1595937421
mac_address
string
exemple79-5C-7D-28-1B-B3
registration
object
last_success
string
exemple1595937421
provisioned
object
last_success
string
exemple1595937421
last_request
string
exemple1595937421
first_page_uri
string
exemple/registration/accounts/1234/devices?page_size=100&order=desc
next_page
string
next_page_uri
string
exemple/registration/accounts/1234/devices?page_size=100&order=desc
order
string
exempledesc
page_size
string
exemple10
pages
string
exemple2
previous_page_uri
string
exemple/registration/accounts/1234/devices?page_size=100&order=desc

Exemple Réponse

{
   "current_page": 1,
   "devices": [
      {
         "account_id": 1234,
         "device_ip": "150.24.83.17",
         "last_request": 1595937421,
         "last_success": 1595937421,
         "mac_address": "79-5C-7D-28-1B-B3",
         "registration": {
            "last_success": 1595937421
         },
         "provisioned": {
            "last_success": 1595937421,
            "last_request": 1595937421
         }
      }
   ],
   "first_page_uri": "/registration/accounts/1234/devices?page_size=100&order=desc",
   "next_page": "string",
   "next_page_uri": "/registration/accounts/1234/devices?page_size=100&order=desc",
   "order": "desc",
   "page_size": 10,
   "pages": 2,
   "previous_page_uri": "/registration/accounts/1234/devices?page_size=100&order=desc"
}

Get device registration info

gethttps://api.vonage.com/t/vbc.prod/telephony/v3/registration/accounts/:account_id/devices/:device_id

Authentification

CléDescriptionOùExemple
Authorization

Votre jeton OAuth.
En savoir plus sur les jetons OAuth

Headers

Bearer <access_token>

Trajectoire Paramètres

account_id
string
Exigée
exemple1234
device_id
string
Exigée
exemple38-99-62-93-E2-A9

Mac address of device

Réponses
Type de contenu

200 response

account_id
string
exemple1234
device_ip
string
exemple150.24.83.17
last_request
string
exemple1595937421
last_success
string
exemple1595937421
mac_address
string
exemple79-5C-7D-28-1B-B3
registration
object
last_success
string
exemple1595937421
provisioned
object
last_success
string
exemple1595937421
last_request
string
exemple1595937421

Exemple Réponse

{
   "account_id": 1234,
   "device_ip": "150.24.83.17",
   "last_request": 1595937421,
   "last_success": 1595937421,
   "mac_address": "79-5C-7D-28-1B-B3",
   "registration": {
      "last_success": 1595937421
   },
   "provisioned": {
      "last_success": 1595937421,
      "last_request": 1595937421
   }
}