Introdução

Neste tutorial, você aprenderá a criar um webhook para receber eventos de chamadas. O uso de webhooks permitirá que você crie Applications exclusivas de chamadas em tempo real para desenvolver produtos que seus usuários vão adorar.

Quando uma chamada é feita ou recebida, a API de webhooks permite que você monitore as chamadas ativas. O webhook retornará as seguintes informações:

{
  "event": {
  "accountId": "{YOUR_ACCOUNT_ID}",
  "callerId": "{NOME_DO_CHAMADOR}",
  "direction": "{DIREÇÃO}",
  "duration": {DURAÇÃO DA CHAMADA},
  "externalId": "{ID}",
  "id": "{ID}",
  "internal": {INTERNAL_FLAG},
  "phoneNumber": "{NÚMERO_DE_TELEFONE}",
  "startTime": "HORA_IOS8601",
  "state": "{ESTADO DA CHAMADA}",
  "type": "{TIPO DE CHAMADA}",
  "ucpType": "",
  "userId": "{ID DO USUÁRIO"
  }
 }

Quando o status da chamada mudar, uma nova carga será enviada ao webhook:

• Quando a chamada começar, você receberá uma carga com o state como RINGING.
• Quando a chamada for atendida, você receberá uma carga com o state como ACTIVE.
• Quando a chamada terminar, você receberá uma carga útil com o state definido como ANSWERED.
• Se a chamada não for atendida, você receberá uma carga útil com o state definido como MISSED.

Para obter mais informações sobre a carga útil em um webhook, consulte a [documentação sobre webhooks](/Vonage Business Cloud/Vonage Integration Platform/Concepts/Webhooks).