INTEGRAÇÃO VIVO VOZ NEGÓCIO (VVN) | ASTERISK/FREEPBX/ISSABEL


Aviso importante:

Este material foi elaborado exclusivamente para fins educacionais e acadêmicos, com o objetivo de compartilhar o conhecimento sobre a configuração do sistema de telefonia em ambientes controlados. Não incentivamos ou recomendamos o uso das informações aqui contidas em ambientes de produção ou comerciais sem autorização expressa das operadoras envolvidas, neste caso a Vivo e o produto Vivo Voz e Negócio (VVN).

A utilização indevida ou fora do escopo acadêmico descrito neste material, sem o consentimento da operadora, pode violar os termos de serviço da Vivo, além de outras regulamentações aplicáveis ao uso de tecnologias de telecomunicação. A responsabilidade pelo uso das informações é exclusivamente do usuário, não cabendo ao autor qualquer responsabilidade por eventuais danos, interrupções de serviço ou ações legais que possam surgir em decorrência de sua aplicação.


UPDATE 18/07/2024 - Ajuste no arquivo de hosts do seu servidor linux. Frequêntemente nos grupos do telegram, a comunidade tem reclamado que o trunk não registra e/ou status não estabiliza como "registered" etc, na maioria dos casos tenho observado que o servidor em questão não está resolvendo o host metapabx.vivo.net.br da vivo, por este motivo, estamos complementando com essa orientação, que não é mandatória.

UPDATE 25/04/2024 — Adicionado as configurações para PJSIP usando Asterisk Puro, material criado pelo Neimar Avila este que foi de base para produção deste conteúdo do site.

UPDATE 11/04/2024 — Ajustado a linha de REGISTER do tronco SIP para quem está fazendo uso do CHAN_SIP.

UPDATE 02/03/2024 — Adicionado os campos de configuração do VVN para quem utiliza Issabel fazendo uso do CHAN_SIP.

UPDATE 19/06/2023 — Alterando o USER_AGENT (SIP/PJSIP) estabelecer o REGISTER, troca de OPTIONS e conseguir utilizar. Este material foi baseado na contribuição do Neimar Avila que compartilhou no grupo do telegram as configurações para fazer o uso do Vivo Voz e Negócio no asterisk puro, e do Lucas Adriano que topou este desafio comigo, de dedicar o feriado a homologar em seu ambiente freepbx e gerar esta documentação para comunidade, agradeço o apoio.

Com a modernização da telefonia, as operadoras estão começando a disponibilizar PABX via Cloud, a Vivo fornece o Vivo Voz e Negócio, se trata de um plano de baixo custo, onde voce consegue configurar as linhas através de um login e senha utilizando o protocolo SIP no asterisk.

Laboratório:

  1. Vivo Voz e Negócio(VVN);
  2. FreePBX 15;
  3. Asterisk 18.

No site de gestão da vivo, em linhas, copie a senha do hardphone do número que deseja configurar no seu FreePBX.
Caso não tenha a senha do hardphone voce pode resetar a senha, esta que chegará em seu e-mail. Com isso, vamos no Freepbx para darmos os inícios nas configurações;

Antes de seguir com as configurações na web, faz necessário alterar o user_agent do seu FPBX.

#Arquivo PJSIP(chan_pjsip)
/etc/asterisk/pjsip_custom_post.conf

#Parametros
[global](+type=global)
user_agent=MicroSIP/3.21.3

#reload no asterisk
asterisk -rx "core reload"

#No CLI consultar o user_agent
asterisk -rx "pjsip show settings" | grep -i "user_agent"

Deve ser apresentado o user_agent definido, MicroSIP/3.21.3

#Se estiver utilizando SIP
#Arquivo SIP(chan_sip)
/etc/asterisk/sip_general_custom.conf

#Parametros
useragent=MicroSIP/3.21.3
sdpsession=MicroSIP/3.21.3
Ourauthrealm=MicroSIP/3.21.3
realm=MicroSIP/3.21.3
sdpowner=MicroSIP/3.21.3

#restart do asterisk
fwconsole chown
fwconsole restart

#Consultar no CLI o user_agent
asterisk -rx "sip show settings" | grep -i "user agent"



Na guia Connectivity e depois em Trunks, adicione um trunk do tipo PJSIP.

Na aba General, vamos adicionar somente o DDD+número, na plataforma da vivo encontra em "linha/ramal".
Na aba Dialed Number Manipulation Rules não faz necessário alterações, segue para aba pjsip Settings, nesta será feito as seguintes configurações;

