Sou integrador de telefonia: como entrego números SIP brasileiros pros meus clientes?
Por NumioPublicado em
Por dois caminhos, e a escolha é de volume. Autoatendimento: você (ou o próprio cliente) compra o número no site, com o plano de ligações, e as credenciais SIP saem no painel no mesmo dia — sem proposta, sem pedido comercial, sem esperar provisionamento. API B2B: a sua plataforma contrata números em nome dos clientes finais, com o KYC exigido pela Anatel conduzido pela própria API.
Nos dois casos, o que chega no seu PABX é uma conta SIP comum: servidor, porta 5060, transporte UDP, usuário igual ao número, senha do painel, G.711. Se o PABX tem IP público fixo, dá pra pedir a entrega por IP, sem registro nem senha, configurando isso na página do número. O roteamento — URA, fila, ramal, horário — continua sendo seu, do jeito que você já faz.
O limite honesto do modelo: não vendemos tronco por canais, PABX hospedado, 0800 nem chamada internacional, e o "ilimitado" não cobre discador. Pra cliente de call center ativo, o fornecedor certo é um provedor de atacado tarifado.
Os dois caminhos, comparados
| Autoatendimento | API B2B | |
|---|---|---|
| Quem é o titular | Você ou o cliente, conforme quem compra | O cliente final, na sua conta de parceiro |
| KYC | Feito uma vez por conta, no painel | Endpoint da API, com status consultável |
| Volume | Até 20 números por pedido | Sem o limite do autoatendimento |
| Cobrança | Assinatura por pedido, com nota | A Numio fatura você; o cliente final é faturado por você |
| Prazo | Mesmo dia | Mesmo dia, programático |
| Preço | Tabela pública | Condição de parceiro, caso a caso |
A referência da API está em /docs, com o OpenAPI em /docs/openapi.json. A página API de números para revenda detalha o fluxo inteiro.
O que você precisa configurar do seu lado
| Campo | Valor | Nome do campo no app ou aparelho |
|---|---|---|
| Servidor | Endereço do softswitch, mostrado no painel | Servidor SIP, Domínio ou Host |
| Porta | 5060 | Porta — só onde houver campo próprio |
| Transporte | UDP | Transporte |
| Usuário | O próprio número, com DDD e sem +55 — 10 dígitos, tudo junto | Usuário ou Nome de usuário (e o de autenticação, se o app pedir) |
| Senha | Gerada no painel e exibida uma única vez | Senha |
| Codec | G.711 — PCMA (alaw) e PCMU (ulaw) | Lista de codecs do app, aparelho ou PABX |
| Identificação de quem liga | O próprio número, nas ligações que você faz | Nada a configurar — é fixo |
- Um tronco por número no PABX (o número não é uma faixa com canais).
- G.711 alaw/ulaw na lista de codecs — sem G.729.
- SIP ALG desligado no roteador do cliente; é a causa nº 1 de chamada sem áudio.
- Rota de saída pelo tronco do próprio número: a identificação de quem liga é sempre o número, não é configurável.
Como é o suporte quando dá problema
Suporte humano pelo WhatsApp, sobre o que é da linha: registro, roteamento, qualidade e status do número. A configuração do PABX do cliente é sua — mas os dados que você precisa pedir (registro, IP, porta, codec) estão todos no painel, sem abrir chamado.
E se o cliente também quiser WhatsApp no mesmo número?
Vai junto, sem custo adicional: o mesmo número serve como identificador do WhatsApp Business, e a Numio atende a ligação de verificação da Meta e mostra o código de 6 dígitos no painel. Pra integrador de PABX isso costuma valer como argumento de venda: uma linha, dois usos.
Como entregar o número no seu PABX
1. Contrate o número com o adicional de chamadas
Em escolher número, com o plano com ligações marcado — é ele que libera o SIP.
2. Decida como o número chega no PABX
Registro com usuário e senha (o PABX se registra como um cliente SIP, funciona atrás de NAT) ou entrega por IP (você informa o IP público e a porta do PABX no painel, em Configurar SIP, e não há senha).
3. Crie o tronco no PABX
Um tronco por número, com G.711 (alaw/ulaw) e transporte UDP.
4. Aponte a rota de entrada e a de saída
Rota de entrada: o número chega como o DID discado — mande pra URA, fila ou ramal. Rota de saída: use o tronco desse número; a identificação de quem liga é sempre o próprio número, então não adianta forçar outro CLI.
5. Libere firewall e teste
Deixe passar o SIP (5060/UDP) e o RTP da rede da operadora, desligue o SIP ALG do roteador e faça uma ligação em cada sentido.
Perguntas frequentes
Pelo autoatendimento, não: compra pelo site como qualquer cliente. Pra contratar em nome de clientes finais por integração, aí sim existe a conta de parceiro com chave de API.
Pode — e é o recomendado, porque a titularidade e a nota ficam no nome dele. Na API, o cliente final é o titular.
Não. O produto é número com conta SIP própria; quantidade de chamadas simultâneas depende de quantos números e de como o seu PABX distribui.
Dá, quando o PABX tem IP público. A opção fica na página do número, em Configurar SIP, junto com a porta.
G.711 (PCMA/PCMU). G.729 não é oferecido.
Não. Revenda de tráfego, discador automático e telemarketing em massa são vedados nos Termos de Uso.