Notificações push

As notificações push são necessárias para garantir a entrega confiável de chamadas recebidas quando o aplicativo está em segundo plano ou foi encerrado.

Explicação passo a passo

  1. Registrar o ouvinte onCallInvite — Antes de mais nada, seu aplicativo deve registrar o onCallInvite ouvinte. Isso garante que a função de retorno esteja pronta quando chegar uma notificação push.

  2. Chamada recebida — Um chamador inicia uma chamada direcionada ao seu usuário. A API da Vonage identifica o destino e determina se o dispositivo do usuário precisa receber uma notificação push.

  3. Enviar o conteúdo do convite — A API da Vonage envia a carga útil do convite de chamada para o serviço de notificações push da plataforma (APNs para iOS, FCM para Android).

  4. Enviar notificação push — O serviço push envia a notificação ao sistema operacional do dispositivo. No iOS, ela chega por meio do PushKit (push VoIP). No Android, ela chega por meio da mensagem de dados do FCM.

  5. Callback de notificação push — O sistema operacional envia a carga útil da notificação push para o manipulador de notificações push do seu aplicativo:

    • iOS: Ligue processCallInvitePushData dentro da função de retorno do delegado do PushKit.
    • Android: Ligue processPushCallInvite dentro onMessageReceived.
  6. A função de retorno onCallInvite é acionada — O SDK processa a carga útil da notificação push e aciona onCallInvite. Exiba a interface do usuário para chamadas recebidas com as informações do chamador e as opções para atender ou rejeitar a chamada.

Antes da implementação, conclua a configuração de envio de dados para o painel da Vonage com as credenciais do seu aplicativo:

Guias da plataforma

Para obter orientações detalhadas sobre a implementação, incluindo exemplos completos de código, diagramas de fluxo, tratamento de erros e listas de verificação para produção, consulte os guias específicos para cada plataforma:

O Web SDK não utiliza notificações push nativas, do tipo usado em dispositivos móveis, para convites de chamada recebidos. Os convites são enviados por meio da sessão do WebSocket enquanto ela estiver ativa.