MediaCP Manual
Guía de integración WHMCS

Last updated hace 1 mes

Visión general

La integración con WHMCS le permite configurar planes de servicio para vender servicios de transmisión de audio y video con configuración automática y aprovisionamiento de cuentas de clientes y streaming.

Notas de la versión del módulo

El registro de cambios está disponible en GitHub.

Módulo WHMCS

Instalar el módulo más reciente

1. Asegúrese de tener la última versión de MediaCP

2. Descargue la última versión del módulo MediaCP para WHMCS

3. Extraiga el archivo .zip a su escritorio

4. Conéctese a su servidor WHMCS a través de FTP y navegue a [WHMCS]/modules/servers

5. Arrastre y suelte la carpeta mediacp desde su escritorio a su cliente FTP para cargar los archivos.

6. Ahora debería ver la carpeta mediacp dentro de su [WHMCS]ruta /modules/servers en el servidor ftp

Agregar un servidor en WHMCS

  1. Inicie sesión en WHMCS como administrador y navegue hasta
    Configuración del sistema.
  2. Seleccione Productos y servicios enel menú de la izquierda y luego seleccione la opción Servidores .
  3. Seleccione el botón + Agregar nuevo servidor en la parte superior de la página y complete el formulario.
  4. Seleccione
    Ir al modo avanzado
  5. Complete el formulario de acuerdo con los detalles a continuación:
    • Nombre : introduzca una etiqueta para este servidor.
    • Nombre de host: introduzca el dominio principal o el nombre de subdominio en el que está instalado MediaCP, como streaming.myserver.com
    • Dirección IP – ingrese la dirección IP del servidor MediaCP, esto será utilizado por WHMCS para validar el acceso a los puertos.
    • Dirección de estado del servidor – Esto se utiliza para proporcionar el estado de la red y la carga a WHMCS. MediaCP proporciona una URL especial para que la pegue en la configuración del servidor WHMCS. Para mostrar el estado en línea en WHMCS, primero debe asegurarse de que el puerto MediaCP 80 esté habilitado.

      El formato de la dirección de estado de WHMCS se describe a continuación, reemplazando yourdomain.com:2020 con el nombre de host y el puerto de MediaCP y
      {api-key}
      con su clave API de MediaCP.

      https://yourdomain.com:2020/whmcs-status/{api-key}/

      Ejemplo:

      https://demo.mediacp.net/whmcs-status/iMtTpHvVWMjMh8dZgn6n0Vqoq3aWyomKmp-KjMV9W5uY06eepH2Mxg==/
    • Módulo – Panel de control de medios
    • Nombre de usuario: nombre de usuario del administrador, el valor predeterminado es “admin”
    • Contraseña- Este campo no se utiliza.
    • Hash de acceso – Proporcione la clave API de MediaCP en este campo.
    • Seguro : marque esta casilla si HTTPS/SSL está configurado con MediaCP (activado predeterminado).
    • Puerto – El puerto principal que utiliza el software MediaCP. El valor predeterminado es 2020. Cambie sólo si ha configurado un puerto alternativo para MediaCP Web.
    • Servidores de nombres : el módulo MediaCP no requiere esta información.
  6. Presione el botón Guardar cambios para finalizar.

Creación de su primer producto

Ahora está listo para crear y configurar su primer producto para el MediaCP.

1. Vaya a Configuración -> Productos / Servicios. A continuación, haga clic en Crear un nuevo producto.

2. Seleccione Cuenta de alojamiento compartido y seleccione un grupo de productos y un nombre adecuados y haga clic en Continuar.

nuevo producto

3. Seleccione la pestaña Configuración del módulo y complete la configuración base como prefiera.

whmcs_module_settings

4. Presione Guardar cambios

Adicional

Opciones configurables

Puede permitir que sus clientes creen sus propios paquetes estableciendo Opciones configurables.

  1. Vaya aConfiguración -Productos/Servicios -Opciones configurables.
  2. Presiona Crear un nuevo grupo
  3. Configure el nombre del grupo y los productos asignados y, a continuación, pulse Agregar nueva opción configurable.
  4. Consulte la tabla siguiente para crear las opciones de paquete. Es importante que las opciones estén etiquetadas correctamente, puede optar por utilizar la opción configurable o alternativas para los nombres de opción.
