Conexión de un bot al correo electrónico de Office 365Connect a bot to Office 365 email

se aplica a: SDK V4APPLIES TO: SDK v4

Los bots pueden comunicarse con los usuarios mediante el correo electrónico de Office 365 además de otros canales.Bots can communicate with users via Office 365 email in addition to other channels. Cuando se configura un bot para acceder a una cuenta de correo electrónico, recibe un mensaje cuando llega un nuevo correo.When a bot is configured to access an email account, it receives a message when a new email arrives. El bot puede responder entonces tal y como indica su lógica de negocios.The bot can then respond as indicated by its business logic. Por ejemplo, el bot podría enviar un correo electrónico de respuesta para confirmar un correo electrónico que se recibió con el mensaje "¡Hola!For example, the bot could send an email reply acknowledging an email was received with the message, "Hi! Le agradecemos su pedido.Thanks for your order! Comenzaremos a procesarlo inmediatamente".We will begin processing it immediately."

Advertencia

Es una infracción del Código de conducta de Bot Framework crear "spambots", lo que incluye bots que envían correo masivo no deseado ni solicitado.It is a violation of the Bot Framework Code of Conduct to create "spambots", including bots that send unwanted or unsolicited bulk email.

Nota

Si usa Microsoft Exchange Server, asegúrese de que ha habilitado la detección automática antes de configurar el canal de correo electrónico.If you are using Microsoft Exchange Server, make sure you have enabled Autodiscover first before configuring email channel.

Configuración de las credenciales de correo electrónicoConfigure email credentials

Para conectar un bot al canal de correo electrónico, debe escribir las credenciales de Office 365 en la configuración de canal de correo electrónico.You can connect a bot to the Email channel by entering Office 365 credentials in the Email channel configuration. No se admite la autenticación federada con un proveedor que reemplace a AAD.Federated authentication using any vendor that replaces AAD is not supported.

Nota

No use sus propias cuentas de correo electrónico personal con bots, ya que todos los mensajes enviados a esa cuenta de correo electrónico se reenviarán al bot.You should not use your own personal email accounts for bots, as every message sent to that email account will be forwarded to the bot. Como consecuencia, el bot puede enviar una respuesta al remitente de manera inadecuada.This can result in the bot inappropriately sending a response to a sender. Por este motivo, los bots solo deben usar cuentas de correo electrónico de Office 365 dedicadas.For this reason, bots should only use dedicated O365 email accounts.

Para agregar el canal de correo electrónico, abra el bot en Azure Portal, haga clic en la hoja Canales y luego en Correo electrónico.To add the Email channel, open the bot in the Azure Portal, click the Channels blade, and then click Email. Escriba sus credenciales de correo electrónico válidas y haga clic en Guardar.Enter your valid email credentials and click Save.

Escribir las credenciales de correo electrónico

El canal de correo electrónico solo funciona actualmente con Office 365.The Email channel currently works with Office 365 only. Otros servicios de correo electrónico no se admiten actualmente.Other email services are not currently supported.

Personalización de los mensajes de correo electrónicoCustomize emails

El canal Correo electrónico admite el envío de valores personalizados para crear correos electrónicos personalizados más avanzados mediante la propiedad channelData activity.The Email channel supports sending custom values to create more advanced, customized emails by using the activity channelData property. El fragmento de código siguiente muestra un ejemplo de para un mensaje de correo electrónico channelData personalizado entrante, del bot al usuario.The snippet below shows an example of the channelData for an incoming custom email message, from the bot to the user.

PropiedadProperty DescripciónDescription
htmlBodyhtmlBody El código HTML que se utilizará para el cuerpo del mensaje.The HTML to use for the body of the message.
subjectsubject El asunto que se usará para el mensaje.The subject to use for the message.
importanceimportance La marca de importancia que se usará para el mensaje: low, normal o high.The importance flag to use for the message: low, normal, or high.
toRecipientstoRecipients Una cadena de direcciones de correo electrónico delimitada por punto y coma (;) para agregar al campo Para del mensaje.A semicolon (;) delimited string of email addresses to add to the message's To field.
ccRecipientsccRecipients Una cadena de direcciones de correo electrónico delimitada por punto y coma (;) para agregar al campo CC (copia carbón) del mensaje.A semicolon (;) delimited string of email addresses to add to the message's Cc (carbon copy) field.
bccRecipientsbccRecipients Una cadena de direcciones de correo electrónico delimitada por punto y coma (;) para agregar al campo CCO (copia carbón oculta) del mensaje.A semicolon (;) delimited string of email addresses to add to the message's Bcc (blind carbon copy) field.

Para obtener más información sobre la propiedad channelData de actividad, vea Crear un mensaje de correo electrónico personalizado.For more information about the activity channelData property, see Create a custom Email message.

Otras consideracionesOther considerations

Si el bot no devuelve un código de estado 200 OK HTTP en de 15 segundos en respuesta a un mensaje de correo electrónico entrante, el canal de correo electrónico intentará reenviar el mensaje y el bot podría recibir la misma actividad de mensaje de correo electrónico varias veces.If your bot does not return a 200 OK HTTP status code within 15 seconds in response to an incoming email message, the email channel will try to resend the message, and your bot may receive the same email message activity a few times. Para más información, consulte la sección Detalles HTTP en Funcionamiento de los bots y en el artículo Solución de problemas de tiempo de espera.For more information, see the HTTP details section in How bots work and the how to troubleshooting timeout errors article.

Nota

Si usa una cuenta de Office 365 con MFA habilitado, asegúrese de deshabilitar MFA para la cuenta especificada en primer lugar y, después, puede configurar la cuenta para el canal de correo electrónico.If you are using an Office 365 account with MFA enabled on it, make sure you disable MFA for the specified account first, then you can configure the account for the email channel. De lo contrario, se producirá un error en la conexión.Otherwise, the connection will fail.

Recursos adicionalesAdditional resources