Documentação para programadores

SIP

Introdução

Bem-vindo ao serviço de telefonia SIP da Speaqr. O nosso servidor SIP permite-te realizar chamadas telefónicas com tradução em tempo real, quebrando as barreiras do idioma nas comunicações telefónicas.O serviço utiliza tecnologia SIP sobre TLS para garantir comunicações seguras, juntamente com SRTP para encriptação de áudio e o codec μ-law (PCMU) para compatibilidade universal com sistemas de telefonia.Com o nosso serviço SIP, poderás integrar as capacidades de tradução do Speaqr diretamente na tua central telefónica, softphone ou qualquer sistema compatível com SIP, permitindo chamadas multilíngues sem necessidade de intérpretes físicos.Para usar o serviço SIP precisas de credenciais de acesso válidas. Para obtê-las, contacta-nos através do formulário de contratação.

Pré-requisitos

Antes de configurar o teu cliente SIP, assegura-te de cumprir os seguintes requisitos:

Cliente SIP compatível

O seu cliente SIP deve suportar SIP sobre TLS para sinalização segura, SRTP (SDES) para encriptação de áudio e o codec μ-law (PCMU) que é obrigatório para compatibilidade com o serviço.Exemplos de clientes compatíveis: Qualquer softphone ou central com suporte para PJSIP.

Credenciais de acesso

Receberás um nome de usuário (ex. novo-usuario), uma senha e o domínio do servidor: sip.speaqr.ai.

Ligação de rede

Certifica-te de que as portas 5061/TCP (para TLS) e 10000-20000/UDP (para SRTP) estão abertas na tua rede ou firewall.

Certificados TLS

Não precisas de gerar certificados adicionais. O nosso servidor usa um certificado TLS válido. Certifica-te de que o teu cliente aceita certificados de confiança padrão.

Configuração do cliente

Configure o seu softphone ou central telefónica para se conectar a sip.speaqr.ai com os seguintes parâmetros:

Dados da conta

• Nome de utilizador: novo-utilizador (fornecido pelo administrador)
• Palavra-passe: A tua palavra-passe fornecida
• Domínio/Servidor: sip.speaqr.ai:5061

Configuração do protocolo

• Transporte: TLS
• Porto: 5061
• Cifra de mídia: SRTP (SDES)
• Codecs: Ativa apenas PCMU (μ-law); desativa outros codecs

Opções de rede

• Registar no servidor: Ativa a opção de registo (REGISTER)
• STUN (se estás atrás de NAT): Usa um servidor STUN como stun.l.google.com:19302

Cabeçalhos SIP personalizados

Configura a capacidade de enviar cabeçalhos SIP personalizados (consulte a documentação do seu cliente para adicioná-los).Exemplo: X-Origin: novo-usuario, X-Destination: destino

Serviços disponíveis

O servidor oferece dois serviços através da aplicação ARI loopback. Use os seguintes métodos para interagir com eles:

Serviço de loopback

Envie áudio para o servidor e receba o áudio processado (intervencionado) por Speaqr.

Como utilizar

Marque a extensão loopback no seu cliente SIP.

Cabeçalhos SIP necessários

• X-Origin: O teu identificador (ex. novo-usuario)
• X-Destination: Um identificador para o destino (pode ser qualquer valor relevante, ex. teste)

Comportamento

O servidor responde o áudio processado pela aplicação Speaqr, baseado no teu email (obtido a partir da base de dados) e nos cabeçalhos.

Serviço de chamadas

Realiza uma chamada para um número de telefone físico, com o áudio intervencionado por Speaqr.

Como utilizar

Marque a extensão call no seu cliente SIP.

Cabeçalhos SIP necessários

• X-Origin: O seu identificador (ex. novo-usuario)
• X-Destination: O número de telefone físico para o qual deseja ligar (formato internacional, ex. +1234567890)
• X-Dial: Opcional, para especificar um número ou destino adicional (ex. +1234567890)

Comportamento

A chamada é conectada ao número especificado, com o áudio processado pelo Speaqr.

Resolução de problemas

Se encontrares dificuldades durante a configuração ou uso do serviço SIP, verifica as seguintes soluções:

A conta não está registada

• Verifica que o nome de utilizador, palavra-passe e porta (5061/TLS) sejam corretos
• Certifica-te de que o firewall permite a porta 5061/TCP
• Se estiveres atrás de NAT, ativa STUN ou contacta o administrador

Sem áudio

• Confirma que SRTP esteja habilitado e que as portas RTP (10000-20000/UDP) estejam abertas
• Certifica-te de que apenas PCMU esteja habilitado como codec

Erro ao usar serviços loopback ou call

• Verifica se os cabeçalhos X-Origin e X-Destination estão corretamente configurados
• Certifica-te de que a tua conta está registada antes de marcar
• Contacta o administrador se a aplicação ARI não responder

Este sítio Web utiliza cookies

Os cookies neste sítio Web são utilizados para personalizar o conteúdo e analisar o tráfego.
Pode encontrar os detalhes destes cookies na secção Política de Privacidade.