Descripción de

opciones de

Servicio de Medios – ShoutcastShoutcast2 Shoutcast198Icecast Icecast 2Icecast2 KHIcecast KH Wowza Streaming Engine Flash Media Service Windows Media Servicios Fuente AutoDJ Shoutcast TranscoderV1 ShoutcastTranscoder V2 Ices0.4 (MP3)Ices 2.0 (OGG) Stream Transcoder V3 Alternativamente, puede establecer este valor en “Sí” y el módulo configurará automáticamente Shoutcast Transcoder V2.

de AutoDJ

Proxy de transmisión Proxy de transmisión

geográfico

Reencode

Conexiones Losoyenteslosespectadoresmáximan los usuarios los máximos de los visores máximos Valor numérico Introduzca un valor entre 0 y 9999. Bitrate Velocidad máxima de bits 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 400, 480, 560, 640, 720, 800, 920, 1024, 1280, 1536, 1792, 2048, 2560, 3072, 3584, 4096, 999999

Uso del disco Cuotade disco MB, GB o TB

Transferencia de datos Transferirancho de banda MB, GB o TB

Autenticación de transmisión Autenticación de flujo Autenticación de escucha Autenticación de flujo

de flujo

las opciones configurables
Mountpoints Valor numérico Número de puntos de montaje que incluirá el servicio Shoutcast o Icecast.
Debe ser un número entero.
Fuentes Valor numérico Número de fuentes de AutoDJ que se pueden aplicar a los puntos de montaje en los servicios de Shoutcast e Icecast.
Debe ser un número entero.

No
Habilitar o deshabilitar el proxy de transmisión HTTP/HTTPS en la cuenta
Bloqueo Bloqueo de país Geolock
No Permitir o no permitir el bloqueo geográfico de país Soporte en servicio
Fuente AutoDJ Reencode
No
ICES 0.4 SOLAMENTE
Introduzca sólo uno de los valores en la columna de opciones. Esto también puede contener “Kbps” al final del valor de la opción.
Especifique un valor que incluya MB, GB o TB. Por ejemplo: 100MB
Especifique un valor que incluya MB, GB o TB. Por ejemplo: 100MB
Informes históricos Informes
avanzados
Sí / No Habilita o deshabilita las capacidades de informes históricos. La pestaña uso estándar se mostrará en cualquier caso.
Autenticación Sí / No Icecast & Icecast Servicios KH SOLAMENTE
Habilita o deshabilita la función de autenticación de flujo de escucha.

Opciones de publicación de secuencias (Wowza y Flussonic)

Destinos de transmisión

en Facebook

en Youtube

de Periscope

Publicación

RTMP

Opción configurable

Alternativas

Opciones

Descripción

Publicación de transmisiones Sí / No Habilita todos los destinos de transmisión
Publicación Sí / No
Publicación Sí / No
Publicación Sí / No
de Twitch Sí / No
Shoutcast Publishing Sí / No
Publicación Icecast Sí / No
Publicación Sí / No

Wowza streaming Engine

Descripción de

opciones de

Transmisión en

en vivo

Autenticación en vivo – SíNo Wowza Streaming Engine SOLAMENTE.Perfiles de transcodificador Perfiles de transcodificador 160p

Lista delimitada por comas de perfiles

de transmisión Grabación de transmisión en

RTMPRTMP SupportRTMP ServiceYesNoEnable RTMP/RTSP links for Shoutcast & Icecast Services ONLY.
las opciones configurables
Tipo de servicio de tipo de medios Wowza Servicio
de medios Flash
vivo Transmisión
en vivo Estación
de TV de baja latencia
Transmisión bajo demanda Shoutcast
/Icecast Retransmisión de
cámara
nDVR AddOn nDVR nDVR
Playback

