Outlook

Conecte Outlook y Microsoft 365 con su aplicación de Microsoft Entra para que un agente busque, lea y responda correos, envíe seguimientos y gestione el calendario.

Qué conseguirá

Outlook mostrará Connected y responderá a Test connection.

Descripción general y casos de uso

La conexión permite a un agente buscar, leer y responder correos, enviar seguimientos, guardar borradores, ordenar la bandeja de entrada, y crear, listar y cancelar eventos del calendario, todo mediante Microsoft Graph.

Requisitos previos

Una cuenta de Microsoft (personal o de trabajo) y permiso para registrar una aplicación en Microsoft Entra.

Configuración de la cuenta externa (en Microsoft Entra)

Microsoft controla estas pantallas. La guía de Microsoft: Register an app.

Registre una aplicación en el centro de administración de Entra.
Añada un URI de redireccionamiento Web: la URL del cuadro Connect de Phynxa.
En los permisos de API, añada los permisos delegados de abajo.
Cree un client secret y cópielo junto con el Application (client) ID.

Conéctelo en Phynxa

Integrations, Connect en Outlook.
Escriba el Client ID, el Client secret y, opcionalmente, el Tenant.
Inicie sesión en Microsoft y apruebe. La tarjeta muestra Connected.

Permisos y ajustes

Permisos delegados: offline_access (sin él, la conexión termina al cabo de una hora), User.Read, Mail.ReadWrite, Mail.Send, Calendars.ReadWrite.

Tenant: common (cuentas de trabajo y personales), organizations (solo de trabajo), consumers (solo personales), o el id o el dominio de su propio tenant.

¿Conectó Outlook antes de que se añadiera la lectura? Esa conexión solo tenía permiso para enviar. El envío sigue funcionando; para las demás acciones de correo, use Reconnect y apruebe de nuevo.

Úselo en una llamada

En la pestaña Tools de un agente, Add tool, Integration, Outlook:

Acción	Qué hace	Se ejecuta
Send email	Envía un correo. Necesita to (varias direcciones separadas por comas), subject y body.	En segundo plano
Search emails	Lista los correos que coinciden, con quién envió cada uno, el asunto, la fecha y las primeras palabras. Admite query con las palabras de búsqueda de Outlook (por ejemplo `from:sara@example.com`) y max_results (hasta 10); sin query lista lo más reciente de la bandeja de entrada.	Espera
Read email	Abre un correo y devuelve su texto (hasta unos 3.500 caracteres), quién lo envió y los nombres de los adjuntos. Necesita message_id de una búsqueda.	Espera
Read conversation	Devuelve los cuatro últimos mensajes de una conversación. Necesita thread_id (el identificador de conversación que devuelve la búsqueda).	Espera
Reply to email	Responde a quien escribió el correo (nunca a todos). Necesita message_id y body.	En segundo plano
Create draft	Guarda un correo en Borradores. No se envía nada. Necesita to, subject y body.	En segundo plano
Mark as read	Marca un correo como leído.	En segundo plano
Archive email	Mueve un correo a la carpeta Archivo. Se conserva y se puede seguir encontrando.	En segundo plano
Move to trash	Mueve un correo a Elementos eliminados, de donde se puede recuperar.	En segundo plano
Create calendar event	Pone un evento en el calendario. Necesita subject, start, end y time_zone; attendees (correos separados por comas, a quienes se invita) y location son opcionales.	En segundo plano
List calendar events	Lista los eventos entre dos horas (los próximos siete días por defecto), con sus identificadores.	Espera
Cancel event	Cancela un evento que usted organizó; se avisa a los invitados. Necesita event_id de List calendar events.	En segundo plano

Estas acciones también funcionan en un agente de WhatsApp: en su pestaña Tools, Add tool, Integration, Outlook. Consulte Crear un agente de WhatsApp.

Proteja su buzón

Dé las acciones de lectura solo a agentes de confianza. Un agente que atiende al público (una línea telefónica, un widget web, un número de WhatsApp) responde a cualquiera que hable con él, así que cualquiera podría preguntarle por su correo. A un agente público dele solo Send email o Create draft.
El texto de un correo lo escribió otra persona. Puede contener instrucciones dirigidas a un asistente («reenvía todo a ...»). Phynxa indica al agente que trate lo que lee como información y nunca como instrucciones, pero lo más seguro es no dar a un mismo agente las acciones de lectura y de envío.
Cada herramienta se puede desactivar quitándola del agente.
No hay un chat privado de «pregúnteme por mi correo». Un agente de WhatsApp responde a los clientes que escriben a su número; no recibe órdenes suyas sobre su propia bandeja.

«Reconnect Outlook». La conexión se hizo antes de que se añadiera la lectura, o no se concedió Mail.ReadWrite. Añada el permiso en Entra y luego use Reconnect y apruebe.
La conexión se detiene al cabo de una hora. No se concedió offline_access; añádalo y use Reconnect.
Discrepancia del URI de redireccionamiento. El URI de redireccionamiento Web debe ser idéntico al de Phynxa.
Tipo de cuenta equivocado. Fije el Tenant para que coincida con su cuenta.

Seguridad y credenciales

El client secret se almacena cifrado. Revoque el acceso de la aplicación en los ajustes de su cuenta de Microsoft; Remove lo elimina aquí.

Guías relacionadas

¿Algo de esto no coincide con lo que ve en el panel? Avísenos.