Início›SIP Trunk para FreePBX
SIP Trunk

SIP Trunk para FreePBX

Entroncamento SIP para centrais FreePBX, configurado em PJSIP, com autenticação por registro ou por IP autorizado, codecs G.711a e G.729, failover entre rotas e concorrência sob demanda. Abaixo está a configuração completa do tronco, as rotas de entrada e saída e os erros que mais aparecem em campo.

A GCLOUD LTDA® é uma empresa brasileira de telefonia em nuvem, sediada em Joinville (SC), que fornece entroncamento SIP para centrais FreePBX em todo o Brasil. O FreePBX é a interface web de código aberto mais usada para administrar o Asterisk, escolhida por empresas e integradores que querem manter a central sob seu próprio controle.

O guia usa o driver PJSIP, o único disponível no FreePBX 17, que roda sobre Asterisk 21 ou superior, sem o chan_sip. No FreePBX 15 e 16 o PJSIP também é o caminho recomendado, e os menus são os mesmos.

O que está incluído

Como configurar o tronco no FreePBX

Antes de começar. Os valores de host, usuário e senha são individuais da sua conta e chegam no e-mail de ativação. Nos blocos abaixo eles aparecem como marcadores em destaque: substitua pelos dados que você recebeu. O formato de numeração (nacional com DDD ou E.164 com +55) também é combinado na ativação. Se ainda não tem conta, peça os dados de teste no WhatsApp.
  1. Criar o tronco Em Connectivity → Trunks, clique em Add Trunk e escolha Add SIP (chan_pjsip) Trunk. Na aba General, use gcloud em Trunk Name e informe um número DID da sua conta em Outbound CallerID. No Brasil, a operadora só entrega a chamada com um Bina que pertença a você.
  2. Aba pjsip Settings → General Preencha:
    CampoValor
    UsernameSEU-USUARIO
    SecretSUA-SENHA
    AuthenticationOutbound
    RegistrationSend
    SIP ServerSEU-HOST-SIP
    SIP Server Port5060
    Contextfrom-pstn
    Transport0.0.0.0-udp
    Se a conta usa IP autorizado, deixe Authentication e Registration em None e informe o IP público da central para a GCLOUD liberar.
  3. Aba pjsip Settings → Advanced Ajuste:
    CampoValor
    From DomainSEU-HOST-SIP
    From UserSEU-USUARIO
    DTMF ModeRFC 4733
    Direct MediaNo
    Rewrite ContactYes
    RTP SymmetricYes
    Force rportYes
    Qualify Frequency60
    From Domain e From User são o equivalente ao fromdomain e ao fromuser: sem eles o registro volta 403 Forbidden. Direct Media em No mantém o áudio passando pela central. Em conta por IP autorizado, preencha também Match (Permit) com os IPs da GCLOUD que a engenharia informa na ativação.
  4. Aba pjsip Settings → Codecs Marque só alaw e g729, com alaw em primeiro. O G.729 depende do módulo de codec instalado na central (codec_g729); sem ele, use apenas alaw.
  5. Aplicar e conferir o registro Clique em Submit e depois em Apply Config. Confira o registro em Reports → Asterisk Info → Registries ou no console:
    asterisk -rx "pjsip show registrations"
    asterisk -rx "pjsip show endpoint gcloud"
    O registro deve aparecer como Registered, e o endpoint com o contato disponível e a latência em milissegundos.
  6. Criar a rota de saída Em Connectivity → Outbound Routes, crie uma rota, informe um DID da conta em Route CID e aponte Trunk Sequence para o tronco gcloud. Nos Dial Patterns, para quem disca 0 + DDD + número:
    Formato combinadoprependprefixmatch pattern
    Nacional com DDDvazio0XXXXXXXXXX.
    E.164+550XXXXXXXXXX.
    Enviar no formato errado é a causa mais comum de “chamada não completa” logo depois de subir o tronco. Na dúvida, confirme com a engenharia.
  7. Criar a rota de entrada Em Connectivity → Inbound Routes, cadastre o DID no campo DID Number, no mesmo formato em que a GCLOUD entrega a chamada, e escolha o destino em Set Destination: URA, fila, ramal ou grupo de toque.
  8. NAT e testes Se a central estiver atrás de NAT, informe o IP público em External Address e a rede interna em Local Networks, em Settings → Asterisk SIP Settings. Depois faça uma chamada de saída para um celular e uma de entrada para o DID. Com pjsip set logger on no console você acompanha a sinalização em tempo real.

Firewall e portas

Libere na sua borda e no firewall da central:

ServiçoPortaProtocolo
Sinalização SIP (PJSIP)5060UDP
Mídia RTP10000–20000UDP