No
Wowza Streaming Engine SOLAMENTE.
240p 360p 480p 576p 720p 1080p 2160p

Passthru

de transcodificador .
Disponible con MediaCP 2.6 + Por ejemplo:
240p 360p, 576p 240p, 360p, 480p 480p, 750p, 1080p

Grabación vivo Sí no Motor de transmisión Wowza SOLAMENTE.

Flussonic Media Server

Service TypeService TypeLive StreamingTV StationOndemand Streaming
Opción configurable

Alternativas

Opciones

Descripción

Perfiles Transcodificador Perfiles Transcodificador 160p 240p 360p 480p 576p 720p 1080p 2160p

Passthru

Comma delimited list of transcoder profiles.

Available with MediaCP 2.6+

Por ejemplo:
240p
360p,576p
240p,360p,480p
480p,750p,1080p

nDVR AddOn nDVR Sí / No

Campos personalizados

Los campos personalizados permiten a los clientes introducir valores de texto específicos para algunas configuraciones.

de campo Tipo

/

Nombre de campo Descripción de validación
Cuadro de texto Nombre de publicación ^[a-zd_]{4,28}$/i Disponible para todos los tipos de servicio multimedia.
El cliente puede especificar el nombre de publicación deseado. Si no está disponible, el nombre se actualizará automáticamente.
Marque el campo obligatorio y muéstrelo en el formulario de pedido.
Shoutcast URL Text Box-WOWZA SERVICES ONLY.
El cliente puede especificar su URL de retransmisión de Shoutcast o URL de retransmisión de IPCAM.
Los nombres de campo alternativos pueden ser:
Dirección de retransmisión
URL
de Icecast URL
DE IPCAM Dirección IPCAM
Wowza VHost Drop Down-SOLO SERVICIOS DE WOWZA.
Solo administrador.
Campo obligatorio.
Formato:VHOST:IP:RTMP_PORT:Ejemplo:_defaultVHost_:

110.110.110.1:1935

Permitir al cliente especificar el nombre de publicación

Puede permitir que el cliente especifique su nombre de publicación preferido siguiendo estos pasos.

  1. Vaya a Configuración-Productos>/Servicios. A continuación, seleccione un producto MediaCP existente.
  2. Seleccione la pestaña Campos personalizados y Agregar nuevo campo personalizado con la siguiente configuración.
    • Nombre de campo -nombre de publicación
    • Tipo de campo -cuadro de texto
    • Validación: /^[a-zd_]{4,28}$/i
    • Comprobar campo obligatorio
    • Comprobar Mostrar en el formulario de pedido

whmcs_custom_field

Plantillas de correo electrónico

Transmisión de audio (Shoutcast / Icecast)

Puede utilizar las siguientes plantillas de correo electrónico para varios servicios.

SERVICIOS DE SHOUTCAST/ICECAST

POR FAVOR, LEA ESTE CORREO ELECTRÓNICO EN SU TOTALIDAD E IMPRÍELO PARA SUS REGISTROS

Dear {$client_name},

Gracias por su pedido de nosotros!

Su servicio Shoutcast ya se ha creado y este correo electrónico contiene toda la información que necesitará para comenzar a usar sus servicios.

Panel de control de hosting
Dirección: https://{$service_server_hostname}:2020/
Username: {$service_username}
Contraseña: {$service _ Password}

Información del servicio multimedia
Dirección del servicio: {$mediacp_host_address}
Puerto de servicio: {$mediacp_portbase}
Nombre de usuario de streaming: DJ
Contraseña de transmisión: {$service _ Password}

Dirección de administración: http://{$service _domain}/admin
Nombre de usuario: admin
Contraseña: {$service _ Password}

{foreach from=$service_config_options item=data} {$data.option}: {$data.value}
{/foreach}

Cómo transmitir a su nuevo servicio
1. Descargue e instale Winamp desde www.winamp.com
2. Descargue e instale Winamp Shoutcast DSP Plugin desde http://shoutcast.com/BroadcastNow
3. Ingrese su IP de servicio, puerto y contraseña en el complemento DSP de Shoutcast y luego presione conectar.