General:

Abaixo os campos como devem estar definido:

Username = DDD + Número de Telefone
Auth username = DDD+Numero
Secret = Senha do Hardphone
Authentication = Outbound
Registration = Send
SIP Server = metapabx.vivo.net.br
SIP Server Port = 5060
Context = from-pstn
Transport = 0.0.0.0-udp

Na aba Advanced vamos checar e alimentar os seguintes parâmetros:

DTMF Mode = RFC 4733
Send Line in Registration = Yes
Send Connected Line = No
Permanent Auth Rejection = No
Forbidden Retry Interval = 30 Seconds
Fatal Retry Interval = 30 Seconds
General Retry Interval = 60 Seconds
Expiration = 3600 Seconds
Max Retries = 10000
Qualify Frequency = 30 Seconds
Outbound Proxy = sip:187.50.251.58
User Phone = No
Contact User = DDD+Número
From Domain = metapabx.vivo.net.br
From User = DDD+Número
Client URI = sip:DDD+Número@metapabx.vivo.net.br
Server URI = sip:metapabx.vivo.net.br
Media Address = Deixar em Branco
AOR = DDD+Número
AOR Contact = sip:DDD+Número@metapabx.vivo.net.br:5060
Match (Permit) = 187.50.251.58
Support Path = No
Support T.38 UDPTL = No
T.38 UDPTL Error Correction = None
T.38 UDPTL NAT = No
T.38 UDPTL MAXDATAGRAM = Deixar em Branco
Fax Detect = No
Trust RPID/PAI = No
Send RPID/PAI = No
Send Private CallerID Information = No
Match Inbound Authentication = Auth Username
Inband Progress = No
Direct Media = No
Rewrite Contact = No
RTP Symmetric = Yes
Media Encryption = None
Force rport = Yes
Message Context = Deixar em Branco

Em Codecs deixe somente ALAW

Feito isso, o seu tronco Vivo Voz Negocio está pronto. Importante lembrar que tem que liberar as portas do seu roteador ou firewall a UDP 5060 (SIP) e as portas 16384-65535(RTP) somente para o IP 187.50.251.58, que é o ip do proxy da Vivo.

Realizado um teste de ligação apos as configurações com sucesso, sem dificuldades!

[Issabel] - Configurações do SIP Trunk VVN

Trunk Name:vivo
Outbound CallerID:Login_VVN

Outgoing Settings  
Trunk Name:vivo

PEER Details:
username=Login_VVN
type=peer
secret=Senha_VVN
qualify=5000
port=5060
outboundproxy=187.50.251.58
nat=yes
insecure=port,invite
host=metapabx.vivo.net.br
dtmfmode=rfc2833
disallow=all
context=from-pstn
allow=alaw
fromdomain=metapabx.vivo.net.br

Incoming Settings  
USER Context:Login_VVN

USER Details:
secret=Senha_VVN
type=user
context=from-trunk

Register String:
Login_VVN@metapabx.vivo.net.br:Senha_VVN@187.50.251.58/Login_VVN


[Asterisk Puro] - Configurações do SIP Trunk VVN (PJSIP)

[global] type=global user_agent=MicroSIP [vivo] type=endpoint transport=transport-udp-nat context=from-vivo allow=!all,ulaw,alaw,g729 outbound_auth=vivo_auth outbound_proxy=sip:187.50.251.58\;lr from_domain=metapabx.vivo.net.br aors=vivo user_eq_phone=yes [vivo] type=aor contact=sip:Login_VVN@metapabx.vivo.net.br:5060 outbound_proxy=sip:187.50.251.58\;lr [vivo] type=identify match=187.50.251.58 endpoint=vivo [vivo] type=registration client_uri=sip:Login_VVN@metapabx.vivo.net.br server_uri=sip:metapabx.vivo.net.br outbound_auth=vivo_auth outbound_proxy=sip:187.50.251.58\;lr retry_interval=60 contact_user=Login_VVN [vivo_auth] type=auth auth_type=userpass username=Login_VVN password=Senha_VVN

Configuração do /etc/hosts

Conforme orientado pela LPI - Linux Professional Institute, o arquivo /etc/hosts é usado para resolver nomes para endereços IP e vice-versa. Tanto o IPv4 como o IPv6.
$ cat /etc/hosts
127.0.0.1       localhost issabel.local 
187.50.251.58 metapabx.vivo.net.br
$

"Começar é a parte mais importante de qualquer trabalho" - Platão

Link para acesso ao Telegram FreePBX Brasil