Confira a porta do PJSIP e a faixa de RTP em Settings → Asterisk SIP Settings: em centrais que ainda têm chan_sip ativo, o FreePBX costuma deixar o PJSIP na 5060 e o chan_sip na 5160. Se o módulo Firewall do FreePBX estiver ativo, cadastre o host da GCLOUD como rede confiável (Trusted) em Connectivity → Firewall → Networks. Sem isso, o Responsive Firewall pode bloquear o tronco depois de algumas tentativas de autenticação.

Problemas mais comuns em campo

Áudio em uma via só (one-way audio)
É NAT na grande maioria dos casos. Confirme Direct Media em No, RTP Symmetric, Rewrite Contact e Force rport em Yes, o External Address e as Local Networks, e libere a faixa RTP 10000–20000/UDP.
O tronco não registra
Rode pjsip show registrations. 403 Forbidden normalmente é senha incorreta ou From User/From Domain ausentes; Request Timeout costuma ser bloqueio de 5060/UDP no caminho ou o Responsive Firewall. Em conta por IP autorizado, Registration precisa estar em None.
A chamada cai sozinha em torno de 30 segundos
Sinal clássico de o ACK do SIP não estar chegando ao destino, quase sempre por NAT ou por regra de firewall que só permite tráfego de saída. Ative pjsip set logger on e verifique se o ACK sai da central e se há resposta.
A URA não reconhece os dígitos
Praticamente sempre DTMF fora do padrão. Use DTMF Mode RFC 4733 no tronco. Se a central estiver transcodificando para G.729, teste forçando alaw: compressão agressiva degrada a detecção de tom.
Chamadas de saída rejeitadas com Bina inválida
No Brasil, o número apresentado precisa pertencer à sua conta. Confira o Outbound CallerID do tronco, o Route CID da rota de saída e o From User. Número de terceiro é bloqueado na origem.
A chamada recebida cai em “número não existe”
Nenhuma rota de entrada casou com o DID. Confira se o DID Number está no mesmo formato em que a chamada chega e se o Context do tronco é from-pstn.

Tarifas

DestinoValorObservação
FixoR$ 0,11/minQualquer fixo do Brasil, local ou não
CelularR$ 0,15/minTodas as operadoras móveis
Chamada recebidaR$ 0,00Receber não tem custo por minuto

Valores de referência, sujeitos a proposta comercial. Tempo mínimo de cobrança de 30 segundos, conforme padrão de mercado. Sem taxa de ativação e sem fidelidade. Portabilidade de números custa R$ 20,00 por número, cobrada uma vez.

Dúvidas frequentes

O SIP Trunk funciona com qual versão do FreePBX?
Funciona com o FreePBX 15, 16 e 17. O guia usa PJSIP, o único driver disponível no FreePBX 17 e o recomendado nas versões anteriores.
Ainda posso usar chan_sip?
No FreePBX 15 e 16, com Asterisk até a versão 20, o chan_sip ainda funciona, e os parâmetros são os mesmos do guia de SIP Trunk para Issabel. A partir do Asterisk 21 e do FreePBX 17 o chan_sip não existe mais, então o caminho é PJSIP.
Preciso de IP fixo?
Não. Com autenticação por registro, a central se registra na GCLOUD e o IP pode ser dinâmico. IP fixo só é necessário se você optar pela autenticação por IP autorizado, que dispensa usuário e senha.
Quantas chamadas simultâneas o tronco suporta?
A concorrência é definida sob demanda, conforme o perfil de tráfego da central. Não há um limite fixo de canais imposto por padrão: o dimensionamento é acertado na proposta e pode ser ampliado depois.
Consigo manter os números que já uso hoje?
Sim, por portabilidade numérica. O processo é regulamentado pela Anatel (Resolução 460/2007) e conduzido pela equipe da GCLOUD junto à operadora cedente. O tronco pode ser instalado e testado antes da portabilidade, para a migração acontecer sem interrupção.
A GCLOUD ajuda na configuração?
Sim. O atendimento técnico é feito por engenheiros de rede e telefonia. Você pode mandar um SIP trace no WhatsApp e receber a análise da causa, em vez de um roteiro genérico de primeiro nível.
Preciso do G.729 para economizar banda?
Não é obrigatório. O G.711a (alaw) é o padrão no Brasil e entrega a melhor qualidade, consumindo cerca de 87 kbps por chamada com overhead. O G.729 reduz para cerca de 31 kbps e ajuda quando o link é limitado, mas depende do módulo de codec instalado na central.

Guias para outras centrais

O tronco é o mesmo em qualquer central SIP. Se a sua não é FreePBX, veja o guia específico:

Manda o cenário que a gente valida

Quantidade de ramais, tráfego mensal e a versão do seu FreePBX. Devolvemos o dimensionamento de concorrência e a proposta e, se quiser, um tronco de teste antes de qualquer contrato.

Falar no WhatsApp
Próximos passos

Ainda ficou alguma dúvida?

A parte técnica está resolvida. Falta a comercial.