Resumir contenido con:
Desde el 7 de octubre de 2026, puedes conectar un número activo de Zadarma a través del flujo de trabajo de importación de operador de Famulor. El paso más importante ocurre antes de la importación: decide si el número debe dirigirse directamente a un asistente de IA o si tu centralita (PBX) de Zadarma existente debe seguir controlando el flujo de llamadas. La importación automática y el enrutamiento manual mediante PBX resuelven problemas distintos.
Puntos clave
- La importación automática está diseñada para un número SIP directo activo que no esté vinculado a la PBX de Zadarma.
- Cada número importado utiliza su propia conexión y un inicio de sesión SIP dedicado.
- Si la PBX existente debe seguir gestionando horarios, colas o extensiones, utiliza la ruta manual de PBX documentada.
- Una clave API y un secreto API no son credenciales SIP.
- Prueba las llamadas entrantes y salientes, el audio bidireccional, el identificador de llamadas y las transferencias por separado.
Qué gestiona la nueva importación de Zadarma
El nuevo flujo de trabajo conecta tu cuenta de Zadarma, carga los números elegibles y crea la configuración de enrutamiento SIP para el número seleccionado. Según el registro de cambios de Famulor del 7 de octubre de 2026, seleccionas una región SIP y asignas un asistente después de la importación. Los mismos flujos de trabajo de operador también están disponibles a través de la API pública, MCP y la CLI de Famulor.
Esto es más limitado que una migración completa de PBX. La importación no configura el reenvío de la PBX de Zadarma ni los SMS. Además, utiliza una conexión por número activo, por lo que un número adicional requiere otra conexión.
Ese enfoque distingue esta guía de la introducción más amplia al BYOC con Famulor. La cuestión aquí no es si puedes usar un número existente, sino qué ruta de enrutamiento de Zadarma se ajusta al flujo de llamadas actual.
¿Importación automática o conexión manual?
Elige el camino según qué sistema deba controlar el flujo de llamadas. La guía de Zadarma de Famulor documenta tres enfoques.
| Enfoque | Ideal para | Impacto en el enrutamiento | ¿Quién gestiona los detalles? |
|---|---|---|---|
| Importación automática de operador | Un número SIP directo que debe asignarse a un asistente de Famulor | La importación reemplaza el destino SIP de ese número | La conexión gestiona el inicio de sesión SIP, la región y el enrutamiento |
| SIP directo manual | Quieres configurar y controlar el destino SIP tú mismo | Introduces el host SIP de Famulor como destino externo | Tu equipo de telefonía |
| Extensión de PBX manual | La PBX de Zadarma debe mantener sus colas, horarios o condiciones de reenvío | La PBX reenvía la extensión elegida a un URI SIP externo | Tu PBX junto con el enlace troncal SIP de Famulor |
No utilices la importación automática para un número cuyo escenario de PBX existente deba permanecer sin cambios. La importación reemplaza la asignación SIP directa. Para flujos mixtos de humanos e IA, una extensión de PBX manual suele ser la arquitectura documentada más adecuada.
Requisitos previos antes de la importación
Comprueba primero el lado de la telefonía en Zadarma. Esto evita que una conexión API válida falle más tarde porque el número seleccionado o el inicio de sesión SIP no se ajusten al flujo de trabajo.
- Número virtual activo: El número debe estar activo y cualquier modo de prueba debe estar desactivado.
- Inicio de sesión SIP directo: Para la importación automática, el inicio de sesión SIP no debe estar vinculado a la PBX virtual.
- Espacio de inicio de sesión disponible: Mantén libre un espacio de inicio de sesión SIP. Zadarma puede requerir una recarga inicial y un número conectado antes de permitir otro inicio de sesión.
- Saldo y permisos de salida: Las pruebas de salida requieren saldo y permiso para el destino.
- Acceso a la API: En Zadarma, abre Ajustes → Integraciones y API → Claves y API, luego copia la clave y el secreto por separado.
La documentación oficial de la API de Zadarma confirma que las solicitudes de API se autorizan con una clave de usuario y una firma. Trata ambos valores como credenciales. No pertenecen a un prompt del sistema del asistente, a una base de conocimientos ni a un informe de pruebas.
El acceso a la API no es acceso SIP
Esta distinción evita una clase común de errores de configuración:
- La clave API y el secreto API permiten que la importación inspeccione la cuenta de Zadarma, enumere los números disponibles y cree la conexión.
- El inicio de sesión SIP y la contraseña SIP autentican las llamadas salientes en una ruta de SIP directo manual o de PBX.
- El inicio de sesión de extensión de PBX utiliza el inicio de sesión completo de Zadarma en lugar de solo el número de extensión corto.
Almacena estos valores solo en los campos de conexión designados, nunca en instrucciones conversacionales.
Importar el número de Zadarma automáticamente
La ruta automática se ajusta a un número que debe dirigirse directamente a Famulor.
1. Abre el flujo de trabajo de conexión
En Famulor, ve a Ajustes → Números de teléfono → Añadir un número → Importar desde tu operador → Zadarma. Dale a la conexión un nombre claro, especialmente cuando una agencia gestione números para varios clientes.
2. Añade credenciales y selecciona una región
Introduce la clave API y el secreto en sus campos separados. Luego selecciona la región SIP. Esa región determina el punto final de señalización entrante, por lo que cambiarla más tarde debería activar una nueva prueba de ambas direcciones de llamada.
3. Carga la lista de números
Carga los números desde la cuenta de Zadarma. La interfaz identifica si un número está activo, ya importado o enrutado a otro lugar. Selecciona un número activo elegible.
4. Completa la importación y asigna un asistente
Importa un número por conexión. El flujo de trabajo crea un inicio de sesión SIP dedicado y establece el identificador de llamadas salientes fijo para esa conexión. Asigna el asistente previsto después de que se complete la importación.
5. Prueba antes del uso en producción
Realiza al menos una llamada de prueba entrante y una saliente utilizando un destino que controles. No te detengas después de escuchar el tono de llamada. Confirma el audio bidireccional, el identificador de llamadas mostrado, el registro del historial y cada ruta de transferencia que se espera que utilice el asistente.
Ejemplo práctico: gestión de propiedades con una centralita existente
Una empresa de gestión de propiedades utiliza un número principal de Zadarma muy conocido. Durante el horario comercial, una cola de PBX distribuye las llamadas al equipo. Fuera de horario, un asistente de IA debe capturar problemas de mantenimiento, estructurar los detalles de la devolución de llamada y enviar las emergencias reales al servicio de guardia.
La importación automática del número principal no sería la primera opción porque reemplaza el destino SIP directo. El enfoque de PBX documentado preserva el flujo existente:
- El número principal permanece asignado al escenario de PBX de Zadarma existente.
- Una extensión de PBX se convierte en la ruta hacia el asistente de IA.
- La PBX reenvía al URI SIP externo de Famulor bajo la condición de horario o cola elegida.
- El asistente de Famulor recibe solo las llamadas previstas.
- Una prueba de transferencia separada valida el traspaso al servicio de guardia.
Zadarma documenta el enrutamiento de URI SIP de servidor externo tanto para números directos como para extensiones de PBX en sus instrucciones oficiales de enrutamiento. Toma siempre el destino exacto de Famulor y las direcciones de señalización actuales desde la interfaz de Famulor o la guía del proveedor actual.
Para un tutorial más amplio que cubra 3CX, STARFACE y Asterisk, utiliza la guía para conectar un agente de voz de IA a una PBX existente. Este artículo permanece intencionalmente específico para Zadarma.
Matriz de pruebas de producción
Una llamada exitosa no es una prueba de telefonía completa. Utiliza una matriz corta que aísle cada ruta.
| Prueba | Resultado esperado | ¿Por qué probarlo por separado? |
|---|---|---|
| Llamada entrante | El asistente correcto responde y el audio funciona en ambos sentidos | Confirma el enrutamiento entrante y la ruta de medios |
| Llamada saliente | El destino suena, el audio funciona y aparece el identificador de llamadas correcto | Utiliza sus propias credenciales, saldo y permiso de destino |
| Ocupado o sin respuesta | Se produce la alternativa definida | Evita callejones sin salida silenciosos |
| Transferencia | El destino recibe la llamada y ambas partes pueden escucharse | El éxito de la entrada no prueba el soporte de transferencia |
| Formato de número | El DID público y el identificador de llamadas usan formato internacional con + |
Evita errores de mapeo y presentación |
| Historial | La llamada de prueba aparece bajo el asistente correcto | Admite diagnósticos posteriores |
Si una prueba falla, comienza con Solución de problemas en la conexión del operador y confirma que elegiste la ruta SIP prevista. Según la guía del proveedor de Famulor, una extensión que se muestra como "desconectada" no prueba por sí misma que el reenvío externo haya fallado.
Límites, privacidad y notas de telefonía
La importación de Zadarma automatiza el enrutamiento, no toda la estrategia de telefonía.
- La PBX sigue siendo una opción de arquitectura separada: La importación automática y una extensión de PBX son rutas alternativas. La importación no recrea un escenario de PBX existente.
- Los SMS no están incluidos: La importación actual de Zadarma no configura los SMS de Zadarma.
- Varios números requieren varias conexiones: Planifica la denominación, la propiedad y las pruebas por número.
- El identificador de llamadas no es arbitrario: Utiliza el número público asociado a la conexión y confirma su presentación con un destino de prueba controlado.
- La grabación y el consentimiento se configuran por separado: Habilita la grabación solo después de revisar la base legal y los ajustes del asistente para el uso previsto. La guía de consentimiento y calidad de conversación de Famulor describe los controles relevantes.
- Los controles del producto no son asesoramiento legal: La documentación de Consentimiento y Cumplimiento establece que la jurisdicción, el propósito de la divulgación y el canal de comunicación aún requieren una revisión legal por separado.
Documenta quién posee la conexión del operador, qué número afecta y qué enrutamiento existía antes de la importación. Ese registro hace que una reversión posterior sea más fácil de entender.
Planifica la reversión antes de necesitarla
No elimines un número de producción inesperadamente durante las operaciones en vivo. Decide a dónde deben ir las llamadas después y reserva una ventana de prueba controlada.
El registro de cambios actual dice que eliminar un número de Zadarma importado automáticamente restaura su destino SIP directo anterior mientras preserva los cambios de enrutamiento posteriores realizados en Zadarma. Aun así, llama a la ruta restaurada desde un teléfono externo. El estado de la cuenta, las reglas de la PBX o los ajustes del operador pueden haber cambiado independientemente de Famulor.
Conclusión
La nueva importación de Zadarma reduce el trabajo manual de SIP para un número directo y dedicado. Su valor real depende de la decisión de enrutamiento tomada primero: importación automática para asignación directa, SIP directo manual para enrutamiento gestionado por operador, o una extensión de PBX cuando un flujo de llamadas humano existente debe mantener el control.
Verifica las credenciales, el estado del número y la asignación SIP antes de la importación. Después, prueba ambas direcciones de llamada y cada ruta de transferencia. Eso produce una transición trazable en lugar de un corte arriesgado de un solo paso.
Preguntas frecuentes
¿Puedo importar automáticamente un número vinculado a una PBX de Zadarma?
La importación automática está documentada para un número SIP directo activo cuyo inicio de sesión SIP no esté vinculado a la PBX. Utiliza la ruta manual de PBX cuando el escenario de PBX existente deba permanecer en su lugar.
¿Puede una conexión importar varios números de Zadarma?
No. El flujo de trabajo actual importa un número activo por conexión. Crea otra conexión para cada número adicional.
¿La importación configura los SMS?
No. La importación actual de Zadarma configura el enrutamiento de voz, no el reenvío de la PBX de Zadarma ni los SMS.
¿Es suficiente una prueba de entrada exitosa?
No. Prueba las llamadas salientes, el identificador de llamadas y las transferencias por separado porque utilizan diferentes credenciales y rutas de enrutamiento.
¿Qué sucede cuando elimino el número importado?
Según el registro de cambios, se restaura el destino SIP directo anterior. Prueba esa ruta restaurada con una llamada externa después.
Autor en Famulor
