Desplegar
Tu propio trunk SIP
Registrar un número en un trunk nuevo
POST/v1/phones/sip conecta el trunk y registra el número en una sola petición.
{
"phoneNumber": "+33187654321",
"name": "acme-sip",
"terminationUri": "sip.example.com",
"transport": 1,
"sipUsername": "acme",
"sipPassword": "your-sip-password",
"requireInboundAuth": true,
"agentId": "550e8400-e29b-41d4-a716-446655440000"
}| Campo | Significado |
|---|---|
terminationUri | Adónde envía CallShift tus llamadas salientes |
transport | 1 UDP, 2 TCP, 3 TLS |
sipUsername, sipPassword | Las credenciales que espera tu operador |
requireInboundAuth | Genera credenciales que tu operador debe enviar en las llamadas entrantes (desactivado por defecto) |
sipTrunkId | Añade el número a un trunk existente en lugar de crear uno; en ese caso, se ignoran los campos del trunk |
Enrutar las llamadas entrantes
Cada trunk tiene su propia conexión entrante autenticada. Su URI de originación y sus credenciales, que configuras en tu operador, están en la sección Connection details del trunk, en app.callshift.ai/phone-numbers. Después asigna el agente al número.
Llamadas por segundo
El límite de llamadas por segundo (callsPerSecond) pertenece al trunk y lo comparten todos sus números, y todas las campañas que llaman desde ellos. GET/v1/trunks lo devuelve; se cambia en el panel. Suele ser lo que marca el ritmo de una campaña, más que el número de líneas: el simulador de campañas de llamadas salientes calcula cuánto durará la tuya.
Tu operador
Un operador es compatible con CallShift si envía las llamadas de un número a una URI SIP; si solo las entrega a un equipo registrado en la línea, no lo es. Las secciones siguientes indican, operador por operador, qué hay que copiar de un lado al otro.
Netelip
Necesitas una Línea SIP de Netelip, un servicio sin coste que se activa en el panel, y un número virtual: es la vía que Netelip documenta para las plataformas de voz con IA (guía de Netelip).
- Credenciales. El usuario es tu número de Netelip en formato
+34; la contraseña, la de tu Línea SIP, que aparece en el panel, en Línea SIP › Configurador de dispositivos. - Servidor. El servidor SIP de tu Línea SIP aparece en el panel; si no lo encuentras, pídeselo al soporte de Netelip.
- CallShift. Registra el número en un trunk nuevo (más arriba), con los valores de la tabla siguiente.
- Llamadas entrantes. En el panel, Configuración › Números virtuales, elige el número y, como destino, Servidor SIP, con la URI de originación que aparece en la sección Connection details del trunk. Activa Añadir al número E.164 el signo “+”, para que el número llegue tal y como lo registraste (guía de Netelip).
| Campo | De Netelip |
|---|---|
phoneNumber | Tu número de Netelip, en formato E.164 (+34911234567) |
terminationUri | El servidor SIP de tu Línea SIP, tal y como aparece en el panel |
transport | 1 (UDP), el que indica Netelip |
sipUsername | Tu número de Netelip, en formato +34 |
sipPassword | La contraseña de tu Línea SIP |
requireInboundAuth | false: Netelip no envía credenciales con las llamadas entrantes |
- Identificador de llamada. Por defecto, la Línea SIP llama con el número oculto: elige tu número en Línea SIP › Identificador de llamada (guía de Netelip).
- Llamadas simultáneas. De 1 a 30 por Línea SIP, en el menú Llamadas simultáneas. El saldo prepago se reparte entre los canales activos: con muchos canales y poco saldo, las llamadas salientes se bloquean.
- Netelip factura las llamadas salientes según el destino. Su soporte: 900 525 900.
Twilio Elastic SIP Trunking
Los números de una cuenta de Twilio no necesitan trunk: es más sencillo importarlos; consulta Números de teléfono. El trunk sirve para los números que Twilio enruta por Elastic SIP Trunking. En la consola de Twilio, Elastic SIP Trunking › Trunks, crea un trunk y después (guía de Twilio):
- Termination. Elige la Termination SIP URI del trunk,
nombre.pstn.twilio.com, y en Authentication crea una lista de credenciales (credential list) con un usuario y una contraseña. Para que las llamadas no salgan de Europa, usa el punto de presencia de Dublín o el de Fráncfort:nombre.pstn.dublin.twilio.comonombre.pstn.frankfurt.twilio.com. - Números. Asocia el número de Twilio al trunk.
- CallShift. Registra el número en un trunk nuevo (más arriba), con los valores de la tabla siguiente.
- Origination. De vuelta en Twilio, añade una Origination SIP URI:
sip:seguido de la URI de originación que aparece en la sección Connection details del trunk de CallShift.
| Campo | De Twilio |
|---|---|
phoneNumber | El número de Twilio, en formato E.164 (+34911234567) |
terminationUri | La Termination SIP URI, por ejemplo acme.pstn.twilio.com |
transport | 1 (UDP), el valor por defecto de Twilio; 3 (TLS) si activas Secure Trunking |
sipUsername, sipPassword | El usuario y la contraseña de la lista de credenciales |
requireInboundAuth | false: Twilio no envía credenciales con las llamadas entrantes |
- Identificador de llamada. Twilio rechaza una llamada saliente cuyo identificador no sea un número de la cuenta ni un número verificado: el trunk llama desde su número de Twilio.
- Formato E.164. Twilio rechaza un número sin su
+(400 Bad Request) y entrega con él los números entrantes. - Llamadas por segundo. Por defecto, un trunk de Twilio hace 1 llamada por segundo; puedes subir a 5 en sus ajustes de Termination y pedir más al equipo comercial de Twilio (guía de Twilio). Pon el mismo límite en el trunk de CallShift: Twilio rechaza las llamadas que lo superan.
Eliminar un número
DELETE/v1/phones/sip/{phoneId} elimina el número y lo desvincula de su trunk.
