Nvoip: Guia Completo de Telefonia em Nuvem, API v3 e Integração Asterisk
Aprenda a configurar troncos SIP no Asterisk e Issabel, integrar a API v3 da Nvoip com OAuth2 e automatizar WhatsApp, SMS e Torpedo de Voz via n8n.
[!NOTE] Resumo Executivo / Contexto: A modernização da infraestrutura de telecomunicações corporativa exige a convergência entre PABX IP de alta disponibilidade (Asterisk / Issabel) e serviços programáveis de voz, SMS e mensageria oficial via APIs REST e plataformas no-code. Este guia detalha o ecossistema Nvoip de ponta a ponta com parâmetros testados em produção.
📌 Introdução à Plataforma Nvoip
A Nvoip consolidou-se como uma das principais operadoras e plataformas de telecomunicações em nuvem do Brasil, oferecendo desde terminação SIP no atacado até APIs avançadas de comunicação multicanal (CPaaS).
Ao acessar o portal da Base de Conhecimento (painel.nvoip.com.br/knowledge-base autenticado via token de usuário em suporte.nvoip.com.br/portal/pt/kb), desenvolvedores e administradores de rede têm acesso a recursos cruciais divididos em quatro pilares fundamentais:
- Tronco SIP (SIP Trunking): Conexão direta com servidores Asterisk, FreePBX, Issabel e centrais IP físicas.
- REST APIs (v2 e v3): Autenticação OAuth2 para disparo de chamadas, consulta de histórico, envio de Torpedos de Voz com TTS e DTMF.
- Mensageria Unificada: Envio em massa e transacional de SMS e templates oficiais do WhatsApp Cloud API (Meta).
- Automação No-Code: Módulos dedicados para plataformas como n8n (
@nvoip/n8n-nodes-nvoip).
flowchart TD
N[Nvoip Cloud Engine] --> S[Tronco SIP RFC 3261\napp.nvoip.com.br]
N --> A[REST API v3\nOAuth2 Bearer]
N --> W[WhatsApp Cloud API\nMeta HSM]
N --> T[Torpedo de Voz TTS\n& Captura DTMF]
S --> P[Servidor Asterisk / Issabel]
A --> D[Aplicações Web / SaaS]
W --> C[Notificações Críticas CRM]
T --> N8N[Workflows no n8n]
📌 1. Interconexão SIP com Asterisk, FreePBX e Issabel
A integração do seu servidor de telefonia próprio com a Nvoip ocorre via protocolo SIP na porta 5060 UDP.
1.1. Configuração do Tronco de Saída (nvoip_out)
No arquivo sip.conf ou na interface gráfica do Issabel/FreePBX em Trunks:
[nvoip_out]
username=68105001
type=peer
secret=SUA_SENHA_SIP
host=app.nvoip.com.br
fromuser=68105001
fromdomain=app.nvoip.com.br
context=from-trunk
dtmfmode=rfc2833
disallow=all
allow=ulaw&alaw
keepalive=yes
session-timers=refuse
nat=force_rport,comedia
qualify=yes
qualifyfreq=60
insecure=invite,port
1.2. Configuração do Tronco de Entrada (nvoip_in) e String de Registro
Para receber chamadas no seu número DID contratado na Nvoip:
[nvoip_in]
username=68105001
type=friend
secret=SUA_SENHA_SIP
host=app.nvoip.com.br
context=from-trunk
insecure=invite,port
session-timers=refuse
disallow=all
allow=ulaw&alaw
nat=force_rport,comedia
canreinvite=no
String de Registro:
68105001:SUA_SENHA_SIP@app.nvoip.com.br:5060/68105001
[!TIP] Por que
session-timers=refuse? Muitos roteadores corporativos e operadoras com CGNAT encerram conexões UDP após 15 a 30 minutos sem re-INVITE. A diretiva recusa a negociação de sessão do timer SIP, mantendo a chamada estável até que uma das partes desligue.
📌 2. Consumindo a API v3 com OAuth2
A API v3 da Nvoip utiliza autenticação padrão OAuth2, garantindo tokens seguros com tempo de expiração determinado.
2.1. Gerando o Access Token
curl -X POST "https://auth.nvoip.com.br/oauth2/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=SEU_CLIENT_ID" \
-d "client_secret=SEU_CLIENT_SECRET"
A resposta retornará um token JWT:
{
"access_token": "eyJhbGciOiJSUzI1Ni...",
"token_type": "Bearer",
"expires_in": 86400
}
2.2. Disparo de Torpedo de Voz com DTMF (Pesquisa Reversa)
Uma das funcionalidades mais poderosas é o envio de Torpedo Interativo. O sistema liga para o número desejado, fala uma mensagem com voz sintetizada neural e aguarda o dígito do usuário:
curl -X POST "https://api.nvoip.com.br/v3/torpedo/voice" \
-H "Authorization: Bearer SEU_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"destination": "11973741227",
"message": "Olá, por favor digite 1 para confirmar seu horário ou 2 para remarcar.",
"maxDigits": 1,
"timeout": 10,
"webhookUrl": "https://api.artesdosul.com/webhook/nvoip-dtmf"
}'
📌 3. Automação Avançada com o Node n8n
O pacote oficial @nvoip/n8n-nodes-nvoip permite transformar tarefas operacionais complexas em fluxos visuais automáticos:
| Workflow | Gatilho | Ação Nvoip | Resultado de Negócio |
|---|---|---|---|
| Callback de Vendas | Lead entra no site | calls.makeCall |
Operador é conectado ao lead em menos de 45 segundos |
| Notificação com Fallback | Alerta de infraestrutura | wa.sendTemplates + fallback em sms.send |
100% de taxa de entrega mesmo para usuários sem internet |
| Pesquisa NPS por Voz | Ticket de suporte encerrado | torpedo.voiceInteractive |
Resposta computada no CRM sem depender de abertura de e-mail |
📌 4. Comparativo de Recursos: PABX em Nuvem vs. Tronco SIP Próprio
| Parâmetro | PABX em Nuvem Nvoip (SaaS) | Tronco SIP Nvoip + Asterisk Próprio |
|---|---|---|
| Complexidade de Manutenção | Baixa (configuração 100% web no painel) | Média/Alta (requer servidor Linux dedicado) |
| Flexibilidade de Dialplan | Menus de URA e filas predefinidas | Personalização infinita com scripts e IA |
| Custos de Infraestrutura | Mensalidade por ramal ativo | Apenas tráfego VoIP consumido e servidor VPS |
| Integração com CRM Local | Via Webhook / APIs nativas | Acesso direto ao Asterisk AMI, AGI e CDR MySQL |
📌 Conclusão e Próximos Passos
A Nvoip oferece uma base técnica robusta tanto para quem busca uma central telefônica completa pronta para uso quanto para engenheiros que precisam de infraestrutura VoIP pura com APIs programáveis e alta elasticidade.
Para consultar todos os manuais técnicos detalhados com configurações avançadas de firewall, regras de discagem e scripts de automação, acesse a Central de Manuais Nvoip no portal Artes do Sul.
