Skip to main content
POST
Crear troncal SIP
API de Famulor 1.0 (legado). Esta página se aplica únicamente a Famulor 1.0 (app.famulor.de) y se conserva por compatibilidad. Para la plataforma actual, usa la referencia de la API de Famulor 2.0.
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 saliente
  • ip - Incluye en la lista blanca direcciones IP específicas (requiere allowed_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:
  1. 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
  2. Aprovisiona una troncal saliente, usando la dirección SIP y las credenciales que proporcionaste, opcionalmente a través del proxy saliente
Si el aprovisionamiento falla, la troncal SIP no se guarda y se devuelve un error 500.

Próximos pasos

Después de crear una troncal SIP, asígnala a un asistente de IA: