AltWha – Tutoriales ISPbrain

Altwha permite el envío de mensajes masivos. El modulo se compone de dos partes, una dentro de ISPbrain para generar los mensajes y la otra debe ser instalada en algun host dentro del ISP. Este último es un agente “enviador” de mensajes que toma los mensajes generados por ISPbrain y hace el envío.

Configuración de cuenta en ISPbrain

El primer paso para empezar a utilizar esta herramienta es declarar en ISPbrain una cuanta. Para ello nos dirigimos a Integraciones->AltWha->Cuentas.

Dentro del menú de cuentas, daremos click en el botón “Agregar”, se nos mostrará el siguiente formulario:

Nos pide como obligatorio solo el nombre de la cuenta. Además debemos configurar los tiempos y bloque de mensajes dependiendo de la cantidad de mensajes a enviar y a la velocidad que queremos hacerlo.

Configuración de tiempos y bloque

Para evitar baneos, es importante que el sistema se comporte lo mas similar a un humano, para ello vamos a configurar:

Tiempo de descanso
- Es el tiempo que va a esperar entre cada bloque de envío.
Tiempo entre mensajes
- Es el tiempo que va a esperar entre cada mensaje.
Bloque de mensajes
- Es la cantidad de mensajes que se enviarán por bloque.

Tenga en cuenta que el enviador va a generar un número aleatorio dentro del rango que usted defina en ésta configuración.

Una mala configuración puede generar el baneo de su cuenta. ISPbrain NO SE HACE RESPONSABLE POR TAL SITUACIÓN

Creación de plantillas

Para generar los mensajes debemos crear plantillas de mensajes. Para ello nos dirigimos a Integraciones->AltWha->Plantillas

Presione el boton “Agregar” y se mostrará el siguiente formulario

En éste formulario debemos completar el nombre de la plantilla y al menos una alternativa de mensaje. Tiene disponibles 6 alternativas de mensajes, donde puede incorporar los tags que ve a su derecha.

Para evitar baneos, es importante que cree distintos mensajes que con distintas palabras y oraciones representen lo mismo. El sistema alternará entre estas 6 opciones para crear mensajes distintos de forma automática. Recomendamos que se creen las 6 alternativas posibles.

Generar los mensajes

Para generar los mensajes, puede hacerlo desde la tabla de clientes, conexiones, servicios y tickets.

Selecciones los items de los cuales generar mensajes y ejecute la opcion enviar AltWha

Al presionar “enviar altwha” se mostrará un pop-up como éste

Donde debe seleccionar la cuenta a utilizar, la plantilla con la que generar los mensajes y determinar si son de caracter urgente o no.

Urgente

El caracter urgente tiene dos funciones:

Prioriza mensajes marcados como urgente.
Se envían mensajes marcados como urgente cualquier día y horario.

Mensajes generados

Dentro del menú Integraciones->AltWha podrá ver los mensajes generados y el estado de su envío.

Una vez enviado, el estado pasa a “Enviado” y se completa la columna “Enviado” con la fecha y hora del envío.

Usted puede cancelar de forma individual o masiva los mensajes en estado “Pendiente”.

Estados

Existen 4 posibles estados para los mensajes:

Pendiente
- En lista para ser enviado.
No enviado
- Se intentó enviar pero se produjo un error.
Enviado
- Se envió correctamente.
Cancelado
- El usuario canceló el envío.

Agente enviador

Para que los mensajes sean enviados se necesita del agente enviado. Este agente se instala en alguna maquina virtual linux dentro de su ISP.

El enviador trae los mensajes generados y los envía dependiendo de la urgencia del mensaje. Existen dos formas de envío:

Envío normal
- El enviador funciona normalmente de Lunes a Sábado de 8hs a 20hs.
- Los mensajes que queden pendiente y no sean de caracter urgente se seguirán enviando al día siguiente.
Envio urgente
- Si el enviador detecta mensajes urgentes los envía sin importar el día y la hora.
- Aparte si encuentra una combinación de mensajes normales y urgentes, envía primero los urgentes y luego continúa con los normales.

Instalar el agente enviador no tiene ni un tipo de costo.

Instalación del agente

Para instalar el agente necesitamos levantar una maquina virtual o servidor con debian 11, una vez instalado debian 11 solo resta ejecutar el siguiente comando:

wget https://raw.githubusercontent.com/Crenein/AltWhaAgent/master/install.sh && chmod +x install.sh && ./install.sh

El comando le pedirá 4 parámetros de configuración:

Subdominio de su sistema.
ID de la cuenta de AltWha.
Usuario de API.
Contraseña de API.

Obtención de subdominio

Es lo que aparece antes del primer punto de la url. Solo se carga en este caso prod1, no prod1.ispbrain.io.

Id de cuenta altwha

