Crear troncal SIP
Trunks SIP
Crear troncal SIP
Crea una nueva troncal SIP con credenciales, dirección y configuración de proxy
POST
Crear troncal SIP
Este endpoint crea una nueva troncal SIP. La plataforma aprovisiona automáticamente las troncales entrante y saliente en la infraestructura de voz utilizando las credenciales proporcionadas.
Cuerpo de la solicitud
string
requerido
El tipo de troncal SIP:
extension para una extensión SIP, o number para un número de teléfono (DID). Esto determina el formato esperado del campo phone_number.string
requerido
La extensión SIP (1-15 caracteres, p. ej.,
1000) cuando sip_trunk_type es extension, o un número de teléfono en formato E.164 (p. ej., +14155551234) cuando sip_trunk_type es number.string
Una etiqueta corta y descriptiva para la troncal (p. ej., «Proveedor X — Principal»). Máximo 50 caracteres.
string
requerido
Nombre de usuario para la autenticación SIP (3-128 caracteres)
string
requerido
Contraseña para la autenticación SIP (mínimo 3 caracteres)
string
requerido
La dirección del servidor SIP sin puerto (p. ej.,
sip.provider.com)string
requerido
El formato del número de llamada saliente:
+e164- Internacional con prefijo+(p. ej.,+12025550123)e164- Internacional sin prefijo+(p. ej.,12025550123)national- Formato nacional sin código de país (p. ej.,0741926265)
string
requerido
Cómo se autentican las llamadas entrantes:
auth- Usa el mismo nombre de usuario y contraseña SIP configurados para el tráfico salienteip- Incluye en la lista blanca direcciones IP específicas (requiereallowed_inbound_ips)
array
Array de direcciones IP autorizadas a enviar llamadas entrantes. Obligatorio cuando
inbound_authorization_type es ip. Debe contener al menos una dirección IP válida.string
requerido
Código de país ISO 3166-2 donde se encuentra la troncal SIP (p. ej.,
US, GB, DE). Cuando sip_trunk_type es number, el país se detecta automáticamente a partir del número de teléfono si es posible.boolean
Enruta las llamadas salientes a través de una dirección IP fija. Predeterminado:
false. Actívalo solo si tu proveedor SIP requiere autenticación basada en IP para el tráfico saliente.Respuesta
string
Mensaje de éxito
object
El objeto de troncal SIP creado (los mismos campos que Obtener troncal SIP)
Qué ocurre después de la creación
Al crear una troncal SIP, la plataforma automáticamente:- Aprovisiona una troncal entrante en la infraestructura de voz, usando autenticación por nombre de usuario/contraseña o basada en IP según tu configuración de
inbound_authorization_type - Aprovisiona una troncal saliente, usando la dirección SIP y las credenciales que proporcionaste, opcionalmente a través del proxy saliente
500.
Próximos pasos
Después de crear una troncal SIP, asígnala a un asistente de IA:- Crear asistente - Usa el parámetro
phone_number_id - Actualizar asistente - Cambia el número de teléfono en un asistente existente