Docs / Integraciones

Gmail add-on

El Gmail add-on agrega un botón Report to eMate en la sidebar de Gmail. Con un click, el empleado envía el email sospechoso a la plataforma sin salir de Gmail.

Cómo se ve

En la sidebar derecha de Gmail (web y mobile), aparece un icono de eMate. Al abrir el email sospechoso y clickear el icono → panel con:

  • Info del sender.
  • Botón grande “Report as Phishing”.
  • Confirmación después del envío.

Instalación — org-wide (recomendado)

Requiere ser admin de Google Workspace.

  1. Desde Google Workspace Marketplace → buscar eMate Platform Security.
  2. Domain-wide install → autorizar los scopes.
  3. Configurar qué usuarios pueden usar el addon (por default, todos).

Los scopes solicitados:

  • gmail.addons.execute
  • gmail.readonly (para leer el email cuando el user aprieta el botón — no antes)
  • userinfo.email

Instalación — usuario individual

Si un usuario no puede pedir la instalación org-wide, puede instalarlo él solo:

  1. Gmail → sidebar → icono + → buscar “eMate”.
  2. Install for me only.

Setup del tenant

Después de la instalación en Workspace, en Integraciones → Gmail Add-on → Configurar:

  • Tenant token — es un JWT que el addon guarda en cada usuario. Este token no vence.
  • Custom logo — opcional.
  • Categorías de report — permite que el user categorize antes de enviar (credential_phishing, bec, spam, other).

Auditoría

Cada report queda con:

  • reported_by_external — email del reporter según Google.
  • reported_by_email — cross-reference con emate.awareness_employees si el email matchea.
  • source: gmail_addon.
  • Timestamp exacto.

Esto permite tracking del positive signal: qué empleados reportan, con qué frecuencia, y crédito en el risk_score.

Roadmap

  • Auto-purge: cuando el equipo de seguridad marca un cluster como confirmed phishing, los emails en las bandejas de otros empleados se pueden purgar via Mail.ReadWrite (funcionalidad separada, en el producto Human Risk Protection).
  • Explain button: el add-on va a explicar por qué el email es sospechoso (o no) usando el clasificador AI.

Google Workspace vs M365

El equivalente para Outlook es el Outlook add-in — misma funcionalidad, distinta plataforma.