Este módulo permite el uso de VOIP directamente desde Odoo.
Se basa en SIP.js para conectarse al PBX usando un websocket directamente desde el navegador.
El servidor de Odoo no se conectará directamente al servidor PBX, pero tendrá usuarios y contraseñas almacenados.
Para usar este módulo, necesita tener un servidor PBX que permita conexión websocket. De lo contrario, necesita usar un proxy que será el puente entre Odoo y PBX. La conexión websocket es necesaria porque los navegadores prefieren este tipo de conexiones. Además, esta es una conexión estándar definida en el RFC 7118 por IETF. Varios servidores PBX admiten este protocolo.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 19.0Realiza y recibe llamadas telefónicas directamente dentro de Odoo usando un softphone basado en web conectado a tu PBX. El historial de llamadas, los contactos y las actividades telefónicas están disponibles en el softphone, y las llamadas se pueden registrar automáticamente.
Este módulo añade un softphone a Odoo para que los usuarios puedan realizar y responder llamadas desde el navegador sin salir de Odoo. Cada usuario se configura con un servidor PBX, un nombre de usuario y una contraseña en su formulario de usuario, bajo una nueva pestaña VOIP.
Un pequeño widget de teléfono aparece en la barra superior. Desde él los usuarios pueden marcar números con un teclado numérico, buscar contactos y llamadas recientes, ver actividades telefónicas, aceptar, rechazar, colgar, silenciar, poner en espera y transferir llamadas. Hacer clic en un número de teléfono en un contacto o en un campo de teléfono puede iniciar una llamada.
Cada llamada se almacena como un registro voip.call con número de teléfono, dirección (entrante/saliente), estado (calling, ongoing, terminated, rejected, missed, aborted), fechas de inicio y fin, el usuario responsable y el contacto relacionado. Si el número coincide con un contacto existente, la llamada se vincula automáticamente. Una lista de Calls está disponible bajo el menú Technical.
Los servidores PBX se gestionan en un modelo voip.pbx con nombre, dominio, servidor websocket y entorno (test o production). Solo los administradores del sistema pueden crear o modificar servidores PBX; todos los usuarios pueden leerlos. Las llamadas solo se conectan realmente cuando el PBX está configurado en modo production.
El módulo también añade un campo Main Contact en las actividades y en los registros que tienen un contacto, para que el softphone pueda mostrar la persona correcta para las actividades telefónicas.
Depende de
Menús que añade
Modelos y campos (7)
- ir.http · amplía un modelo existente
- voip.pbx · modelo nuevomode (Environment), name, domain, ws_server
- res.users · amplía un modelo existentevoip_pbx_id, voip_password, voip_username
- voip.call · modelo nuevostate, pbx_id, user_id, end_date, type_call, partner_id, start_date, phone_number, activity_name
- res.partner · amplía un modelo existente
- mail.activity · amplía un modelo existentemain_partner, main_partner_id (Main Contact)
- mail.activity.mixin · amplía un modelo existenteactivity_main_partner_id (Main Contact)
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 3 confirmadas, 6 sin información de 9 versiones.
Fuentes · Odoo 17.0
Confirmado el 2026-11-03 en la rama 17.0 de OCA/connector-telephony.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Configuración
Fuente · Odoo 19.0Crear la conexión PBX
- Acceder en modo Debug.
- Ir a
Settings > Technical > Discuss > PBX Servers. - Crear un servidor PBX y definir el nombre de dominio y el enlace websocket.
Puedes configurarlo como Test o Production. El entorno de prueba nunca contactará con el servidor PBX.
Configurar usuarios
Para cada usuario, necesitamos definir su servidor PBX, usuario y contraseña si queremos que pueda acceder al servidor PBX y realizar llamadas. Para ello, tenemos dos opciones:
- Los usuarios administradores pueden definir la información directamente en el formulario de usuario para cada usuario. Para ello,
ir a Settings > Users & Companies > Users y acceder a la pestaña VOIP y establecer la información.
- Por otro lado, cada usuario puede ir a Preferencias y modificar la información en la pestaña VOIP.
Automáticamente, el sistema iniciará sesión en el servidor PBX una vez que entremos en odoo con nuestro usuario. Si estamos en un entorno de prueba, no se realiza el inicio de sesión y las librerías de SIP no se cargan.
Una vez que hemos iniciado sesión, podemos usar el widget de VOIP para llamar directamente. Para abrir todos los selectores, podemos pulsar el botón del softphone en la barra superior...
...y se abrirá el widget inferior.
El widget se puede ocultar haciendo clic en la barra superior.
Si volvemos a hacer clic en la barra superior del widget, este volverá a aparecer.
Podemos realizar una llamada de 2 formas:
- Haciendo clic en el número del partner en la vista del partner, que aparece en verde.
- Abriendo el teclado numérico situado en la parte inferior izquierda del widget, introduciendo el número deseado,
y haciendo clic en el botón de llamada situado en la parte inferior derecha del widget. Dentro de una llamada, podemos transferir la llamada, finalizar la llamada, silenciar la llamada y poner la llamada en espera.
El widget ofrece 3 secciones:
- Llamadas recientes: Aquí tenemos una lista de las últimas llamadas realizadas, junto con información adicional de la llamada, como la fecha y hora de la llamada, el estado o la duración.
- Actividades de llamada: Aquí tenemos una lista de las actividades de llamada asignadas a nosotros en cualquier documento de Odoo (crm.lead, sale.order...) que ha caducado o está a punto de caducar y necesita completarse.
- Contactos: Por último, tenemos acceso rápido a todos los partners almacenados en nuestro Odoo que tienen un número de teléfono configurado.
Hacer clic en cualquier registro de estas tres secciones nos da acceso al partner relacionado, lo que nos permite ver su información y realizar una llamada.
En la vista del partner del widget, podemos realizar tres acciones:
- Enviar un correo electrónico al partner.
- Acceder al formulario del partner en Odoo.
- Programar una actividad.
Si el partner es desconocido y no está almacenado en Odoo, algunas acciones pueden no estar disponibles. Esto puede ocurrir al acceder a una llamada reciente realizada a un contacto que no está almacenado, por ejemplo. Sin embargo, en este caso, permitimos la acción de almacenar el contacto en Odoo desde llamadas recientes, haciendo clic en el botón del icono más.
Además, si accedemos a un contacto a través de la sección de actividades, tenemos cuatro acciones más disponibles:
- Ir al documento relacionado, como un lead o una venta.
- Marcar la actividad como realizada.
- Editar la actividad.
- Cancelar la actividad.
En cualquier pestaña, podemos realizar una búsqueda escribiendo una palabra clave en la barra de búsqueda, como el nombre del contacto o el número de teléfono.
Además, el sistema permite recibir llamadas. En ese caso, el sistema intentará encontrar el partner relacionado y abrirá el widget automáticamente.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.