Gracias por elegirnos.

{$signature}

Transmisión de vídeo

Tenga en cuenta que esta plantilla supone que ha configurado el campo personalizado “Publicar nombre” como el primer campo personalizado.

POR FAVOR, LEA ESTE CORREO ELECTRÓNICO EN SU TOTALIDAD E IMPRÍELO PARA SUS REGISTROS

Dear {$client_name},

Gracias por su pedido de nosotros!

Su servicio multimedia ya ha sido creado y este correo electrónico contiene toda la información que necesitará para comenzar a usar sus servicios.

Panel de control de hosting
Dirección: https://{$service_server_hostname}:2020/
Username: {$service_username}
Contraseña: {$service _ Password}

Información del servicio multimedia
RTMP: rtmp://{$service_server_hostname}/{$service_custom_fields.0}/{$service_custom_fields.0}
RTSP: rtsp://{$service_server_hostname}/{$service_custom_fields.0}/{$service_custom_fields.0}

{foreach from=$service_config_options item=data} {$data.option}: {$data.value}
{/foreach}

Configuración de Live Encoder
URL del servidor: rtmp://{$service_server_hostname}/{$service_custom_fields.0}
Clave de secuencia: {$service_custom_fields.0}
Nombre de usuario: {$service _custom_fields. 0}
Contraseña: {$service _ Password}

Gracias por elegirnos.

{$signature}

Solución de problemas

Error en la solicitud: asegúrese de que se abra el puerto saliente del firewall y asegúrese de que se pueda resolver el dominio.

La razón más común para este error es que su servidor WHMCS no puede comunicarse con el MediaCP debido a que el puerto saliente 2020 está bloqueado de su servidor WHMCS.

Le recomendamos que siga los pasos a continuación:

  1. Compruebe que MediaCP está actualizado con la versión más reciente para garantizar la compatibilidad.
  2. Verifique que el nombre de host, el puerto y el modo SSL del servidor WHMCS coincidan exactamente con su instalación de MediaCP
  3. Verifique que el puerto de firewall SALIENTE 2020 esté en el servidor WHMCS, o comuníquese con su proveedor de alojamiento para completar esto.
  4. Pruebe la conexión de la API de MediaCP utilizando nuestra utilidad de prueba en línea. Si la prueba de la API es exitosa, entonces el problema es con el firewall de su servidor WHMCS. Si la prueba de API no se realiza correctamente, póngase en contacto con nosotros con la información de salida para obtener más información sobre la solución de problemas.

Error de transporte: no se pudo abrir el socket

Hay un problema de conexión entre su servidor WHMCS y el MediaCP. Siga la guía de solución de problemas anterior.

No es compatible con su versión de MediaCP. Actualice MediaCP a la versión 2.9.11, 2.10.7 o posterior.

Si ve este error al usar el botón Sincronizar dentro de WHMCS, significa:

  1. Su MediaCP no está actualizado; o
  2. Si MediaCP está actualizado, también podría significar que el puerto de salida 2000 o 2020 está siendo bloqueado por su firewall en el servidor WHMCS. Asegúrese de que este puerto esté abierto e inténtelo de nuevo.

Importación de cuentas MediaCP en WHMCS

MediaCP 2.9.11 y 2.10.7 introducen la capacidad de utilizar la herramienta de sincronización de servidores WHMCS.

  1. Inicie sesión en WHMCS y navegue a la página Servidores
  2. Pulsa el botón Sincronizar cuentas
  3. Seleccione las cuentas que desea sincronizar y presione Continuar
  4. Ahora debe actualizar el “Producto/Servicio” de cada servicio recién creado en WHMCS.

Notas:

  • Las cuentas coinciden con los campos de dominio y nombre de usuario (correo electrónico)
  • Todas las cuentas recién creadas se colocarán en un paquete WHMCS llamado “predeterminado”, después de la sincronización debe abrir el servicio y cambiar el Producto / Servicio a un paquete válido.

Table of Contents