Ingrese a la lista de cuentas de Altwha e identifique el ID.

API

En la sección Sistema->API, habilite y configure un usuario y contraseña para API. Para evitar errores, use solo letras y numeros, sin caracteres especiales.

Login a WhatsApp

El comando instalará las dependencias necesarias, luego tiene que ejecutar los siguientes comandos:

docker exec "subdominoIdAltwha" mudslide login

Debe remplazar lo que se ve entre comillas con su información por ejemplo:

docker exec demo1 mudslide login

Si no logra construir el nombre, puede listar los contenedores con el comando “docker ps”.

Este comando les mostrará un QR en consola que es el que deben escanear con el celular para loguearse con WhatsApp.

Una vez logueado el sistema queda listo para el envío.

Probar envío

Puede probar el envío de mensajes desde la terminal luego de instalar el agente para validar que el mismo esté funcionando correctamente. Para ello ejecute el siguiente comando:

docker exec container_name mudslide send 549XXXXXXXX prueba

Remplace las X por su numero de whatsapp y le debería llegar un mensaje con la palabra “prueba”.

Actualización de agente

Para actualizar el agente de envío sin eliminar los datos de login, ejecute los siguientes comandos:

rm -r install.sh
docker kill $(docker ps -a -q)
docker system prune -a

El comando docker system prune les va a pedir confirmación, a lo que simplemente presionan enter.

Una vez eliminado el instalador antiguo, proceda a ejecutar el proceso de instalación como se describe mas arriba en este documento.
No es necesario ejecutar un nuevo login con QR.

Eliminación de agente

Para purgar la información ejecute los siguientes comandos:

docker kill $(docker ps -a -q)
docker ps
rm -r altwha/
rm -r install.sh log
docker system prune -a

El comando docker system prune les va a pedir confirmación, a lo que simplemente presionan enter.

Una vez purgado el sistema, proceda a la instalación como se describe mas arriba en éste tutorial.

Resolucion de problemas de agente

Para determinar el funcionamiento de altwha podemos seguir estos pasos:

Verificar si el contenedor de docker se esta ejecutando correctamente.
Realizar un envío de mensaje directo desde la consola del linux.
Prueba de envío de mensaje desde ispbrain.
Verificar login con ISPbrain.

Verificar el conenedor

Para verificar si el contenedor se está ejecutando usaremos el comando:

docker ps

Nos devuelve algo como esto:

Si el estado es Up y el tiempo es mayor a 2 minutos podemos decir que el contenedor está vivo. Si el contendor tiene alguna falla nos mostrará la palabra “restarting” dentro del estado, se ve algo así.

Si al hacer docker ps solo muestra los titulos de la tabla y no se lista ni un contenedor quiere decir que el contenedor ha sido frenado.

Prueba de envío

Es importante entender que tienen que existen dos logins en el agente, uno para con whatsapp y otro para con ispbrain.
Si la prueba de envío desde la consola es exitosa quiere decir que el contenedor funciona y el login con whatsapp es correcto, independientemente que la conexión a ispbrain sea exitosa.
Para probar el envío ejecute el siguiente comando:

docker exec subdominoIdAltwha mudslide send 549XXXXXXXX prueba

Si recibe un whatsapp el login con whatsapp es correcto. Si no recibe el mensaje puede ejecutar un nuevo login. Para ello se desloguea con el siguiente comando:

docker exec subdominoIdAltwha mudslide logout

Luego del logout realiza el login nuevamente. Recuerde que el login pedirá el escaneo del QR.

docker exec subdominoIdAltwha mudslide login

Prueba de envio desde ISPbrain

Cree un cliente de prueba en ISPbrain y cargue su numero en el campo “Whatsapp” con el formato correcto.
Haga un envio de altwha desde ISPbrain.
Recuerde que si hace esta prueba fuera del rango horario de 8hs a 19hs debe tildar la opcion “urgente” al hacer el envío.
Espere hasta 5 minutos.
Si el mensaje llegó, felicitaciones! su Altwha funciona. En caso contrario y considerando que desde la consola si se envió el mensaje, podemos decir que hay un problema para conectar a su cuenta de ISPbrain.

Verificar login con ISPbrain

Lo más cómodo para solucionar este punto es reinstalar el contenedor ejecutando los siguientes comandos:

rm -r install.sh
docker kill $(docker ps -a -q)
docker system prune -a

El comando docker system prune -a le pedirá confirmacion, confirme presionando letra “y” luego enter.
Este comando eliminará el contenedor conservando los archivos de login, por lo que no será necesario volver a loguear con whatsapp.

Seguido a la eliminación del contenedor, ejecute los pasos de instalación nueva como se expone más arriba en este documento.
Tenga en cuenta usar usuario y contraseña de api de ISPbrain sin caracteres especiales para evitar fallas de login.