Pular para o conteúdo principal
POST
/
api
/
v1
/
sip-trunks
curl -X POST "https://app.talkover.ai/api/v1/sip-trunks" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Primary Carrier — US",
    "provider_name": "carrier-x",
    "domain": "sip.carrier-x.com",
    "username": "user_42",
    "password": "secret-password",
    "port": 5061,
    "transport": "tls"
  }'

{
  "success": true,
  "data": {
    "id": "trunk-uuid-1",
    "name": "Primary Carrier — US",
    "provider_name": "carrier-x",
    "domain": "sip.carrier-x.com",
    "transport": "tls",
    "port": 5061,
    "is_active": false,
    "is_verified": false,
    "created_at": "2024-01-15T14:00:00Z"
  }
}

​
Criar SIP Trunk

Registra um SIP Trunk personalizado para o seu ambiente. Após criado, é necessário verificar o trunk via Verificar SIP Trunk antes que ele possa ser utilizado.
Este recurso está disponível apenas em planos onde allow_custom_sip_trunks está habilitado.

​
Endpoint

POST /api/v1/sip-trunks

​
Cabeçalhos da requisição

​
Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here
​
Content-Type
string
obrigatório
Deve ser definido como application/json

​
Corpo da requisição

​
name
string
obrigatório
Nome legível do trunk. Máximo de 255 caracteres.
​
provider_name
string
obrigatório
Identificador da sua operadora ou provedor SIP.
​
domain
string
obrigatório
Domínio SIP ou host do proxy (ex: sip.carrier-x.com).
​
username
string
obrigatório
Nome de usuário para autenticação SIP.
​
password
string
obrigatório
Senha para autenticação SIP. Armazenada de forma criptografada.
​
port
integer
Porta SIP. Faixa: 1–65535. O padrão depende do transporte (5060 UDP/TCP, 5061 TLS).
​
transport
string
Protocolo de transporte. Opções: udp, tcp, tls. Padrão: tls.
​
outbound_proxy
string
Host do proxy outbound opcional.
​
auth_realm
string
Realm de autenticação SIP opcional, caso a sua operadora exija.
​
is_active
boolean
Indica se o trunk está ativo. Padrão: false (você deve verificar antes de ativar).

​
Exemplos

curl -X POST "https://app.talkover.ai/api/v1/sip-trunks" \
  -H "Authorization: Bearer talq_your_environment_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Primary Carrier — US",
    "provider_name": "carrier-x",
    "domain": "sip.carrier-x.com",
    "username": "user_42",
    "password": "secret-password",
    "port": 5061,
    "transport": "tls"
  }'

​
Resposta

{
  "success": true,
  "data": {
    "id": "trunk-uuid-1",
    "name": "Primary Carrier — US",
    "provider_name": "carrier-x",
    "domain": "sip.carrier-x.com",
    "transport": "tls",
    "port": 5061,
    "is_active": false,
    "is_verified": false,
    "created_at": "2024-01-15T14:00:00Z"
  }
}

​
Observações

  • O password nunca é retornado nas respostas após a criação.
  • Execute Verificar SIP Trunk para testar a conectividade antes de ativar.