Existe API para contratar números virtuais brasileiros em nome dos meus clientes?
Por NumioPublicado em
Existe, e é o que a API B2B da Numio faz: um CRM, uma plataforma de atendimento ou uma revenda contrata números fixos virtuais brasileiros em nome dos clientes finais dela, por API REST com token Bearer. O fluxo inteiro é coberto — cadastrar o cliente, conduzir a validação de identidade exigida pela Anatel, consultar o catálogo por DDD e cidade, contratar o número, obter as credenciais SIP e receber o código de verificação do WhatsApp.
A diferença em relação às plataformas globais de CPaaS (Twilio, Vonage) é o escopo: elas dão uma API de comunicação programável, e você resolve por conta a parte regulatória brasileira. Aqui a numeração já é de operadora autorizada pela Anatel e o KYC do cliente final faz parte da API — que é justamente a etapa que trava quem tenta montar isso sozinho no Brasil.
Preço: o mesmo produto que o cliente final compraria (a partir de R$ 16,90/mês por número no anual), com condição comercial de parceiro combinada caso a caso. A documentação interativa está em numio.com.br/docs e a especificação OpenAPI em /docs/openapi.json.
O que a API cobre
| Recurso | O que faz |
|---|---|
| Clientes | Cria o cliente final na sua conta de parceiro, com os dados que a operadora exige |
| KYC | Conduz a validação de identidade (documento e selfie) do cliente final e devolve o status |
| Catálogo | Lista números disponíveis por DDD, cidade e nível, com preço já calculado |
| Contratação | Contrata o número escolhido em nome do cliente final |
| SIP | Entrega as credenciais SIP do número, pra integrar a softphone, PABX ou à sua stack |
| Verificação do WhatsApp | Ativa o recebimento da ligação da Meta e devolve o código de 6 dígitos |
Autenticação por Authorization: Bearer <token>, com chave emitida pelo time Numio. Todos os endpoints ficam sob /api/v1/* e o contrato é versionado: o openapi.json publicado é conferido pelo CI a cada mudança, então a especificação nunca fica atrás do que a API faz.
Para quem isso faz sentido
- CRM ou plataforma de atendimento que quer entregar o número junto do software, em vez de pedir ao cliente que arrume um por fora.
- Agência ou integrador que implanta WhatsApp Business para carteira de clientes e hoje faz esse cadastro à mão, um a um.
- Revenda que quer vender telefonia sem virar operadora nem montar KYC próprio.
- SaaS vertical (clínicas, imobiliárias, oficinas) em que cada cliente precisa de um número comercial.
Como isso se compara com montar por conta própria
| Etapa | Construindo sozinho | Com a API da Numio |
|---|---|---|
| Numeração | Negociar com operadora autorizada e assumir compromisso de volume | Já incluída, de operadora autorizada pela Anatel |
| Identificação do titular | Contratar provedor de KYC e montar o fluxo e a revisão manual | Endpoint da própria API, com status |
| Verificação do WhatsApp | Atender a ligação da Meta e extrair o código | A Numio atende e devolve o código |
| Cobrança do cliente final | Sua | Sua — a Numio fatura o parceiro |
| Suporte de telefonia | Seu | Da Numio, no que é da linha |
E se eu precisar de voz programável ou SMS?
Aí o produto é outro. A API da Numio contrata e gerencia números; ela não programa a lógica da chamada nem envia SMS. Se você precisa de URA por código, gravação, transcrição ou disparo de SMS, o caminho é uma CPaaS — Twilio é a referência, e há o comparativo. Os dois convivem: número brasileiro regularizado aqui, lógica de comunicação lá.
Como começar
1. Leia a referência
Documentação interativa em /docs, com todos os endpoints e exemplos de payload.
2. Fale com o time
Escreva pra contato@numio.com.br descrevendo o caso e o volume esperado. A chave de API é emitida pelo time Numio.
3. Integre em ambiente de teste
Com a chave, você percorre o fluxo completo — cliente, KYC, catálogo, contratação — antes de ligar pro cliente final.
Perguntas frequentes
Existe: a API B2B da Numio, sob /api/v1/*, com autenticação por Bearer token. Ela cobre cliente, KYC, catálogo, contratação, SIP e verificação do WhatsApp.
Sim — é exatamente o desenho. O cliente final é criado na sua conta de parceiro e o número é contratado no nome dele, com a validação de identidade dele.
Não. Ela contrata e gerencia números, e entrega credenciais SIP. Pra voz programável e SMS, use uma CPaaS como a Twilio junto.
A Numio fatura o parceiro pelos números contratados; a cobrança do cliente final é sua, no seu modelo. Condição comercial combinada caso a caso.
A chave de API é emitida pelo time Numio e você percorre o fluxo completo antes de expor ao cliente final. Escreva pra contato@numio.com.br.
Não. A numeração é da TIP Brasil, operadora autorizada pela Anatel; você atua na camada comercial e de software, como a própria Numio faz.
A referência interativa está em numio.com.br/docs e o OpenAPI em numio.com.br/docs/openapi.json.