Configuración
Mailgun
Envío de alertas de propuestas vencidas y solicitudes de revalidación.
Notificaciones por email
Configuración de avisos automáticos comerciales y del gobierno documental de Knowledge Base.
Reuniones desde el portal público
Solicitud manual desde Max en ask-portal-staging.braycom.com. No utiliza Microsoft 365 ni consulta calendarios. El correo se envía mediante Mailgun.
Reuniones
Configuración de destinatarios para reuniones solicitadas desde una propuesta.
Microsoft 365 / Teams
Conexión mediante Microsoft Graph para consultar disponibilidad de Preventa y recuperar fotografías de usuarios. Las credenciales se guardan cifradas y no se muestran después de almacenarlas.
Instructivo de configuración de Microsoft 365 / Entra ID
1. Registrar aplicación. Abrí Microsoft Entra admin center → Identity → Applications → App registrations → New registration. Nombre recomendado: Ask Braycom. Seleccioná Single tenant y dejá Redirect URI vacío.
2. Copiar identificadores. En Overview copiá Directory (tenant) ID y Application (client) ID. No utilizar Object ID.
3. Autorizar Microsoft Graph. En API permissions → Add a permission → Microsoft Graph → Application permissions, incorporá ProfilePhoto.Read.All (fotografías de usuarios) y Calendars.ReadWrite (consulta de disponibilidad y creación de reuniones en Outlook/Teams). Ambos deben ser Application permissions. Hacé Grant admin consent para el tenant. No alcanza con Calendars.ReadBasic cuando se utiliza agenda automática. Aplicá restricciones de acceso a buzones para limitar el alcance de la aplicación.
4. Crear credencial. En Certificates & secrets → Client secrets → New client secret, copiá inmediatamente el Value, no el Secret ID. Guardalo en el campo Client Secret de abajo.
5. Verificar cifrado. El Worker del entorno correspondiente (ask-braycom en producción o ask-braycom-staging en staging) debe tener configurado el secreto MAIL_SETTINGS_MASTER_KEY. No lo agregues al código ni lo cambies sin contemplar otros secretos ya cifrados.
6. Guardar y probar. Completá los tres campos de abajo, presioná Guardar configuración y luego Probar Microsoft 365. La prueba obtiene un token y, si existe email de Preventa configurado, consulta su calendario. La fotografía se consulta desde el dashboard.
Importante: en modo Agenda automática, Ask Braycom requiere permiso de escritura para crear invitaciones. Las notificaciones directas mediante Teams son una función independiente: estos permisos no habilitan el envío de mensajes de Teams.
Notificaciones Microsoft Teams
Preferencias para futuros avisos importantes al vendedor comercial identificado por Sellsy.
La entrega de avisos requiere permiso TeamsActivity.Send, una aplicación Teams instalada y habilitación en staging. Se usa el correo del vendedor identificado por Sellsy y de la Preventa seleccionada cuando corresponda.