Skip to main content
POST
Criar tronco SIP
Este endpoint cria um novo tronco SIP. A plataforma provisiona automaticamente troncos de entrada e saída na infraestrutura de voz usando as credenciais fornecidas.

Parâmetros do Corpo

string
required
O tipo de tronco SIP: extension para uma extensão SIP, ou number para um número de telefone (DID). Isso determina o formato esperado do campo phone_number.
string
required
A extensão SIP (1-15 caracteres, por exemplo, 1000) quando sip_trunk_type é extension, ou um número de telefone no formato E.164 (por exemplo, +14155551234) quando sip_trunk_type é number.
string
Um rótulo curto e amigável para o tronco (por exemplo, “Provedor X — Principal”). Máximo de 50 caracteres.
string
required
Nome de usuário para autenticação SIP (3-128 caracteres)
string
required
Senha para autenticação SIP (mínimo de 3 caracteres)
string
required
O endereço do servidor SIP sem porta (por exemplo, sip.provider.com)
string
required
O formato do número de chamada de saída:
  • +e164 — Internacional com prefixo + (por exemplo, +12025550123)
  • e164 — Internacional sem prefixo + (por exemplo, 12025550123)
  • national — Formato nacional sem código do país (por exemplo, 0741926265)
string
required
Como as chamadas de entrada são autenticadas:
  • auth — Usa o mesmo nome de usuário e senha SIP configurados para saída
  • ip — Lista branca de endereços IP específicos (requer allowed_inbound_ips)
array
Array de endereços IP permitidos para enviar chamadas de entrada. Obrigatório quando inbound_authorization_type é ip. Deve conter pelo menos um endereço IP válido.
string
required
Código do país ISO 3166-2 onde o tronco SIP está localizado (por exemplo, US, GB, DE). Quando sip_trunk_type é number, o país é detectado automaticamente a partir do número de telefone, se possível.
boolean
Roteie chamadas de saída através de um endereço IP fixo. Padrão: false. Ative isso apenas se seu provedor SIP exigir autenticação baseada em IP para tráfego de saída.

Resposta

string
Mensagem de sucesso
object
O objeto do tronco SIP criado (mesmos campos que Obter tronco SIP)

O que acontece após a criação

Quando você cria um tronco SIP, a plataforma automaticamente:
  1. Provisiona um tronco de entrada na infraestrutura de voz — usando autenticação por nome de usuário/senha ou baseada em IP, dependendo da configuração do seu inbound_authorization_type
  2. Provisiona um tronco de saída — usando o endereço SIP e as credenciais que você forneceu, opcionalmente através do proxy de saída
Se o provisionamento falhar, o tronco SIP não é salvo e um erro 500 é retornado.

Próximos passos

Após criar um tronco SIP, atribua-o a um assistente de IA: