IllyVoIP para programadores

A sua aplicação.
Ligada ao mundo.

Integre voz, mensagens e gestão de números no seu software. Utilize APIs do lado do servidor nos seus processos e o Webphone SDK para chamadas na interface do navegador.

Comece pelas suas identidades SIPcURL
# Exemplo de pedido do lado do servidor
curl -X GET \
  "https://api.illyvoip.com/api/v1/sip/identities" \
  -H "X-Api-Key: YOUR_API_KEY"
HTTPS · JSONA sua conta. A sua integração.

Crie a ligação
de que o seu produto precisa.

Comece por um serviço e consulte a respetiva referência para compreender a autenticação, os parâmetros, as respostas e as ações disponíveis.

SMS

Envie mensagens, consulte os resultados por destinatário e acompanhe o estado de entrega na sua aplicação.

Conhecer os SMS

Consulta de números e HLR

Normalize números de telefone ou solicite informações de rede e portabilidade disponíveis em tempo real.

Conhecer a consulta de números

Serviços de fala

Converta áudio em texto ou gere áudio falado a partir de texto com APIs autónomas de fala. Escolha entre os idiomas e as vozes documentados.

Conhecer as APIs de fala

Contactos e dados de chamadas

Utilize os endpoints documentados para trabalhar com contactos, histórico de chamadas e acesso a gravações.

Consultar a referência da API

Webphone SDK

Mantenha a chamada
dentro da sua aplicação.

Adicione chamadas no navegador a um CRM, interface de agente ou espaço de trabalho próprio. O SDK JavaScript disponibiliza registo, controlo de chamadas e gestão de dispositivos através de SIP sobre WSS.

O seu backendA chave de API fica aqui
Autenticação geridaToken de curta duração para o navegador
A sua interface no navegadorWebphone SDK

A sua interface. Com controlo de chamadas.

Ligue, registe, chame, atenda, silencie, coloque em espera, retome, envie DTMF e transfira através de JavaScript.

Dispositivos e diagnóstico

Selecione dispositivos de áudio, faça verificações prévias e consulte estatísticas de chamadas em direto. A seleção da saída de áudio depende do suporte do navegador.

Regiões e gestão de sessões

Escolha uma região, configure alternativas geridas de sinalização e renove as credenciais do navegador para sessões mais longas.

Webhooks

Deixe o seu software
acompanhar a conversa.

Receba notificações de eventos de chamadas, SMS, contactos e correio de voz. Atualize os seus registos ou desencadeie a próxima etapa do processo.

Verifique as assinaturas, confirme rapidamente a receção e trate com segurança IDs de evento repetidos.

Consultar a referência de webhooks
Chamadascall_ringing
call_answered
call_completed
SMSsms_sent
sms_delivered
sms_failed
Espaço de trabalhocontact_added
voicemail_received

Da documentação
à implementação.

O portal reúne documentação da API, exemplos e ferramentas de desenvolvimento na sua conta.

Compreenda o pedido

Verifique o método de autenticação, os parâmetros obrigatórios e os campos da resposta do endpoint.

Primeiros passos

Trabalhe com o esquema

Utilize a especificação OpenAPI publicada em conjunto com a documentação dos endpoints.

Especificação OpenAPI

Explore as ferramentas

Gere exemplos de pedidos no API Playground. Os pedidos enviados utilizam a sua conta e podem executar ações com custos.

Abrir o API Playground

Planeie a sua
integração.

Pergunte à nossa equipa
Como autentico os pedidos do servidor?+

Os pedidos normais da API de cliente utilizam o cabeçalho X-Api-Key. Mantenha a chave no backend. O guia atual de primeiros passos documenta o âmbito da conta e os requisitos específicos dos endpoints.

Como giro o acesso à chave de API?+

O portal protege a apresentação, cópia e regeneração da chave com verificação de identidade. Siga os pedidos de palavra-passe e verificação em dois passos apresentados. O API Playground utiliza um desbloqueio temporário; reveja o pedido antes de o executar. Ao regenerar a chave, coordene a atualização das aplicações que a utilizam.

Como se autenticam as chamadas no navegador?+

No fluxo gerido recomendado do SDK, o backend emite um token de curta duração para o navegador. Determine a identidade SIP a partir do utilizador autenticado no servidor; não permita que o navegador escolha uma identidade arbitrária. A chave de API permanece no servidor.

O Webphone SDK é um SDK móvel?+

É um SDK JavaScript exclusivo para chamadas no navegador. É independente das aplicações IllyVoIP publicadas para Windows, iOS e Android.

Onde obtenho o SDK?+

A referência do Webphone SDK disponibiliza ligações para o recurso alojado para navegador e para um pacote descarregável para alojamento próprio, com definições TypeScript. Utilize o pacote atual e consulte as notas de versão e orientações de segurança.

Posso gerir números de telefone pela API?+

Sim. A API documenta a pesquisa de catálogo, estimativas, encomendas, encaminhamento e envio de documentos obrigatórios. A disponibilidade e a ativação dependem do destino e dos requisitos de registo aplicáveis.

O meu webhook recebe cada evento apenas uma vez?+

A entrega pode ser repetida. Verifique a assinatura e utilize o ID estável do evento para evitar processá-lo duas vezes. A referência apresenta os eventos disponíveis e o comportamento das novas tentativas.

Integre as comunicações
no seu produto.

Comece pela referência atual da API e escolha os serviços de que precisa.