MediaCP Manual
Guía de integración WHMCS

Última actualización hace 9 meses

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 WHMCS se describe a continuación, reemplazando yourdomain.com:2020 con el nombre de host y el puerto 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 a Configuració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

Shoutcast Transcoder V1

de AutoDJ

Proxy de transmisión Proxy de transmisión

geográfico

Reencode

24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320, 400, 480, 560, 640, 720, 800, 920, 1024,

disco Cuota

de

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

de flujo

las opciones configurables
Media Service-Shoutcast Shoutcast 2 Shoutcast 198
Icecast Icecast 2 Icecast 2

KH Icecast

KH

Wowza Streaming Engine Servicio

multimedia Flash Servicios de Windows Media

Fuente AutoDJ Shoutcast Transcoder V2 Ices 0.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
.

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
Conexiones Oyentes Espectadores Número máximo de usuarios Número máximo de oyentes

Número máximo de
espectadores

Valor numérico Introduzca un valor entre 0 y 9999.
Bitrate máximo Bitrate 1280, 1536, 1792, 2048, 2560, 3072, 3584, 4096, 99999 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.
Uso del de
disco Cuota de disco
MB, GB o TB Especifique un valor que incluya MB, GB o TB. Por ejemplo: 100MB
Ancho de banda de transferencia datos MB, GB o TB 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 transmisión (Wowza, Flussonic y Nginx-RTMP)

Destinos de transmisión

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
Objetivos # Destinos de transmisión Valor numérico Introduzca un valor entre 0 y 9999.
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

motor

Perfiles de transcodificador Perfiles de transcodificador 160p

Lista delimitada por comas de perfiles

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

RTMP

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
Autenticación en vivo :
no
de transmisión Wowza SOLAMENTE.
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.
RTMP Soporte
RTMP Servicio

No
Habilite los enlaces RTMP / RTSP para los servicios de Shoutcast e Icecast SOLAMENTE.

Flussonic Media Server

Transmisión

bajo demanda

Opción configurable

Alternativas

Opciones

Descripción

Tipo de servicio Tipo de servicio en vivo Estación
de TV Transmisió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. Por favor, revise este artículo de la base de conocimientos para conocer los pasos para resolver este error de transporte y error de solicitud de WHMCS.

Error de transporte: no se pudo abrir el socket

Hay un problema de conexión entre su servidor WHMCS y el MediaCP. Por favor, revise este artículo de la base de conocimientos para conocer los pasos para resolver este error de transporte y error de solicitud de WHMCS.

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

Si está viendo este error al usar el botón Sincronizar dentro de WHMCS, por favor revise este artículo de la base de conocimiento para conocer los pasos para resolver este WHMCS No soportado con su versión de MediaCP.

Importación de cuentas MediaCP en WHMCS

MediaCP 2.9.11 y 2.10.7 introducen la posibilidad de utilizar la herramienta WHMCS Server Sync. Por favor, revise este artículo de la base de conocimientos para conocer los pasos para completar esta importación de cuentas de MediaCP a WHMCS.

Table of Contents