Integración de Llamadas SIP con WhatsApp

Resumen

WhatsApp ahora admite llamadas SIP a través de la API de WhatsApp Cloud, lo que permite realizar llamadas de voz utilizando SIP sobre TLS / SRTP.

Esto permite la integración nativa entre WhatsApp y 3CX, ampliando la integración existente, que solo incluía mensajería, para admitir también llamadas de voz de WhatsApp, que pueden desviarse a extensiones, colas, IVRs o Agentes IA de 3CX.

Tenga en cuenta que la implementación actual para llamadas de voz solo admitirá llamadas entrantes de WhatsApp a 3CX.

Requisitos Previos

  • Para habilitar WhatsApp SIP, se requiere una aplicación WhatsApp activa en el portal para Desarrolladores de Meta con permisos de mensajería para el número de teléfono comercial para el que se desea habilitar SIP.
  • Si aún no ha configurado lo anterior, siga los pasos que se explican en nuestra Guía de Integración de WhatsApp y obtenga su ID de Número de teléfono y su Token de Acceso de Usuario, tal y como se explica en la guía anterior, necesarios para autenticar las solicitudes requeridas a la API Graph de Meta para habilitar el SIP.
  • Dado que actualmente no es posible habilitar las Llamadas SIP en la aplicación WhatsApp a través del portal de interfaz de usuario de Meta, debe utilizar una herramienta de terceros, como Postman, para enviar solicitudes POST a la API Graph de Meta.
  • Para integrar varios números de teléfono de WhatsApp al mismo tiempo, cada número debe estar asociado a su propia Aplicación de WhatsApp dentro del portal Meta para Desarrolladores. El proceso de configuración que se detalla en esta guía, desde la creación de una Aplicación de WhatsApp hasta la configuración de la Troncal SIP en 3CX, debe repetirse para cada número de teléfono de WhatsApp que desee integrar.
  • Puede leer más en la Guía Oficial de WhatsApp SIP.

Paso 1: Crear una Aplicación de WhatsApp

  • Si ya tiene WhatsApp Messaging configurado en su 3CX, puede omitir este paso y obtener su ID de Número de teléfono y su Token de Acceso de Usuario desde su WhatsApp ya configurado en 3CX en Consola de Administración > Voz y Chat > Su Troncal de Mensajería WhatsApp.
  • Si no es así, siga los pasos que se explican en nuestra Guía de Integración de WhatsApp y obtenga su ID de Número de teléfono y su Token de Acceso de Usuario.

Paso 2: Habilitar SIP en su Número de WhatsApp

  • Envíe la siguiente solicitud POST a la API Graph de Meta utilizando curl o cualquier otra herramienta.
  • Puede importar el comando curl directamente a Postman navegando a "Archivo → Importar" y pegando:

curl -X POST "https://graph.facebook.com/v24.0/<PHONE_NUMBER_ID>/settings" \

  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>" \

  -H "Content-Type: application/json" \

  -d '{

    "calling": {

      "status": "ENABLED",

      "callback_permission_status": "ENABLED",

      "call_icon_visibility": "DEFAULT",

      "srtp_key_exchange_protocol": "SDES",

      "sip": {

        "status": "ENABLED",

        "servers": [

          {

            "hostname": "<YOUR_3CX_FQDN>",

            "port": <YOUR_SIPS_PORT>

          }

        ]

      }

    }

  }'

  • Asegúrese de sustituir lo siguiente por sus propios datos en el comando anterior antes de enviarlo:
  • <PHONE_NUMBER_ID> = El ID de Número de Teléfono que obtuvo en el Paso 1 anterior.
  • <YOUR_ACCESS_TOKEN> = El Token de Acceso de Usuario que obtuvo en el Paso 1 anterior.
  • <YOUR_3CX_FQDN> = El FQDN de su PBX 3CX; por ejemplo: mipbx.3cx.com.
  • <YOUR_SIPS_PORT> = Normalmente 5061 si su PBX utiliza los puertos predeterminados.
  • Si la solicitud se realiza correctamente:

{"success":true}

  • Debería obtener una respuesta positiva en curl.

Respuesta exitosa

  • O en Postman.

Paso 3: Verificar su Configuración SIP

  • Envíe la siguiente solicitud GET a la API Graph de Meta:

curl -X GET "https://graph.facebook.com/v17.0/<PHONE_NUMBER_ID>/settings?fields=calling&include_sip_credentials=true" \

  -H "Authorization: Bearer <YOUR_ACCESS_TOKEN>"

  • Asegúrese de sustituir la siguiente información por la suya propia en el comando anterior antes de enviarlo:
  • <PHONE_NUMBER_ID> = El ID de Número de Teléfono que obtuvo en el Paso 1 anterior.
  • <YOUR_ACCESS_TOKEN> = El Token de Acceso de Usuario que obtuvo en el Paso 1 anterior.
  • Si la solicitud se realiza correctamente, debería obtener una respuesta similar a la siguiente:

{

    "calling": {

        "status": "ENABLED",

        "call_icon_visibility": "DEFAULT",

        "callback_permission_status": "ENABLED",

        "srtp_key_exchange_protocol": "SDES",

        "sip": {

            "status": "ENABLED",

            "servers": [

                {

                    "app_id": 112233445566778,

                    "hostname": "pbx.3cx-example.com",

                    "port": 5061,

                    "sip_user_password": "aabbccddeeffgghhiijjkkllmmnnoopp"

                }

            ]

        }

    },

    "storage_configuration": {

        "status": "DEFAULT"

    }

}

  • En curl.

  • O en Postman.

Paso 4: Habilitar la Configuración de Llamadas en WhatsApp Business Manager

  • Si no aparece la opción Números de Teléfono, haga clic en Todas las herramientas.

Números de teléfono - WhatsApp

  • Abra la pestaña Configuración de Llamadas y asegúrese de haber habilitado estas opciones:
  • Permitir llamadas de voz.
  • Permitir devoluciones de llamadas.
  • Mostrar botones de llamada.

Paso 5: Crear una Troncal SIP en 3CX

Para crear su nueva Troncal SIP de WhatsApp:

  • Descargue la plantilla de WhatsApp desde aquí.
  • En la Consola de Administración de 3CX, vaya a la pestaña "Admin → Avanzado → Plantillas → Plantillas de proveedores".
  • Haga clic en el botón Importar Proveedor, seleccione la plantilla que descargó anteriormente y haga clic en el botón Importar:

Configuración de la plantilla de WhatsApp

  • Establezca un Nombre para su nueva Troncal SIP de WhatsApp.
  • Configure la ruta Predeterminada para las llamadas SIP entrantes de WhatsApp.
  • Desmarque la casilla Crear una regla de salida.
  • Establezca el Número Principal de la Troncal a su número de WhatsApp.
  • Deje todos los demás campos con sus valores predeterminados.
  • Haga clic en el botón Guardar.
  • Ahora podrá aceptar las llamadas entrantes de WhatsApp de su Número de WhatsApp y se transferirán al destino 3CX seleccionado.

También puede crear manualmente un Troncal SIP Genérica en 3CX, asegurándose de utilizar la siguiente configuración:

  • Tipo de Autenticación: Basado en IP.
  • Servidor: wa.meta.vc.
  • Puerto: Detección automática.
  • Protocolo de Transporte: TLS.
  • Modo SRTP: Forzado.
  • Códecs: OPUS.

Ver También

Última Actualización

Este documento se actualizó por última vez el 3 de Agosto de 2026

https://www.3cx.es/docs/integracion-llamadas-sip-whatsapp/