Adicionar chamadas no navegador com Webphone SDK

Use o SDK atual, mantenha credenciais permanentes no servidor e teste chamadas com segurança.

Começar pelo pacote e referência compatíveis

Abra Documentação API → Webphone SDK. Baixe o pacote web ou recursos documentados e siga exemplos da mesma versão. Leia avisos de segurança antes de integrar cópia antiga. É SDK web, não substituto para chamadas nativas móveis.

O desenvolvedor deve preparar aplicativo HTTPS autenticado, identidade SIP permitida, permissão de microfone e recursos do SDK atual. O SDK Playground verifica conta e navegador, mas chamadas são reais e podem cobrar.

Manter credenciais permanentes no backend

1. Use normalmente o exemplo de token gerenciado como início em produção.
2. O backend autentica o usuário e verifica qual identidade IllyVoIP ele pode usar.
3. Com a chave API, solicita a autorização curta do navegador. Retorne apenas os dados exigidos pelo SDK, nunca a chave permanente.
4. Inicialize com esses dados e o exemplo atual correspondente. Trate expiração, logout e falhas em vez de criar sessões repetidamente.

Não aceite identidade arbitrária de navegador não autenticado nem deixe gerar tokens para outra conta. Mantenha chaves e senhas SIP fora de JavaScript público, repositórios, URLs e capturas. SIP direto é alternativa avançada, não motivo para enviar segredos permanentes ao frontend.

Mostrar a preparação ao usuário

Exiba conectando, pronto, entrada, ativo, encerrado e falha pelos eventos documentados. Peça microfone por ação clara, permita escolher dispositivos quando suportado e mostre recusa de permissão. Teclado exibido não prova registro; registro não prova áudio bidirecional.

Não suponha que o SDK entrega toda a política multidispositivo. Siga o ciclo conectar/desconectar e mostre conflitos. Sessão encerrada não deve parecer telefone ativo. Limpe estado específico da conta ao sair e inicialize a identidade autorizada do novo usuário, não a antiga em cache.

Fazer pequena aceitação

Com autorização, teste saída e entrada, atender/encerrar, microfone/alto-falante e controles expostos de espera, teclado ou transferência. Teste recusa de permissão, perda de conexão, logout/troca de conta e uso multidispositivo. Siga diagnóstico e região atuais; fallback regional não garante sobrevivência de chamada interrompida.

Use destinos de teste autorizados, confira tarifas e não trate chamadas repetidas como gratuitas. Não colete ou envie gravações sem avisos e autorização necessários.

Diagnosticar por etapa

Se autorização falhar, confira resposta backend e direitos sem registrar segredos. Se sinalização falhar, confira região e compatibilidade rede/navegador. Se conectado sem áudio, veja dispositivos, permissão e acesso de mídia. Guarde versões SDK/navegador, erro sem dados privados, horário/fuso e referência pública para suporte.

A referência API é a autoridade para métodos, dados e validade de tokens. Veja Início rápido API para acesso à conta e requisições seguras.