This is an unofficial tool for testing the Azure Communication Services Email Service. There are no guarantees it is free of bugs
You can test various features of the Email Communication Services using this tool. For example:
- Authenticate using ACS connection string, Entra ID, interactive authentication, or SMTP basic authentication.
- Send emails with auto-retry enabled or disabled.
- Send emails through SMTP using MailKit or System.Net.Mail.
- Set email importance.
- Send plain text or HTML email bodies.
- Add custom headers.
- Manage email recipients (To, CC, BCC, Reply To).
- Include attachments and/or inline attachments in the email.
- Get images as Base64 strings.
- Wait until the sent email is started or completed.
- Send multiple emails to simulate bulk email sending.
- Query email delivery status.
- Connect to Azure Service Bus to receive email events
To run this tool, you need the following:
- An Azure Communication Services resource. You can create it by following the steps in the Quickstart: Create and manage Communication Services resources
- An Email Communication Service resource. You can create it by following the steps in the Quickstart: Create and manage Email Communication Service resources
- An Azure Managed Domain or Custom Domain provisioned under your Email Communication Service resource. More information can be found in the Quickstart: How to add Azure Managed Domains to Email Communication Service and Quickstart: How to add custom verified email domains.
- A connected domain in your Azure Communication Services resource. For more information, follow the steps in the Quickstart: How to connect a verified email domain
- Optional: An Azure Service Bus resource with a namespace and queue. You can create it by following the public documentation on how to Use Azure portal to create a Service Bus namespace and a queue.
- .Net 8.0. You can download it from the .Net download page.
After downloading the project and before building it with Visual Studio, prepare your environment as follows:
- Optional: Configure your Azure Communication Services resource events to send all email-related events to the Azure Service Bus queue created in the prerequisites. For more information, refer to the Subscribe to Azure Communication Services events documentation.
- Optional: Modify the appsettings.json file in your project with the required information. This will help automatically fill in the required information on startup. Alternatively, you can manually fill or edit the information on startup.
- You can remove rows from Receipents, Custom Headers, and Attachments by selecting the first column (Clicking on it with your mouse), then pressing Delete in your keyboard
- Version 4.0 - Dec 2024:
- AADDefaultCredentials has been renamed in appsettings.json to EntraIdDefaultCredentials
- AADClientSecret has been renamed in appsettings.json to EntraIdClientSecret
- AAD_ClientId has been renamed in appsettings.json to EntraId_ClientId
- AAD_ClientSecret has been renamed in appsettings.json to EntraId_ClientSecret
- Version 2.0 - Dec 2023:
- ConnectionString has been replaced in appsettings.json with ACSEndpoint and ACSAccessKey