Si después de seguir las instrucciones para activar el agente de mesa de ayuda, tienes algún problema con la activación o al crear/abrir tickets desde el agente de mesa de ayuda, por favor verifica que se hayan realizado los siguientes pasos.
Antivirus
Agrega las siguientes rutas a la lista blanca del antivirus:
- %userprofile%\AppData\Local\Temp\TicketingAgentPackage
-
C:\Program Files\ATERA Networks\AteraAgent\Packages\AgentPackageTicketing
Para 32 bits:
- C:\Program Files (x86)\ATERA Networks\AteraAgent\Packages\AgentPackageTicketing
Nota: TicketingTray.exe es el proceso del agente de mesa de ayuda.
Claves de registro
Las principales claves de registro se encuentran en:
HKEY_CURRENT_USER\Software\ATERA Networks\AlphaAgentEstos valores los agrega el Agente de Atera (cuando se ejecuta el comando de activación desde la consola) al ejecutar settings.bat ubicado en:
C:\Program Files\ATERA Networks\AteraAgent\Packages\AgentPackageTicketing
Asegúrate de que existan y sean correctos los siguientes valores:
-
IntegratorLogin: El nombre de usuario/correo electrónico de tu cuenta de Atera
-
MachineID: El UID del agente, que puedes ver en la URL del dispositivo en Atera
(por ejemplo, https://app.atera.com/Admin#/rmm/device/xxxxxxx-ac2a-xxxxx-b4e3-xxxxxxxx/agent)
Instalación previa
Si AteraAgent o el Agente de Mesa de Ayuda ya estaban instalados antes, archivos en caché o restos en el registro pueden bloquear la comunicación adecuada con la nueva cuenta. Puedes seguir los siguientes pasos para resolver el problema:
Limpiar restos del registro
- Elimina los restos en:
HKEY_CURRENT_USER\Software\ATERA Networks\AlphaAgent
O puedes usar el siguiente comando CMD:
REG DELETE "HKEY_CURRENT_USER\Software\ATERA Networks\AlphaAgent" /f
- Elimina settings.bat de:
C:\Program Files\ATERA Networks\AteraAgent\Packages\AgentPackageTicketing\
-
Reactiva el agente de mesa de ayuda desde Atera: Dispositivo > Administrar > Agente de Mesa de Ayuda > Activar
Esto vuelve a desplegar settings.bat y recrea las claves de registro necesarias.
Script de limpieza del Agente de Mesa de Ayuda (.ps1)
Elimina el Agente de Mesa de Ayuda del dispositivo afectado ejecutando lo siguiente localmente en PowerShell como Administrador:
Stop-Process -name TicketingTray.exe -Force
Stop-Service -Name "AteraAgent" -Force
Remove-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Run" -Name "AlphaHelpdeskAgent" -Force
Remove-Item -Path "HKCU:\Software\ATERA Networks\*" -Recurse
Remove-Item -Path "C:\Program Files\ATERA Networks\AteraAgent\Agent\packages\AgentPackageTicketing
" -Force
Remove-Item -Path ($Env:Tmp, "eo.webbrowser.cache.19.0.69.0.1.1" -join "\") -Recurse -Force
Remove-Item -Path ($ENV:Tmp, "TicketingAgentPackage" -join "\") -Recurse -Force
Remove-Item -Path ($ENV:Tmp, "TrayIconCaching" -join "\") -Recurse -Force
Remove-Item -Path "C:\Program Files\ATERA Networks\AteraAgent\Packages\AgentPackageTicketing" -Force
Start-Sleep -Seconds 5
Start-Service -Name "AteraAgent"El script pedirá confirmación — escribe Y para continuar.
Limpieza manual
Elimina las siguientes carpetas de:
C:\Users\%localuser%\AppData\Local\TempTicketingAgentPackage
-
TrayIconCaching
Nota: AppData puede estar oculta, activa la opción Mostrar elementos ocultos.
Luego ve a:
C:\Program Files\ATERA Networks\AteraAgent\Packagesy elimina:
AgentPackageTicketingReactiva el Agente de Mesa de Ayuda en Atera: Dispositivo > Administrar > Agente de Mesa de Ayuda > Activar
Nombre de la empresa
El nombre de la empresa está limitado a 45 caracteres (Admin > Configuración > Nombre de la empresa).
- Si tu nombre actual supera los 45 caracteres, solo verás la limitación al intentar editarlo.
-
Si el nombre de la empresa es más largo de lo permitido, el icono de la bandeja mostrará: "CompanyName... - Helpdesk Agent" y ticketingtray.exe puede no iniciarse.
Icono del agente de mesa de ayuda
Si el icono del agente de mesa de ayuda no aparece en la bandeja del sistema:
Verifica la configuración de Ticketing
- Asegúrate de que Ticketing esté habilitado en: Admin > Portal del Cliente > Ticketing
-
Confirma que el Cliente específico tenga Ticketing habilitado.
Restablecer la configuración de Ticketing
-
Desactiva y vuelve a activar Ticketing en la configuración del Portal del Cliente.
Eliminar valores específicos de registro de Ticketing
Elimina los siguientes valores de:
HKEY_LOCAL_MACHINE\SOFTWARE\ATERA Networks\AlphaAgent\Packages\AgentPackageTicketing- HashModules
- PortalModules
-
HelpdeskAgentOptionsCreatedKey
O ejecuta estos comandos:
reg delete "HKEY_LOCAL_MACHINE\SOFTWARE\ATERA Networks\AlphaAgent\Packages\AgentPackageTicketing" /v HashModules /f
reg delete "HKEY_LOCAL_MACHINE\SOFTWARE\ATERA Networks\AlphaAgent\Packages\AgentPackageTicketing" /v PortalModules /f
reg delete "HKEY_LOCAL_MACHINE\SOFTWARE\ATERA Networks\AlphaAgent\Packages\AgentPackageTicketing" /v HelpdeskAgentOptionsCreatedKey /f
Vuelve a habilitar el agente de mesa de ayuda
Desactiva y vuelve a activar el Agente de Mesa de Ayuda en el dispositivo.
Requisito de red
Asegúrate de que el siguiente dominio sea accesible en la red:
ticketingitemsstoreeu.blob.core.windows.net