├── .github
    ├── CODE_OF_CONDUCT.md
    ├── ISSUE_TEMPLATE.md
    └── PULL_REQUEST_TEMPLATE.md
├── .gitignore
├── CHANGELOG.md
├── CONTRIBUTING.md
├── CallAutomation-Connect-Room
    ├── README.md
    ├── data
    │   ├── callingRoomQuickstart.png
    │   ├── connectCall.png
    │   ├── createRoom.png
    │   ├── joinRoomCall.png
    │   ├── roomId.png
    │   └── tokens.png
    ├── pom.xml
    └── src
    │   └── main
    │       ├── java
    │           └── com
    │           │   └── communication
    │           │       └── callautomation
    │           │           ├── AppConfig.java
    │           │           ├── Main.java
    │           │           ├── ProgramSample.java
    │           │           └── config
    │           │               └── WebConfig.java
    │       └── resources
    │           ├── application.yml
    │           └── templates
    │               └── index.html
├── CallAutomation_Live_Transcription
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       ├── java
    │           └── com
    │           │   └── communication
    │           │       └── callautomation
    │           │           ├── AppConfig.java
    │           │           ├── Main.java
    │           │           ├── ProgramSample.java
    │           │           ├── WebSocketConfig.java
    │           │           └── WebSocketHandler.java
    │       └── resources
    │           └── application.yml
├── CallAutomation_OpenAI_Sample
    ├── README.md
    ├── pom.xml
    ├── src
    │   └── main
    │   │   ├── java
    │   │       └── com
    │   │       │   └── communication
    │   │       │       └── callautomation
    │   │       │           ├── AppConfig.java
    │   │       │           ├── Main.java
    │   │       │           └── ProgramSample.java
    │   │   └── resources
    │   │       └── application.yml
    └── static
    │   ├── Confirmed.wav
    │   ├── Goodbye.wav
    │   ├── Invalid.wav
    │   ├── MainMenu.wav
    │   ├── OutboundCallDesign.png
    │   └── Timeout.wav
├── CallAutomation_OutboundCalling
    ├── README.md
    ├── pom.xml
    ├── src
    │   └── main
    │   │   ├── java
    │   │       └── com
    │   │       │   └── communication
    │   │       │       └── callautomation
    │   │       │           ├── AppConfig.java
    │   │       │           ├── Main.java
    │   │       │           └── ProgramSample.java
    │   │   └── resources
    │   │       └── application.yml
    └── static
    │   └── OutboundCallDesign.png
├── CallRecording
    ├── README.MD
    ├── Recordings API.postman_collection.json
    ├── pom.xml
    └── src
    │   └── main
    │       ├── java
    │           └── com
    │           │   └── communication
    │           │       └── callrecording
    │           │           ├── ApiApplication.java
    │           │           ├── ConfigurationManager.java
    │           │           └── Controller
    │           │               └── RecordingsController.java
    │       └── resources
    │           └── config.properties
├── DirectRouting
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       └── java
    │           └── com
    │               └── communication
    │                   └── quickstart
    │                       └── App.java
├── LICENSE.md
├── LookupNumber
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       └── java
    │           └── com
    │               └── communication
    │                   └── lookup
    │                       └── quickstart
    │                           └── App.java
├── ManageTeamsIdentityMobileAndDesktop
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       └── java
    │           └── com
    │               └── communication
    │                   └── quickstart
    │                       └── App.java
├── OutboundCallReminder
    ├── pom.xml
    ├── readme.md
    └── src
    │   └── main
    │       └── java
    │           └── com
    │               └── communication
    │                   └── outboundcallreminder
    │                       ├── App.java
    │                       ├── CallConfiguration.java
    │                       ├── CommunicationIdentifierKind.java
    │                       ├── ConfigurationManager.java
    │                       ├── Controllers
    │                           └── OutboundCallController.java
    │                       ├── EventHandler
    │                           ├── EventAuthHandler.java
    │                           ├── EventDispatcher.java
    │                           └── NotificationCallback.java
    │                       ├── Logger.java
    │                       ├── Ngrok
    │                           ├── NgrokConnector.java
    │                           └── NgrokService.java
    │                       ├── OutboundCallReminder.java
    │                       ├── audio
    │                           ├── custom-message.wav
    │                           └── sample-message.wav
    │                       └── config.properties
├── PhoneNumbers
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       └── java
    │           └── com
    │               └── communication
    │                   └── quickstart
    │                       └── App.java
├── README.md
├── ServerRecording
    ├── .gitignore
    ├── README.MD
    ├── mvnw
    ├── mvnw.cmd
    ├── pom.xml
    └── src
    │   ├── main
    │       ├── java
    │       │   └── com
    │       │   │   └── acsrecording
    │       │   │       └── api
    │       │   │           ├── ApiApplication.java
    │       │   │           ├── ConfigurationManager.java
    │       │   │           ├── Controller
    │       │   │               └── CallRecordingController.java
    │       │   │           └── Models
    │       │   │               ├── AudioConfiguration.java
    │       │   │               ├── FileDownloadType.java
    │       │   │               ├── FileFormat.java
    │       │   │               ├── Mapper.java
    │       │   │               ├── RecordingInfo.java
    │       │   │               ├── Root.java
    │       │   │               └── VideoConfiguration.java
    │       └── resources
    │       │   ├── application.properties
    │       │   └── config.properties
    │   └── test
    │       └── java
    │           └── com
    │               └── acsrecording
    │                   └── api
    │                       └── ApiApplicationTests.java
├── access-token-quickstart
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       └── java
    │           └── com
    │               └── communication
    │                   └── quickstart
    │                       └── App.java
├── chat-quickstart-java
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       └── java
    │           └── com
    │               └── communication
    │                   └── quickstart
    │                       └── App.java
├── jobrouter-quickstart-java
    ├── pom.xml
    ├── readme.md
    └── src
    │   ├── main
    │       └── java
    │       │   └── com
    │       │       └── communication
    │       │           └── jobrouter
    │       │               └── quickstart
    │       │                   └── App.java
    │   └── test
    │       └── java
    │           └── com
    │               └── communication
    │                   └── jobrouter
    │                       └── quickstart
    │                           └── AppTest.java
├── rooms-quickstart-java
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       └── java
    │           └── com
    │               └── communication
    │                   └── rooms
    │                       └── quickstart
    │                           └── App.java
├── send-email-advanced
    ├── README.md
    ├── send-email-attachments
    │   ├── attachment.pdf
    │   ├── attachment.txt
    │   ├── pom.xml
    │   └── src
    │   │   └── main
    │   │       └── java
    │   │           └── com
    │   │               └── communication
    │   │                   └── email
    │   │                       └── App.java
    ├── send-email-inline-attachments
    │   ├── inline-attachment.jpg
    │   ├── inline-attachment.png
    │   ├── pom.xml
    │   └── src
    │   │   └── main
    │   │       └── java
    │   │           └── com
    │   │               └── communication
    │   │                   └── email
    │   │                       └── App.java
    └── send-email-multiple-recipients
    │   ├── pom.xml
    │   └── src
    │       └── main
    │           └── java
    │               └── com
    │                   └── communication
    │                       └── email
    │                           └── App.java
├── send-email
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       └── java
    │           └── com
    │               └── communication
    │                   └── email
    │                       └── App.java
├── send-sms-quickstart
    ├── README.md
    ├── pom.xml
    └── src
    │   └── main
    │       └── java
    │           └── com
    │               └── communication
    │                   └── quickstart
    │                       └── App.java
└── use-managed-Identity
    ├── README.md
    ├── pom.xml
    └── src
        └── main
            └── java
                └── com
                    └── communication
                        └── quickstart
                            └── App.java


/.github/CODE_OF_CONDUCT.md:
--------------------------------------------------------------------------------
 1 | # Microsoft Open Source Code of Conduct
 2 | 
 3 | This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
 4 | 
 5 | Resources:
 6 | 
 7 | - [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
 8 | - [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
 9 | - Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns
10 | 


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE.md:
--------------------------------------------------------------------------------
 1 | <!--
 2 | IF SUFFICIENT INFORMATION IS NOT PROVIDED VIA THE FOLLOWING TEMPLATE THE ISSUE MIGHT BE CLOSED WITHOUT FURTHER CONSIDERATION OR INVESTIGATION
 3 | -->
 4 | > Please provide us with the following information:
 5 | > ---------------------------------------------------------------
 6 | 
 7 | ### This issue is for a: (mark with an `x`)
 8 | ```
 9 | - [ ] bug report -> please search issues before submitting
10 | - [ ] feature request
11 | - [ ] documentation issue or request
12 | - [ ] regression (a behavior that used to work and stopped in a new release)
13 | ```
14 | 
15 | ### Minimal steps to reproduce
16 | >
17 | 
18 | ### Any log messages given by the failure
19 | >
20 | 
21 | ### Expected/desired behavior
22 | >
23 | 
24 | ### OS and Version?
25 | > Windows 7, 8 or 10. Linux (which distribution). macOS (Yosemite? El Capitan? Sierra?)
26 | 
27 | ### Versions
28 | >
29 | 
30 | ### Mention any other details that might be useful
31 | 
32 | > ---------------------------------------------------------------
33 | > Thanks! We'll be in touch soon.
34 | 


--------------------------------------------------------------------------------
/.github/PULL_REQUEST_TEMPLATE.md:
--------------------------------------------------------------------------------
 1 | ## Purpose
 2 | <!-- Describe the intention of the changes being proposed. What problem does it solve or functionality does it add? -->
 3 | * ...
 4 | 
 5 | ## Does this introduce a breaking change?
 6 | <!-- Mark one with an "x". -->
 7 | ```
 8 | [ ] Yes
 9 | [ ] No
10 | ```
11 | 
12 | ## Pull Request Type
13 | What kind of change does this Pull Request introduce?
14 | 
15 | <!-- Please check the one that applies to this PR using "x". -->
16 | ```
17 | [ ] Bugfix
18 | [ ] Feature
19 | [ ] Code style update (formatting, local variables)
20 | [ ] Refactoring (no functional changes, no api changes)
21 | [ ] Documentation content changes
22 | [ ] Other... Please describe:
23 | ```
24 | 
25 | ## How to Test
26 | *  Get the code
27 | 
28 | ```
29 | git clone [repo-address]
30 | cd [repo-name]
31 | git checkout [branch-name]
32 | npm install
33 | ```
34 | 
35 | * Test the code
36 | <!-- Add steps to run the tests suite and/or manually test -->
37 | ```
38 | ```
39 | 
40 | ## What to Check
41 | Verify that the following are valid
42 | * ...
43 | 
44 | ## Other Information
45 | <!-- Add any other helpful information that may be needed here. -->


--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
 1 | ## [project-title] Changelog
 2 | 
 3 | <a name="x.y.z"></a>
 4 | # x.y.z (yyyy-mm-dd)
 5 | 
 6 | *Features*
 7 | * ...
 8 | 
 9 | *Bug Fixes*
10 | * ...
11 | 
12 | *Breaking Changes*
13 | * ...
14 | 


--------------------------------------------------------------------------------
/CONTRIBUTING.md:
--------------------------------------------------------------------------------
 1 | # Contributing to [project-title]
 2 | 
 3 | This project welcomes contributions and suggestions.  Most contributions require you to agree to a
 4 | Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
 5 | the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
 6 | 
 7 | When you submit a pull request, a CLA bot will automatically determine whether you need to provide
 8 | a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions
 9 | provided by the bot. You will only need to do this once across all repos using our CLA.
10 | 
11 | This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
12 | For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
13 | contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
14 | 
15 |  - [Code of Conduct](#coc)
16 |  - [Issues and Bugs](#issue)
17 |  - [Feature Requests](#feature)
18 |  - [Submission Guidelines](#submit)
19 | 
20 | ## <a name="coc"></a> Code of Conduct
21 | Help us keep this project open and inclusive. Please read and follow our [Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
22 | 
23 | ## <a name="issue"></a> Found an Issue?
24 | If you find a bug in the source code or a mistake in the documentation, you can help us by
25 | [submitting an issue](#submit-issue) to the GitHub Repository. Even better, you can
26 | [submit a Pull Request](#submit-pr) with a fix.
27 | 
28 | ## <a name="feature"></a> Want a Feature?
29 | You can *request* a new feature by [submitting an issue](#submit-issue) to the GitHub
30 | Repository. If you would like to *implement* a new feature, please submit an issue with
31 | a proposal for your work first, to be sure that we can use it.
32 | 
33 | * **Small Features** can be crafted and directly [submitted as a Pull Request](#submit-pr).
34 | 
35 | ## <a name="submit"></a> Submission Guidelines
36 | 
37 | ### <a name="submit-issue"></a> Submitting an Issue
38 | Before you submit an issue, search the archive, maybe your question was already answered.
39 | 
40 | If your issue appears to be a bug, and hasn't been reported, open a new issue.
41 | Help us to maximize the effort we can spend fixing issues and adding new
42 | features, by not reporting duplicate issues.  Providing the following information will increase the
43 | chances of your issue being dealt with quickly:
44 | 
45 | * **Overview of the Issue** - if an error is being thrown a non-minified stack trace helps
46 | * **Version** - what version is affected (e.g. 0.1.2)
47 | * **Motivation for or Use Case** - explain what are you trying to do and why the current behavior is a bug for you
48 | * **Browsers and Operating System** - is this a problem with all browsers?
49 | * **Reproduce the Error** - provide a live example or a unambiguous set of steps
50 | * **Related Issues** - has a similar issue been reported before?
51 | * **Suggest a Fix** - if you can't fix the bug yourself, perhaps you can point to what might be
52 |   causing the problem (line of code or commit)
53 | 
54 | You can file new issues by providing the above information at the corresponding repository's issues link: https://github.com/[organization-name]/[repository-name]/issues/new].
55 | 
56 | ### <a name="submit-pr"></a> Submitting a Pull Request (PR)
57 | Before you submit your Pull Request (PR) consider the following guidelines:
58 | 
59 | * Search the repository (https://github.com/[organization-name]/[repository-name]/pulls) for an open or closed PR
60 |   that relates to your submission. You don't want to duplicate effort.
61 | 
62 | * Make your changes in a new git fork:
63 | 
64 | * Commit your changes using a descriptive commit message
65 | * Push your fork to GitHub:
66 | * In GitHub, create a pull request
67 | * If we suggest changes then:
68 |   * Make the required updates.
69 |   * Rebase your fork and force push to your GitHub repository (this will update your Pull Request):
70 | 
71 |     ```shell
72 |     git rebase master -i
73 |     git push -f
74 |     ```
75 | 
76 | That's it! Thank you for your contribution!
77 | 


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/README.md:
--------------------------------------------------------------------------------
 1 | |page_type| languages                             |products
 2 | |---|---------------------------------------|---|
 3 | |sample| <table><tr><td>Java</tr></td></table> |<table><tr><td>azure</td><td>azure-communication-services</td></tr></table>|
 4 | 
 5 | # Connect to a room call using Call Automation SDK
 6 | 
 7 | In this quickstart sample, we cover how you can use Call Automation SDK to connect to an active Azure Communication Services (ACS) Rooms call with a connect endpoint.
 8 | This involves creating a room call with room id and users and enabling PSTN dial out to add PSTN participant(s). 
 9 | 
10 | ## Prerequisites
11 | 
12 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
13 | - A deployed Communication Services resource. [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
14 | - A [phone number](https://learn.microsoft.com/en-us/azure/communication-services/quickstarts/telephony/get-phone-number) in your Azure Communication Services resource that can make outbound calls. NB: phone numbers are not available in free subscriptions.
15 | - Create Azure AI Multi Service resource. For details, see [Create an Azure AI Multi service](https://learn.microsoft.com/en-us/azure/cognitive-services/cognitive-services-apis-create-account).
16 | - [Java Development Kit (JDK) Microsoft.OpenJDK.17](https://learn.microsoft.com/en-us/java/openjdk/download)
17 | - [Apache Maven](https://maven.apache.org/download.cgi)
18 | - Create and host a Azure Dev Tunnel. Instructions [here](https://learn.microsoft.com/en-us/azure/developer/dev-tunnels/get-started)
19 | - To know about rooms see https://learn.microsoft.com/en-us/azure/communication-services/concepts/rooms/room-concept
20 | - To join room call see https://learn.microsoft.com/en-us/azure/communication-services/quickstarts/rooms/join-rooms-call?pivots=platform-web
21 | 
22 | ## Before running the sample for the first time
23 | 
24 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you would like to clone the sample to.
25 | 2. git clone `https://github.com/Azure-Samples/communication-services-java-quickstarts.git`.
26 | 3. cd into the `CallAutomation-Connect-Room` folder.
27 | 4. From the root of the above folder, and with node installed, run `mvn clean package`
28 | 
29 | ## Before running calling rooms quickstart
30 | 1. To initiate rooms call with room id https://github.com/Azure-Samples/communication-services-javascript-quickstarts/tree/main/calling-rooms-quickstart
31 | 2. cd into the `calling-rooms-quickstart` folder.
32 | 3. From the root of the above folder, and with node installed, run `npm install`
33 | 4. to run sample `npx webpack serve --config webpack.config.js`
34 | 
35 | ### Setup and host your Azure DevTunnel
36 | 
37 | [Azure DevTunnels](https://learn.microsoft.com/en-us/azure/developer/dev-tunnels/get-started?tabs=windows) is an Azure service that enables you to share local web services hosted on the internet. Use the commands below to connect your local development environment to the public internet. This creates a tunnel with a persistent endpoint URL and which allows anonymous access. We will then use this endpoint to notify your application of calling events from the ACS Call Automation service.
38 | 
39 | ```bash
40 | devtunnel create --allow-anonymous
41 | devtunnel port create -p 8080
42 | devtunnel host
43 | ```
44 | 
45 | ### Configuring application
46 | 
47 | - Open the application.yml file in the resources folder to configure the following settings
48 | 
49 |     - `connectionstring`: Azure Communication Service resource's connection string.
50 |     - `callerphonenumber`: Phone number associated with the Azure Communication Service resource.
51 |     - `targetphonenumber`: Target Phone number.
52 | 
53 |       Format: "OutboundTarget(Phone Number)".
54 | 
55 |           For e.g. "+1425XXXAAAA"
56 |     - `basecallbackuri`: Base url of the app. For local development use dev tunnel url.
57 |     - `cognitiveServiceEndpoint` Cognitive service endpoint.
58 | 
59 | ### Run the application
60 | 
61 | - Navigate to the directory containing the pom.xml file and use the following mvn commands:
62 |     - Compile the application: mvn compile
63 |     - Build the package: mvn package
64 |     - Execute the app: mvn exec:java
65 |     - Access the UI at http://localhost:8080/
66 | 
67 | ### Creating and connecting to room call.
68 | 
69 | 1. Navigate to `http://localhost:8080/` or devtunnel url to create users and room id ![create room with user](./data/createRoom.png)
70 | 2. Open two tabs for Presenter and attendee  ![calling room quickstart](./data/callingRoomQuickstart.png) 
71 | 3. Copy tokens for presenter and attendee from ![tokens](./data/tokens.png)
72 | 4. Initialize call agent with tokens for both presenter and attendee.
73 | 5. Take room id ![room id](./data/roomId.png) and initiate rooms call for both users. ![join room call](./data/joinRoomCall.png)
74 | 6. Connect room call with call automation connect call endpoint. ![connect room call](./data/connectCall.png)
75 | 


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/data/callingRoomQuickstart.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation-Connect-Room/data/callingRoomQuickstart.png


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/data/connectCall.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation-Connect-Room/data/connectCall.png


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/data/createRoom.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation-Connect-Room/data/createRoom.png


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/data/joinRoomCall.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation-Connect-Room/data/joinRoomCall.png


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/data/roomId.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation-Connect-Room/data/roomId.png


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/data/tokens.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation-Connect-Room/data/tokens.png


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/src/main/java/com/communication/callautomation/AppConfig.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callautomation;
 2 | 
 3 | import lombok.Getter;
 4 | import org.springframework.boot.context.properties.ConfigurationProperties;
 5 | import org.springframework.boot.context.properties.bind.ConstructorBinding;
 6 | 
 7 | @ConfigurationProperties(prefix = "acs")
 8 | @Getter
 9 | public class AppConfig {
10 |     private final String connectionString;
11 |     private final String basecallbackuri;
12 |     private final String callerphonenumber;
13 |     private final String targetphonenumber;
14 |     private final String cognitiveServiceEndpoint;
15 | 
16 |     @ConstructorBinding
17 |     AppConfig(final String connectionString,
18 |             final String basecallbackuri,
19 |             final String callerphonenumber,
20 |             final String targetphonenumber,
21 |             final String cognitiveServiceEndpoint,
22 |             final String targetTeamsUserId,
23 |             final String[] allowedOrigins) {
24 |         this.connectionString = connectionString;
25 |         this.basecallbackuri = basecallbackuri;
26 |         this.callerphonenumber = callerphonenumber;
27 |         this.targetphonenumber = targetphonenumber;
28 |         this.cognitiveServiceEndpoint = cognitiveServiceEndpoint;
29 |     }
30 | 
31 |     public String getCallBackUri() {
32 |         return basecallbackuri + "/api/callback";
33 |     }
34 | }
35 | 


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/src/main/java/com/communication/callautomation/Main.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callautomation;
 2 | 
 3 | import org.springframework.boot.SpringApplication;
 4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 5 | import org.springframework.boot.context.properties.EnableConfigurationProperties;
 6 | 
 7 | @SpringBootApplication
 8 | @EnableConfigurationProperties(value = AppConfig.class)
 9 | public class Main {
10 |     public static void main(String[] args) {
11 |         SpringApplication.run(Main.class, args);
12 |     }
13 | }


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/src/main/java/com/communication/callautomation/config/WebConfig.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callautomation.config;
 2 | 
 3 | import org.springframework.beans.factory.annotation.Autowired;
 4 | import org.springframework.context.annotation.Configuration;
 5 | import org.springframework.web.servlet.config.annotation.CorsRegistry;
 6 | import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
 7 | 
 8 | import com.communication.callautomation.AppConfig;
 9 | 
10 | @Configuration
11 | public class WebConfig implements WebMvcConfigurer {
12 | 
13 |     @Autowired
14 |     private AppConfig appConfig; // Inject AppConfig to access allowedOrigins
15 | 
16 |     @Override
17 |     public void addCorsMappings(CorsRegistry registry) {
18 |         // Allow all APIs to accept CORS requests from your frontend
19 |         registry.addMapping("/**") // Apply to all endpoints
20 |                 .allowedMethods("GET", "POST", "PUT", "DELETE", "OPTIONS") // Allowed HTTP methods
21 |                 .allowedHeaders("*") // Allow all headers
22 |                 .maxAge(3600); // Cache the pre-flight response for 1 hour
23 |     }
24 | 
25 | }
26 | 


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/src/main/resources/application.yml:
--------------------------------------------------------------------------------
 1 | spring:
 2 |   application:
 3 |     name: CallAutomation-Connect-Room
 4 | 
 5 | server:
 6 |   port: 8080
 7 | 
 8 | acs:
 9 |   connectionstring: <ENTER YOUR ACS CONNECTION STRING>
10 |   basecallbackuri: <ENTER YOUR DEV TUNNEL BASE URL>
11 |   callerphonenumber: <ENTER ACS PHONE NUMBER>
12 |   targetphonenumber: <ENTER AGENT PHONE NUMBER>
13 |   cognitiveServiceEndpoint: <ENTER YOUR COGNITIVE SERVICE URL>
14 | 


--------------------------------------------------------------------------------
/CallAutomation-Connect-Room/src/main/resources/templates/index.html:
--------------------------------------------------------------------------------
 1 | <!DOCTYPE html>
 2 | <html lang="en">
 3 | 
 4 | <head>
 5 |     <title>Azure Communication Services Quickstart</title>
 6 | </head>
 7 | 
 8 | <body>
 9 |     <h4>Azure Communication Services</h4>
10 |     <h2>Connect Rooms Call Quickstart</h2>
11 |     <div>
12 |         <button onclick="connectCall()">Connect call!</button>
13 |         <button onclick="addParticipant()">Add participant!</button>
14 |         <button onclick="playMedia()">Play media!</button>
15 |         <button onclick="hangupCall()">Hangup call!</button>
16 |     </div>
17 | 
18 |     <h3>Room Details</h3>
19 | 
20 |     <div id="roomId-info">
21 |         <h4>Room</h4>
22 |         <p>Room Id: <span id="roomId-text">Loading roomId...</span></p>
23 |     </div>
24 | 
25 |     <div id="presenter-info">
26 |         <h4>Presenter</h4>
27 |         <p>User Id: <span id="presenter-id">Loading presenter userId...</span></p>
28 |         <p>Token: <span id="presenter-token">Loading presenter token...</span></p>
29 |     </div>
30 | 
31 |     <div id="attendee-info">
32 |         <h4>Attendee</h4>
33 |         <p>User Id: <span id="attendee-id">Loading attendee userId...</span></p>
34 |         <p>Token: <span id="attendee-token">Loading attendee token...</span></p>
35 |     </div>
36 | 
37 |     <script>
38 |         fetch('/create-room', { method: 'POST' })
39 |             .then(response => response.json())
40 |             .then(data => {
41 |                 document.getElementById('roomId-text').innerText = `${data.roomId}`;
42 |                 document.getElementById('presenter-id').innerText = `${data.user1Id}`;
43 |                 document.getElementById('presenter-token').innerText = `${data.user1Token}`;
44 |                 document.getElementById('attendee-id').innerText = `${data.user2Id}`;
45 |                 document.getElementById('attendee-token').innerText = `${data.user2Token}`;
46 |             })
47 |             .catch(error => {
48 |                 console.error('Error fetching user data:', error);
49 |             });
50 | 
51 |         function connectCall() {
52 |             fetch('/connectCall', {
53 |                 method: 'POST',
54 |             })
55 |         }
56 | 
57 |         function addParticipant() {
58 |             fetch('/add-pstn-participant', {
59 |                 method: 'POST',
60 |             })
61 |         }
62 | 
63 |         function playMedia() {
64 |             fetch('/playMedia', {
65 |                 method: 'POST',
66 |             })
67 |         }
68 | 
69 |         function hangupCall() {
70 |             fetch('/hangUp', {
71 |                 method: 'POST',
72 |             })
73 |         }
74 |     </script>
75 | </body>
76 | 
77 | </html>


--------------------------------------------------------------------------------
/CallAutomation_Live_Transcription/README.md:
--------------------------------------------------------------------------------
 1 | |page_type| languages                             |products
 2 | |---|---------------------------------------|---|
 3 | |sample| <table><tr><td>Java</tr></td></table> |<table><tr><td>azure</td><td>azure-communication-services</td></tr></table>|
 4 | 
 5 | # Call Live Transcription - Quick Start Sample
 6 | 
 7 | This sample application shows how the Azure Communication Services  - Call Automation SDK can be used generate the live transcription between PSTN calls. 
 8 | It accepts an incoming call from a phone number, performs DTMF recognition, and transfer the call to agent. You can see the live transcription in websocket during the conversation between agent and user
 9 | This sample application is also capable of making multiple concurrent inbound calls. The application is a web-based application built on Java's Spring framework.
10 | 
11 | 
12 | ## Prerequisites
13 | 
14 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
15 | - A deployed Communication Services resource. [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
16 | - A [phone number](https://learn.microsoft.com/en-us/azure/communication-services/quickstarts/telephony/get-phone-number) in your Azure Communication Services resource that can make outbound calls. NB: phone numbers are not available in free subscriptions.
17 | - [Java Development Kit (JDK) Microsoft.OpenJDK.17](https://learn.microsoft.com/en-us/java/openjdk/download)
18 | - [Apache Maven](https://maven.apache.org/download.cgi)
19 | - Create Azure AI Multi Service resource. For details, see [Create an Azure AI Multi service](https://learn.microsoft.com/en-us/azure/cognitive-services/cognitive-services-apis-create-account).
20 | 
21 | ## Before running the sample for the first time
22 | 
23 | ### Setup and host your Azure DevTunnel
24 | 
25 | [Azure DevTunnels](https://learn.microsoft.com/en-us/azure/developer/dev-tunnels/get-started?tabs=windows) is an Azure service that enables you to share local web services hosted on the internet. Use the commands below to connect your local development environment to the public internet. This creates a tunnel with a persistent endpoint URL and which allows anonymous access. We will then use this endpoint to notify your application of calling events from the ACS Call Automation service.
26 | 
27 | ```bash
28 | devtunnel create --allow-anonymous
29 | devtunnel port create -p 8080
30 | devtunnel host
31 | ```
32 | 
33 | ### Configuring application
34 | 
35 | - Open the application.yml file in the resources folder to configure the following settings
36 | 
37 |     - `connectionstring`: Azure Communication Service resource's connection string.
38 |     - `basecallbackuri`: Base url of the app. For local development use dev tunnel url.
39 |     - `cognitiveServicesUrl`: The Cognitive Services endpoint
40 |     - `acsPhoneNumber`: Acs Phone Number
41 |     - `agentPhoneNumber`: Agent Phone Number
42 |     - `locale`: Transcription locale
43 | 
44 | ### Run the application
45 | 
46 | - Open new terminal and navigate to the directory containing the pom.xml file and use the following mvn commands to run app:
47 |     - Compile the application: mvn compile
48 |     - Build the package: mvn package
49 |     - Execute the app: `mvn exec:java -Papp`
50 | - Access the Swagger UI at http://localhost:8080/swagger-ui/index.html
51 | - Register an EventGrid Webhook for the IncomingCall Event that points to your DevTunnel URI endpoint ex `{basecallbackuri}/api/incomingCall` and register Recording File Status Updated event to you recordingstatus api endpoint ex. `{basecallbackuri}/api/recordingFileStatus`. Instructions [here](https://learn.microsoft.com/en-us/azure/communication-services/concepts/call-automation/incoming-call-notification).
52 | 
53 | Once that's completed you should have a running application. The best way to test this is to place a call to your ACS phone number and talk to your intelligent agent.


--------------------------------------------------------------------------------
/CallAutomation_Live_Transcription/src/main/java/com/communication/callautomation/AppConfig.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callautomation;
 2 | 
 3 | import lombok.Getter;
 4 | import org.springframework.boot.context.properties.ConfigurationProperties;
 5 | import org.springframework.boot.context.properties.bind.ConstructorBinding;
 6 | 
 7 | @ConfigurationProperties(prefix = "acs")
 8 | @Getter
 9 | public class AppConfig {
10 |     private final String connectionString;
11 |     private final String basecallbackuri;
12 |     private final String cognitiveServicesUrl;
13 |     private final String agentPhoneNumber;
14 |     private final String acsPhoneNumber;
15 |     private final String locale;
16 | 
17 |     @ConstructorBinding
18 |     AppConfig(final String connectionString,
19 |               final String basecallbackuri,
20 |               final String cognitiveServicesUrl,
21 |               final String agentPhoneNumber,
22 |               final String acsPhoneNumber,
23 |               final String locale) {
24 |         this.connectionString = connectionString;
25 |         this.basecallbackuri = basecallbackuri;
26 |         this.cognitiveServicesUrl = cognitiveServicesUrl;
27 |         this.agentPhoneNumber = agentPhoneNumber;
28 |         this.acsPhoneNumber = acsPhoneNumber;
29 |         this.locale = locale;
30 |     }
31 | 
32 |     public String getCallBackUri() {
33 |         return basecallbackuri + "/api/callback";
34 |     }
35 | 
36 |     public String getCallBackUriForRecordingApis() {
37 |         return basecallbackuri + "/api/recordingcallback";
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/CallAutomation_Live_Transcription/src/main/java/com/communication/callautomation/Main.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callautomation;
 2 | 
 3 | import org.springframework.boot.SpringApplication;
 4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 5 | import org.springframework.boot.context.properties.EnableConfigurationProperties;
 6 | 
 7 | @SpringBootApplication
 8 | @EnableConfigurationProperties(value = AppConfig.class)
 9 | public class Main {
10 |     public static void main(String[] args) {
11 |         SpringApplication.run(Main.class, args);
12 |     }
13 | }


--------------------------------------------------------------------------------
/CallAutomation_Live_Transcription/src/main/java/com/communication/callautomation/WebSocketConfig.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callautomation;
 2 | 
 3 | import org.springframework.context.annotation.Configuration;
 4 | import org.springframework.web.socket.config.annotation.EnableWebSocket;
 5 | import org.springframework.web.socket.config.annotation.WebSocketConfigurer;
 6 | import org.springframework.web.socket.config.annotation.WebSocketHandlerRegistry;
 7 | 
 8 | @Configuration
 9 | @EnableWebSocket  // Enables WebSocket support
10 | public class WebSocketConfig implements WebSocketConfigurer {
11 | 
12 |     @Override
13 |     public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) {
14 |         registry.addHandler(new WebSocketHandler(), "/ws")  // Registering WebSocket handler
15 |                 .setAllowedOrigins("*");  // Allow connections from any origin (adjust as needed)
16 |     }
17 | }
18 | 


--------------------------------------------------------------------------------
/CallAutomation_Live_Transcription/src/main/java/com/communication/callautomation/WebSocketHandler.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callautomation;
 2 | 
 3 | import org.springframework.web.socket.WebSocketSession;
 4 | import org.springframework.web.socket.handler.TextWebSocketHandler;
 5 | import org.springframework.web.socket.TextMessage;
 6 | import com.azure.communication.callautomation.StreamingDataParser;
 7 | import com.azure.communication.callautomation.models.StreamingData;
 8 | import com.azure.communication.callautomation.models.TranscriptionData;
 9 | import com.azure.communication.callautomation.models.TranscriptionMetadata;
10 | import com.azure.communication.callautomation.models.WordData;
11 | 
12 | public class WebSocketHandler extends TextWebSocketHandler {
13 | 
14 |     @Override
15 |     protected void handleTextMessage(WebSocketSession session, TextMessage message) throws Exception {
16 |         String payload = message.getPayload();
17 |         System.out.println("Received message: " + payload);
18 | 
19 |         // Parse the message into StreamingData (custom data parsing logic)
20 |         StreamingData data = StreamingDataParser.parse(payload);
21 | 
22 |         // Handle TranscriptionMetadata
23 |         if (data instanceof TranscriptionMetadata) {
24 |             TranscriptionMetadata transcriptionMetadata = (TranscriptionMetadata) data;
25 |             System.out.println("----------------------------------------------------------------");
26 |             System.out.println("TRANSCRIPTION SUBSCRIPTION ID:-->" + transcriptionMetadata.getTranscriptionSubscriptionId());
27 |             System.out.println("LOCALE:-->" + transcriptionMetadata.getLocale());
28 |             System.out.println("CALL CONNECTION ID:-->" + transcriptionMetadata.getCallConnectionId());
29 |             System.out.println("CORRELATION ID:-->" + transcriptionMetadata.getCorrelationId());
30 |             System.out.println("----------------------------------------------------------------");
31 |         }
32 | 
33 |         // Handle TranscriptionData
34 |         if (data instanceof TranscriptionData) {
35 |             TranscriptionData transcriptionData = (TranscriptionData) data;
36 |             System.out.println("----------------------------------------------------------------");
37 |             System.out.println("TEXT:-->" + transcriptionData.getText());
38 |             System.out.println("FORMAT:-->" + transcriptionData.getFormat());
39 |             System.out.println("CONFIDENCE:-->" + transcriptionData.getConfidence());
40 |             System.out.println("OFFSET:-->" + transcriptionData.getOffset());
41 |             System.out.println("DURATION:-->" + transcriptionData.getDuration());
42 | 
43 |             String participant = transcriptionData.getParticipant().getRawId() != null
44 |                     ? transcriptionData.getParticipant().getRawId()
45 |                     : "";
46 |             System.out.println("PARTICIPANT:-->" + participant);
47 |             System.out.println("RESULT STATUS:-->" + transcriptionData.getResultStatus());
48 | 
49 |             // Print word data (example of transcribed words)
50 |             for (WordData word : transcriptionData.getTranscripeWords()) {
51 |                 System.out.println("TEXT:-->" + word.getText());
52 |                 System.out.println("OFFSET:-->" + word.getOffset());
53 |                 System.out.println("DURATION:-->" + word.getDuration());
54 |             }
55 |             System.out.println("----------------------------------------------------------------");
56 |         }
57 | 
58 |         // Send an echo response back to the client
59 |         session.sendMessage(new TextMessage("Echo: " + payload));
60 |     }
61 | }
62 | 


--------------------------------------------------------------------------------
/CallAutomation_Live_Transcription/src/main/resources/application.yml:
--------------------------------------------------------------------------------
 1 | spring:
 2 |   application:
 3 |     name: CallAutomation_LiveTranscription
 4 | 
 5 | server:
 6 |   port: 8080
 7 | 
 8 | acs:
 9 |   connectionstring: <ENTER YOUR ACS CONNECTION STRING>
10 |   basecallbackuri: <ENTER YOUR DEV TUNNEL BASE URL>
11 |   cognitiveServicesUrl: <ENTER YOUR COGNITIVE SERVICE URL>
12 |   acsPhoneNumber: <ENTER ACS PHONE NUMBER>
13 |   agentPhoneNumber: <ENTER AGENT PHONE NUMBER>
14 |   locale: <ENTER LOCALE>
15 | 


--------------------------------------------------------------------------------
/CallAutomation_OpenAI_Sample/README.md:
--------------------------------------------------------------------------------
 1 | |page_type| languages                             |products
 2 | |---|---------------------------------------|---|
 3 | |sample| <table><tr><td>Java</tr></td></table> |<table><tr><td>azure</td><td>azure-communication-services</td></tr></table>|
 4 | 
 5 | # Call Automation - Quick Start Sample
 6 | 
 7 | This sample application shows how the Azure Communication Services  - Call Automation SDK can be used with Azure OpenAI Service to enable intelligent conversational agents. 
 8 | It answers an inbound call, does a speech recognition with the recognize API and Cognitive Services, uses OpenAi Services with the input speech and responds to the caller through Cognitive Services' Text to Speech. 
 9 | This sample application configured for accepting input speech until the caller terminates the call or a long silence is detected.
10 | This sample application is also capable of making multiple concurrent inbound calls. The application is a web-based application built on Java's Spring framework.
11 | 
12 | 
13 | ## Prerequisites
14 | 
15 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
16 | - A deployed Communication Services resource. [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
17 | - A [phone number](https://learn.microsoft.com/en-us/azure/communication-services/quickstarts/telephony/get-phone-number) in your Azure Communication Services resource that can make outbound calls. NB: phone numbers are not available in free subscriptions.
18 | - [Java Development Kit (JDK) Microsoft.OpenJDK.17](https://learn.microsoft.com/en-us/java/openjdk/download)
19 | - [Apache Maven](https://maven.apache.org/download.cgi)
20 | - Create and host a Azure Dev Tunnel. Instructions [here](https://learn.microsoft.com/en-us/azure/developer/dev-tunnels/get-started)
21 | - Create an Azure Cognitive Services resource. For details, see Create an Azure Cognitive Services Resource.
22 | - An Azure OpenAI Resource and Deployed Model. See https://learn.microsoft.com/en-us/azure/ai-services/openai/how-to/create-resource?pivots=web-portal.
23 | 
24 | ## Before running the sample for the first time
25 | 
26 | - Open the application.yml file in the resources folder to configure the following settings
27 | 
28 |     - `connectionstring`: Azure Communication Service resource's connection string.
29 |     - `basecallbackuri`: Base url of the app. For local development use dev tunnel url.
30 |     - `cognitiveServicesUrl`: The Cognitive Services endpoint
31 |     - `azureOpenAiServiceKey`: Open AI's Service Key
32 |     - `azureOpenAiServiceEndpoint`: Open AI's Service Endpoint
33 |     - `openAiModelName`: Open AI's Model name
34 |     - `agentPhoneNumber`: Agent Phone Number
35 | 
36 | 
37 | ### Setup and host your Azure DevTunnel
38 | 
39 | [Azure DevTunnels](https://learn.microsoft.com/en-us/azure/developer/dev-tunnels/overview) is an Azure service that enables you to share local web services hosted on the internet. Use the commands below to connect your local development environment to the public internet. This creates a tunnel with a persistent endpoint URL and which allows anonymous access. We will then use this endpoint to notify your application of calling events from the ACS Call Automation service.
40 | 
41 | ```bash
42 | devtunnel create --allow-anonymous
43 | devtunnel port create -p 8080
44 | devtunnel host
45 | ```
46 | 
47 | ### Run the application
48 | 
49 | - Navigate to the directory containing the pom.xml file and use the following mvn commands:
50 |     - Compile the application: mvn compile
51 |     - Build the package: mvn package
52 |     - Execute the app: mvn exec:java
53 | - Access the Swagger UI at http://localhost:8080/swagger-ui.html
54 |     - Try the GET /outboundCall to run the Sample Application


--------------------------------------------------------------------------------
/CallAutomation_OpenAI_Sample/src/main/java/com/communication/callautomation/AppConfig.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callautomation;
 2 | 
 3 | import lombok.Getter;
 4 | import org.springframework.boot.context.properties.ConfigurationProperties;
 5 | import org.springframework.boot.context.properties.bind.ConstructorBinding;
 6 | 
 7 | @ConfigurationProperties(prefix = "acs")
 8 | @Getter
 9 | public class AppConfig {
10 |     private final String connectionString;
11 |     private final String basecallbackuri;
12 |     private final String cognitiveServicesUrl;
13 |     private final String azureOpenAiServiceKey;
14 |     private final String azureOpenAiServiceEndpoint;
15 |     private final String openAiModelName;
16 |     private final String agentPhoneNumber;
17 | 
18 |     @ConstructorBinding
19 |     AppConfig(final String connectionString,
20 |               final String basecallbackuri,
21 |               final String cognitiveServicesUrl,
22 |               final String azureOpenAiServiceKey,
23 |               final String azureOpenAiServiceEndpoint,
24 |               final String openAiModelName,
25 |               final String agentPhoneNumber) {
26 |         this.connectionString = connectionString;
27 |         this.basecallbackuri = basecallbackuri;
28 |         this.cognitiveServicesUrl = cognitiveServicesUrl;
29 |         this.azureOpenAiServiceKey = azureOpenAiServiceKey;
30 |         this.azureOpenAiServiceEndpoint = azureOpenAiServiceEndpoint;
31 |         this.openAiModelName = openAiModelName;
32 |         this.agentPhoneNumber = agentPhoneNumber;
33 |     }
34 | 
35 |     public String getCallBackUri() {
36 |         return basecallbackuri + "/api/callback";
37 |     }
38 | 
39 |     public String getCallBackUriForRecordingApis() {
40 |         return basecallbackuri + "/api/recordingcallback";
41 |     }
42 | }
43 | 


--------------------------------------------------------------------------------
/CallAutomation_OpenAI_Sample/src/main/java/com/communication/callautomation/Main.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callautomation;
 2 | 
 3 | import org.springframework.boot.SpringApplication;
 4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 5 | import org.springframework.boot.context.properties.EnableConfigurationProperties;
 6 | 
 7 | @SpringBootApplication
 8 | @EnableConfigurationProperties(value = AppConfig.class)
 9 | public class Main {
10 |     public static void main(String[] args) {
11 |         SpringApplication.run(Main.class, args);
12 |     }
13 | }


--------------------------------------------------------------------------------
/CallAutomation_OpenAI_Sample/src/main/resources/application.yml:
--------------------------------------------------------------------------------
 1 | spring:
 2 |   application:
 3 |     name: CallAutomation_OutboundCalling
 4 | 
 5 | server:
 6 |   port: 8080
 7 | 
 8 | acs:
 9 |   connectionstring: <ENTER YOUR ACS CONNECTION STRING>
10 |   basecallbackuri: <ENTER YOUR DEV TUNNEL BASE URL>
11 |   cognitiveServicesUrl: <ENTER YOUR COGNITIVE SERVICE URL>
12 |   azureOpenAiServiceKey: <ENTER YOUR COGNITIVE SERVICE VAULT KEY>
13 |   azureOpenAiServiceEndpoint: <ENTER YOUR OPENAI SERVICE URL>
14 |   openAiModelName: <ENTER YOUR OPENAI MODEL NAME>
15 |   agentPhoneNumber: <ENTER AGENT PHONE NUMBER>
16 | 


--------------------------------------------------------------------------------
/CallAutomation_OpenAI_Sample/static/Confirmed.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation_OpenAI_Sample/static/Confirmed.wav


--------------------------------------------------------------------------------
/CallAutomation_OpenAI_Sample/static/Goodbye.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation_OpenAI_Sample/static/Goodbye.wav


--------------------------------------------------------------------------------
/CallAutomation_OpenAI_Sample/static/Invalid.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation_OpenAI_Sample/static/Invalid.wav


--------------------------------------------------------------------------------
/CallAutomation_OpenAI_Sample/static/MainMenu.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation_OpenAI_Sample/static/MainMenu.wav


--------------------------------------------------------------------------------
/CallAutomation_OpenAI_Sample/static/OutboundCallDesign.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation_OpenAI_Sample/static/OutboundCallDesign.png


--------------------------------------------------------------------------------
/CallAutomation_OpenAI_Sample/static/Timeout.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation_OpenAI_Sample/static/Timeout.wav


--------------------------------------------------------------------------------
/CallAutomation_OutboundCalling/README.md:
--------------------------------------------------------------------------------
 1 | |page_type| languages                             |products
 2 | |---|---------------------------------------|---|
 3 | |sample| <table><tr><td>Java</tr></td></table> |<table><tr><td>azure</td><td>azure-communication-services</td></tr></table>|
 4 | 
 5 | # Call Automation - Quick Start Sample
 6 | 
 7 | In this quickstart, we cover how you can use Call Automation SDK to make an outbound call to a phone number and use the newly announced integration with Azure AI services to play dynamic prompts to participants using Text-to-Speech and recognize user voice input through Speech-to-Text to drive business logic in your application. 
 8 | 
 9 | # Design
10 | 
11 | ![design](./static/OutboundCallDesign.png)
12 | 
13 | ## Prerequisites
14 | 
15 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
16 | - A deployed Communication Services resource. [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
17 | - A [phone number](https://learn.microsoft.com/en-us/azure/communication-services/quickstarts/telephony/get-phone-number) in your Azure Communication Services resource that can make outbound calls. NB: phone numbers are not available in free subscriptions.
18 | - Create Azure AI Multi Service resource. For details, see [Create an Azure AI Multi service](https://learn.microsoft.com/en-us/azure/cognitive-services/cognitive-services-apis-create-account).
19 | - [Java Development Kit (JDK) Microsoft.OpenJDK.17](https://learn.microsoft.com/en-us/java/openjdk/download)
20 | - [Apache Maven](https://maven.apache.org/download.cgi)
21 | - Create and host a Azure Dev Tunnel. Instructions [here](https://learn.microsoft.com/en-us/azure/developer/dev-tunnels/get-started)
22 | - (Optional) A Microsoft Teams user with a phone license that is `voice` enabled. Teams phone license is required to add Teams users to the call. Learn more about Teams licenses [here](https://www.microsoft.com/microsoft-teams/compare-microsoft-teams-bundle-options).  Learn about enabling phone system with `voice` [here](https://learn.microsoft.com/microsoftteams/setting-up-your-phone-system).   You also need to complete the prerequisite step [Authorization for your Azure Communication Services Resource](https://learn.microsoft.com/azure/communication-services/how-tos/call-automation/teams-interop-call-automation?pivots=programming-language-javascript#step-1-authorization-for-your-azure-communication-services-resource-to-enable-calling-to-microsoft-teams-users) to enable calling to Microsoft Teams users.
23 | 
24 | ## Before running the sample for the first time
25 | 
26 | - Open the application.yml file in the resources folder to configure the following settings
27 | 
28 |     - `connectionstring`: Azure Communication Service resource's connection string.
29 |     - `callerphonenumber`: Phone number associated with the Azure Communication Service resource.
30 |     - `targetphonenumber`: Target Phone number.
31 | 
32 |       Format: "OutboundTarget(Phone Number)".
33 | 
34 |           For e.g. "+1425XXXAAAA"
35 |     - `basecallbackuri`: Base url of the app. For local development use dev tunnel url.
36 |     - `cognitiveServiceEndpoint`: Cognitive Service Endpoint.
37 |     - `targetTeamsUserId`: (Optional) update field with the Microsoft Teams user Id you would like to add to the call. See [Use Graph API to get Teams user Id](../../../how-tos/call-automation/teams-interop-call-automation.md#step-2-use-the-graph-api-to-get-microsoft-entra-object-id-for-teams-users-and-optionally-check-their-presence).  Uncomment the below snippet in ProgramSample.java to enable Teams Interop scenario.
38 |       ```
39 |       client.getCallConnection(callConnectionId).addParticipant(
40 |                         new CallInvite(new MicrosoftTeamsUserIdentifier(appConfig.getTargetTeamsUserId()))
41 |                                 .setSourceDisplayName("Jack (Contoso Tech Support)"));
42 |       ```
43 | 
44 | ### Setup and host your Azure DevTunnel
45 | 
46 | [Azure DevTunnels](https://learn.microsoft.com/en-us/azure/developer/dev-tunnels/overview) is an Azure service that enables you to share local web services hosted on the internet. Use the commands below to connect your local development environment to the public internet. This creates a tunnel with a persistent endpoint URL and which allows anonymous access. We will then use this endpoint to notify your application of calling events from the ACS Call Automation service.
47 | 
48 | ```bash
49 | devtunnel create --allow-anonymous
50 | devtunnel port create -p 8080
51 | devtunnel host
52 | ```
53 | 
54 | ### Run the application
55 | 
56 | - Navigate to the directory containing the pom.xml file and use the following mvn commands:
57 |     - Compile the application: mvn compile
58 |     - Build the package: mvn package
59 |     - Execute the app: mvn exec:java
60 | - Access the Swagger UI at http://localhost:8080/swagger-ui.html
61 |     - Try the GET /outboundCall to run the Sample Application
62 | 


--------------------------------------------------------------------------------
/CallAutomation_OutboundCalling/src/main/java/com/communication/callautomation/AppConfig.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callautomation;
 2 | 
 3 | import lombok.Getter;
 4 | import org.springframework.boot.context.properties.ConfigurationProperties;
 5 | import org.springframework.boot.context.properties.bind.ConstructorBinding;
 6 | 
 7 | @ConfigurationProperties(prefix = "acs")
 8 | @Getter
 9 | public class AppConfig {
10 |     private final String connectionString;
11 |     private final String basecallbackuri;
12 |     private final String callerphonenumber;
13 |     private final String targetphonenumber;
14 |     private final String cognitiveServiceEndpoint;
15 |     private final String targetTeamsUserId;
16 | 
17 |     @ConstructorBinding
18 |     AppConfig(final String connectionString,
19 |               final String basecallbackuri,
20 |               final String callerphonenumber,
21 |               final String targetphonenumber,
22 |               final String cognitiveServiceEndpoint,
23 |               final String targetTeamsUserId) {
24 |         this.connectionString = connectionString;
25 |         this.basecallbackuri = basecallbackuri;
26 |         this.callerphonenumber = callerphonenumber;
27 |         this.targetphonenumber = targetphonenumber;
28 |         this.cognitiveServiceEndpoint = cognitiveServiceEndpoint;
29 |         this.targetTeamsUserId = targetTeamsUserId;
30 |     }
31 | 
32 |     public String getCallBackUri() {
33 |         return basecallbackuri + "/api/callback";
34 |     }
35 | 
36 |     public String getCallBackUriForRecordingApis() {
37 |         return basecallbackuri + "/api/recordingcallback";
38 |     }
39 | }
40 | 


--------------------------------------------------------------------------------
/CallAutomation_OutboundCalling/src/main/java/com/communication/callautomation/Main.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callautomation;
 2 | 
 3 | import org.springframework.boot.SpringApplication;
 4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 5 | import org.springframework.boot.context.properties.EnableConfigurationProperties;
 6 | 
 7 | @SpringBootApplication
 8 | @EnableConfigurationProperties(value = AppConfig.class)
 9 | public class Main {
10 |     public static void main(String[] args) {
11 |         SpringApplication.run(Main.class, args);
12 |     }
13 | }


--------------------------------------------------------------------------------
/CallAutomation_OutboundCalling/src/main/resources/application.yml:
--------------------------------------------------------------------------------
 1 | spring:
 2 |   application:
 3 |     name: CallAutomation_OutboundCalling
 4 | 
 5 | server:
 6 |   port: 8080
 7 | 
 8 | acs:
 9 |   connectionstring: <YOUR ACS CONNECTION STRING>
10 |   basecallbackuri: <YOUR DEV TUNNEL ENDPOINT>
11 |   callerphonenumber: <YOUR ACS PHONE NUMBER ex. "+1425XXXAAAA">
12 |   targetphonenumber: <YOUR TARGET PHONE NUMBER ex. "+1425XXXAAAA">
13 |   cognitiveServiceEndpoint: <YOUR COGNITIVE SERVICE ENDPOINT>
14 |   targetTeamsUserId: <(OPTIONAL) YOUR TARGET TEAMS USER ID ex. "ab01bc12-d457-4995-a27b-c405ecfe4870">
15 | 


--------------------------------------------------------------------------------
/CallAutomation_OutboundCalling/static/OutboundCallDesign.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/CallAutomation_OutboundCalling/static/OutboundCallDesign.png


--------------------------------------------------------------------------------
/CallRecording/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | 
  3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5 |   <modelVersion>4.0.0</modelVersion>
  6 | <parent>
  7 | 		<groupId>org.springframework.boot</groupId>
  8 | 		<artifactId>spring-boot-starter-parent</artifactId>
  9 | 		<version>2.5.1</version>
 10 | 		<relativePath/> <!-- lookup parent from repository -->
 11 | 	</parent>
 12 |   <groupId>com.communication.callautomation</groupId>
 13 |   <artifactId>callrecording</artifactId>
 14 |   <version>1.0-SNAPSHOT</version>
 15 | 
 16 |   <name>callrecording</name>
 17 |   <!-- FIXME change it to the project's website -->
 18 |   <url>http://www.example.com</url>
 19 | 
 20 |   <properties>
 21 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 22 |     <maven.compiler.source>1.7</maven.compiler.source>
 23 |     <maven.compiler.target>1.7</maven.compiler.target>
 24 | 		<java.version>11</java.version>
 25 | 		<node.version>v14.17.0</node.version>
 26 | 		<jib-maven-plugin.version>2.5.2</jib-maven-plugin.version>
 27 | 		<docker.image.prefix>{docker.image.prefix}</docker.image.prefix>
 28 |   </properties>
 29 | 
 30 |  <dependencies>		
 31 | 		<dependency>
 32 | 			<groupId>org.springframework.boot</groupId>
 33 | 			<artifactId>spring-boot-starter-web</artifactId>
 34 | 		</dependency>
 35 | 		<dependency>
 36 | 			<groupId>org.springframework.boot</groupId>
 37 | 			<artifactId>spring-boot-starter-test</artifactId>
 38 | 			<scope>test</scope>
 39 | 		</dependency>
 40 | 		<dependency>
 41 | 			<groupId>org.apache.httpcomponents</groupId>
 42 | 			<artifactId>httpclient</artifactId>
 43 | 			<version>4.5.13</version>
 44 | 		</dependency>
 45 | 		<dependency>
 46 | 			<groupId>com.azure</groupId>
 47 | 			<artifactId>azure-identity</artifactId>
 48 | 			<version>1.5.4</version>
 49 | 		</dependency>
 50 | 		<dependency>
 51 | 			<groupId>com.azure</groupId>
 52 | 			<artifactId>azure-communication-callautomation</artifactId>
 53 | 			<version>1.0.0</version>
 54 | 		</dependency>		
 55 | 		<dependency>
 56 | 			<groupId>com.azure</groupId>
 57 | 			<artifactId>azure-core</artifactId>
 58 | 			<version>1.39.0</version>
 59 | 		</dependency>		
 60 | 		<dependency>
 61 | 			<groupId>com.azure</groupId>
 62 | 			<artifactId>azure-messaging-eventgrid</artifactId>
 63 | 			<version>4.12.1</version>
 64 | 		</dependency>
 65 | 		<dependency>
 66 | 			<groupId>com.azure</groupId>
 67 | 			<artifactId>azure-cosmos</artifactId>
 68 | 			<version>4.34.0</version>
 69 | 		</dependency>
 70 | 	</dependencies>
 71 | 
 72 |   <build>
 73 | 		<pluginManagement>
 74 | 			<plugins>
 75 | 			<plugin>
 76 | 				<groupId>org.springframework.boot</groupId>
 77 | 				<artifactId>spring-boot-maven-plugin</artifactId>
 78 | 				<configuration>
 79 | 					<excludes>
 80 | 						<exclude>
 81 | 							<groupId>org.projectlombok</groupId>
 82 | 							<artifactId>lombok</artifactId>
 83 | 						</exclude>
 84 | 					</excludes>
 85 | 				</configuration>
 86 | 			</plugin>
 87 | 			<plugin>
 88 | 				<artifactId>maven-clean-plugin</artifactId>
 89 | 				<version>3.1.0</version>
 90 | 			</plugin>
 91 | 			<plugin>
 92 | 				<artifactId>maven-resources-plugin</artifactId>
 93 | 				<version>3.0.2</version>
 94 | 			</plugin>
 95 | 			<plugin>
 96 | 				<artifactId>maven-compiler-plugin</artifactId>
 97 | 				<version>3.8.0</version>
 98 | 			</plugin>
 99 | 			<plugin>
100 | 				<artifactId>maven-surefire-plugin</artifactId>
101 | 				<version>2.22.1</version>
102 | 			</plugin>
103 | 			<plugin>
104 | 				<artifactId>maven-jar-plugin</artifactId>
105 | 				<version>3.0.2</version>
106 | 			</plugin>
107 | 			<plugin>
108 | 				<artifactId>maven-deploy-plugin</artifactId>
109 | 				<version>2.8.2</version>
110 | 			</plugin>
111 | 			<plugin>
112 | 				<artifactId>maven-site-plugin</artifactId>
113 | 				<version>3.7.1</version>
114 | 			</plugin>
115 | 			<plugin>
116 | 				<artifactId>maven-project-info-reports-plugin</artifactId>
117 | 				<version>3.0.0</version>
118 | 			</plugin>
119 | 			<plugin>
120 | 				<groupId>org.codehaus.mojo</groupId>
121 | 				<artifactId>exec-maven-plugin</artifactId>
122 | 				<version>3.0.0</version>
123 | 				<executions>
124 | 					<execution>
125 | 						<goals>
126 | 							<goal>java</goal>
127 | 						</goals>
128 | 					</execution>
129 | 				</executions>
130 | 				<configuration>
131 | 					<mainClass>com.communication.callrecording.ApiApplication</mainClass>
132 | 				</configuration>
133 | 			</plugin>
134 | 			<plugin>
135 | 				<groupId>org.apache.maven.plugins</groupId>
136 | 				<artifactId>maven-install-plugin</artifactId>
137 | 				<version>2.5.2</version>
138 | 				<executions>
139 | 				</executions>
140 | 			</plugin>
141 | 			<plugin>
142 | 				<artifactId>jib-maven-plugin</artifactId>
143 | 				<groupId>com.google.cloud.tools</groupId>
144 | 				<version>${jib-maven-plugin.version}</version>
145 | 				<configuration>
146 | 					<from>
147 | 						<image>mcr.microsoft.com/java/jre:11-zulu-alpine</image>
148 | 					</from>
149 | 					<to>
150 | 						<image>{docker.image.prefix}/${project.artifactId}</image>
151 | 					</to>
152 | 				</configuration>
153 | 			</plugin>
154 | 		</plugins>
155 | 		</pluginManagement>
156 | 	</build>
157 | </project>
158 | 


--------------------------------------------------------------------------------
/CallRecording/src/main/java/com/communication/callrecording/ApiApplication.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callrecording;
 2 | 
 3 | import org.springframework.boot.SpringApplication;
 4 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 5 | 
 6 | @SpringBootApplication
 7 | public class ApiApplication 
 8 | {
 9 |     public static void main( String[] args )
10 |     {
11 |         SpringApplication.run(ApiApplication.class, args);
12 |     }
13 | }
14 | 


--------------------------------------------------------------------------------
/CallRecording/src/main/java/com/communication/callrecording/ConfigurationManager.java:
--------------------------------------------------------------------------------
 1 | package com.communication.callrecording;
 2 | 
 3 | import java.io.InputStream;
 4 | import java.io.InputStreamReader;
 5 | import java.io.Reader;
 6 | import java.util.Properties;
 7 | 
 8 | public class ConfigurationManager {
 9 |     private static ConfigurationManager configurationManager = null;
10 |     private final Properties appSettings = new Properties();
11 | 
12 |     private ConfigurationManager() {
13 |     }
14 | 
15 |     // static method to create instance of ConfigurationManager class
16 |     public static ConfigurationManager getInstance() {
17 |         if (configurationManager == null) {
18 |             configurationManager = new ConfigurationManager();
19 |             configurationManager.loadAppSettings();
20 |         }
21 |         return configurationManager;
22 |     }
23 | 
24 |     public void loadAppSettings() {
25 |         try {
26 |             ClassLoader classLoader = getClass().getClassLoader();
27 |             InputStream inputStream = classLoader.getResourceAsStream("config.properties");
28 |             assert inputStream != null;
29 |             Reader reader = new InputStreamReader(inputStream);
30 |             appSettings.load(reader);
31 |             reader.close();
32 |         } catch (Exception ex) {
33 |             System.out.print("\n Loading app settings failed with error - " + ex.getMessage());
34 |         }
35 |     }
36 | 
37 |     public String getAppSettings(String key) {
38 |         if (!key.isEmpty()) {
39 |             return appSettings.getProperty(key);
40 |         }
41 |         return "";
42 |     }
43 | }
44 | 


--------------------------------------------------------------------------------
/CallRecording/src/main/resources/config.properties:
--------------------------------------------------------------------------------
1 | Connectionstring=%Connectionstring%
2 | ACSAcquiredPhoneNumber=%ACSAcquiredPhoneNumber%
3 | BaseUri=%BaseUri%
4 | targetPhoneNumber=%targetPhoneNumber%


--------------------------------------------------------------------------------
/DirectRouting/README.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - Java
 5 | products:
 6 | - azure
 7 | - azure-communication-services
 8 | ---
 9 | 
10 | 
11 | # Direct Routing Configuration
12 | 
13 | For full instructions on how to build this code sample from scratch, look at [Quickstart: Direct Routing](https://docs.microsoft.com/azure/communication-services/quickstarts/telephony-sms/voice-routing-sdk-config?pivots=programming-language-java)
14 | 
15 | ## Prerequisites
16 | 
17 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
18 | - [Java Development Kit (JDK)](https://docs.microsoft.com/azure/developer/java/fundamentals/java-jdk-install) version 8 or above
19 | - [Apache Maven](https://maven.apache.org/download.cgi)
20 | - A deployed Communication Services resource and connection string. For details, see [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
21 | - Fully Qualified Domain Name (FQDN) and port number of a Session Border Controller (SBC) in operational telephony system.
22 | - [Verified domain name](https://learn.microsoft.com/en-us/azure/communication-services/how-tos/telephony/domain-validation) of the SBC FQDN.
23 | 
24 | ## Code Structure
25 | 
26 | - **./src/main/java/com/communication/quickstart/App.java:** contains code for managing phone numbers.
27 | - **pom.xml:** Project's Project Object Model, or [POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).
28 | 
29 | ## Before running sample code
30 | 
31 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you'd like to clone the sample to.
32 | 2. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
33 | 3.  With the Communication Services procured in pre-requisites, add connection string in the code at line no 13
34 |     ```String connectionString = "https://<RESOURCE_NAME>.communication.azure.com/;accesskey=<ACCESS_KEY>";```. 
35 | 4. Replace FQDNs of contoso.com domain with your FQDNs
36 | 
37 | 
38 | ## Run the code
39 | 
40 | 1. Navigate to the directory containing the pom.xml file and compile the project by using command `mvn clean compile`.
41 | 2. Then, build the package using command `mvn package`.
42 | 3. Run the command to execute the app `mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false`.
43 | 


--------------------------------------------------------------------------------
/DirectRouting/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project
 3 | 	xmlns="http://maven.apache.org/POM/4.0.0"
 4 | 	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 | 	<modelVersion>4.0.0</modelVersion>
 6 | 
 7 | 	<groupId>com.communication.quickstart</groupId>
 8 | 	<artifactId>communication-quickstart</artifactId>
 9 | 	<version>1.0-SNAPSHOT</version>
10 | 
11 | 	<name>communication-quickstart</name>
12 | 
13 | 	<properties>
14 | 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
15 | 		<maven.compiler.source>1.8</maven.compiler.source>
16 | 		<maven.compiler.target>1.8</maven.compiler.target>
17 | 	</properties>
18 | 
19 | 	<dependencies>
20 | 		<dependency>
21 | 			<groupId>com.azure</groupId>
22 | 			<artifactId>azure-communication-phonenumbers</artifactId>
23 | 			<version>1.1.0</version>
24 | 		</dependency>
25 | 	</dependencies>
26 | </project>


--------------------------------------------------------------------------------
/DirectRouting/src/main/java/com/communication/quickstart/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.quickstart;
 2 | 
 3 | import com.azure.communication.phonenumbers.siprouting.SipRoutingAsyncClient;
 4 | import com.azure.communication.phonenumbers.siprouting.SipRoutingClientBuilder;
 5 | import com.azure.communication.phonenumbers.siprouting.models.SipTrunk;
 6 | import com.azure.communication.phonenumbers.siprouting.models.SipTrunkRoute;
 7 | 
 8 | import java.util.List;
 9 | 
10 | import static java.util.Arrays.asList;
11 | import static java.util.Objects.requireNonNull;
12 | 
13 | public class App {
14 |     public static void main(String[] args) {
15 |         System.out.println("Azure Communication Services - Direct Routing Quickstart");
16 | 
17 |         String connectionString = "https://<RESOURCE_NAME>.communication.azure.com/;accesskey=<ACCESS_KEY>";
18 |         SipRoutingAsyncClient client = new SipRoutingClientBuilder()
19 |                 .connectionString(connectionString)
20 |                 .buildAsyncClient();
21 | 
22 |         listTrunksAndRoutes(client);
23 |         setTrunksAndRoutes(client);
24 |         listTrunksAndRoutes(client);
25 |         updateTrunk(client);
26 |         listTrunksAndRoutes(client);
27 | 
28 |         System.out.println("Finish");
29 |     }
30 | 
31 |     private static void listTrunksAndRoutes(SipRoutingAsyncClient client) {
32 |         System.out.println("---------------------");
33 |         System.out.println("Listing trunks");
34 |         try {
35 |             List<SipTrunk> trunks = requireNonNull(client.listTrunks().byPage().blockFirst()).getValue();
36 |             for (SipTrunk trunk : trunks) {
37 |                 System.out.printf(" %s:%d%n", trunk.getFqdn(), trunk.getSipSignalingPort());
38 |             }
39 |             if (trunks.isEmpty()) {
40 |                 System.out.println(" There are no SIP trunks.");
41 |             }
42 | 
43 |             System.out.println("Listing routes");
44 |             List<SipTrunkRoute> routes = requireNonNull(client.listRoutes().byPage().blockFirst()).getValue();
45 |             for (SipTrunkRoute route : routes) {
46 |                 System.out.printf(" %s: \"%s\" -> %s%n", route.getName(), route.getNumberPattern(), String.join(", ", route.getTrunks()));
47 |             }
48 |             if (routes.isEmpty()) {
49 |                 System.out.println(" There are no voice routes.");
50 |             }
51 |         } catch (Exception e) {
52 |             e.printStackTrace();
53 |             System.err.println("Listing failed");
54 |         }
55 |     }
56 | 
57 |     private static void setTrunksAndRoutes(SipRoutingAsyncClient client) {
58 |         System.out.println("---------------------");
59 |         System.out.println("Setting trunks");
60 |         try {
61 |             client.setTrunksWithResponse(asList(
62 |                     new SipTrunk("sbc.us.contoso.com", 1234),
63 |                     new SipTrunk("sbc.eu.contoso.com", 1234)
64 |             )).block();
65 | 
66 |             System.out.println("Setting routes");
67 |             client.setRoutes(asList(
68 |                     new SipTrunkRoute("UsRoute", "^\\+1(\\d{10})$")
69 |                             .setTrunks(asList("sbc.us.contoso.com")),
70 |                     new SipTrunkRoute("DefaultRoute", "^\\+\\d+$")
71 |                             .setTrunks(asList("sbc.us.contoso.com", "sbc.eu.contoso.com"))
72 |             )).block();
73 |         } catch (Exception e) {
74 |             e.printStackTrace();
75 |             System.err.println("Setting failed");
76 |         }
77 |     }
78 | 
79 |     private static void updateTrunk(SipRoutingAsyncClient client) {
80 |         System.out.println("---------------------");
81 |         System.out.println("Updating trunk");
82 |         try {
83 |             client.setTrunk(new SipTrunk("sbc.us.contoso.com", 9876)).block();
84 |         } catch (Exception e) {
85 |             e.printStackTrace();
86 |             System.err.println("Updating failed");
87 |         }
88 |     }
89 | }


--------------------------------------------------------------------------------
/LICENSE.md:
--------------------------------------------------------------------------------
 1 |     MIT License
 2 | 
 3 |     Copyright (c) Microsoft Corporation.
 4 | 
 5 |     Permission is hereby granted, free of charge, to any person obtaining a copy
 6 |     of this software and associated documentation files (the "Software"), to deal
 7 |     in the Software without restriction, including without limitation the rights
 8 |     to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 |     copies of the Software, and to permit persons to whom the Software is
10 |     furnished to do so, subject to the following conditions:
11 | 
12 |     The above copyright notice and this permission notice shall be included in all
13 |     copies or substantial portions of the Software.
14 | 
15 |     THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 |     IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 |     FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 |     AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 |     LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 |     OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 |     SOFTWARE


--------------------------------------------------------------------------------
/LookupNumber/README.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - Java
 5 | products:
 6 | - azure
 7 | - azure-communication-phonenumbers
 8 | - azure-identity
 9 | - azure-communication-common
10 | ---
11 | 
12 | # Look Up Phone Numbers
13 | 
14 | For full instructions on how to build this code sample from scratch, look at [Quickstart: Look Up Phone Numbers](https://learn.microsoft.com/en-us/azure/communication-services/quickstarts/telephony/number-lookup?pivots=programming-language-java)
15 | 
16 | ## Prerequisites
17 | 
18 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
19 | - [Java Development Kit (JDK)](https://docs.microsoft.com/azure/developer/java/fundamentals/java-jdk-install) version 8 or above
20 | - [Apache Maven](https://maven.apache.org/download.cgi)
21 | - An deployed Communication Services resource and connection string. For details, see [Create a Communication Services resource](https://learn.microsoft.com/en-us/azure/communication-services/quickstarts/create-communication-resource).
22 | 
23 | ## Code Structure
24 | 
25 | - **./LookupNumber/src/main/java/com/communication/lookup/quickstart/App.java:** contains code for looking up phone numbers.
26 | - **pom.xml:** Project's Project Object Model, or [POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).
27 | 
28 | ## Before running sample code
29 | 
30 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you'd like to clone the sample to.
31 | 2. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
32 | 3.  With the Communication Services procured in pre-requisites, add connection string as an environment variable named `COMMUNICATION_SERVICES_CONNECTION_STRING`
33 | 4.  Decide which lookup you would like to perform, and keep in mind that looking up all the operator details incurs a cost, while looking up only number formatting is free.
34 | 
35 | > [!WARNING]
36 | > If you want to avoid incurring a charge, comment out lines 36-48
37 | 
38 | ## Run the code
39 | 
40 | 1. Navigate to the directory containing the pom.xml file and compile the project by using command `mvn compile`.
41 | 2. Then, build the package using command `mvn package`.
42 | 3. Run the command to execute the app `mvn exec:java -D"exec.mainClass"="com.communication.lookup.quickstart.App" -D"exec.cleanupDaemonThreads"="false" -D"exec.args"="<target-phone-number>"`.  Replace `<target-phone-number>` with the number you want to use.
43 | 


--------------------------------------------------------------------------------
/LookupNumber/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | 
  3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5 |   <modelVersion>4.0.0</modelVersion>
  6 | 
  7 |   <groupId>com.communication.lookup.quickstart</groupId>
  8 |   <artifactId>communication-lookup-quickstart</artifactId>
  9 |   <version>1.0-SNAPSHOT</version>
 10 | 
 11 |   <name>communication-lookup-quickstart</name>
 12 |   <!-- FIXME change it to the project's website -->
 13 |   <url>http://www.example.com</url>
 14 | 
 15 |   <properties>
 16 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 17 |     <maven.compiler.source>1.8</maven.compiler.source>
 18 |     <maven.compiler.target>1.8</maven.compiler.target>
 19 |   </properties>
 20 | 
 21 |   <dependencies>
 22 |     <dependency>
 23 |       <groupId>junit</groupId>
 24 |       <artifactId>junit</artifactId>
 25 |       <version>4.11</version>
 26 |       <scope>test</scope>
 27 |     </dependency>
 28 | 
 29 |     <dependency>
 30 |       <groupId>com.azure</groupId>
 31 |       <artifactId>azure-communication-common</artifactId>
 32 |       <version>1.0.0</version>
 33 |     </dependency>
 34 | 
 35 |    <dependency>
 36 |       <groupId>com.azure</groupId>
 37 |       <artifactId>azure-communication-phonenumbers</artifactId>
 38 |       <version>1.2.0</version>
 39 |     </dependency>
 40 | 
 41 |     <dependency>
 42 |       <groupId>com.azure</groupId>
 43 |       <artifactId>azure-identity</artifactId>
 44 |       <version>1.2.3</version>
 45 |     </dependency>
 46 | 
 47 |     <dependency>
 48 |       <groupId>com.azure</groupId>
 49 |       <artifactId>azure-core</artifactId>
 50 |       <version>1.41.0</version>
 51 |     </dependency>
 52 |   </dependencies>
 53 | 
 54 |   <repositories>
 55 |     <repository>
 56 |       <id>azure-sdk-for-java</id>
 57 |       <url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
 58 |       <releases>
 59 |         <enabled>true</enabled>
 60 |       </releases>
 61 |       <snapshots>
 62 |         <enabled>true</enabled>
 63 |       </snapshots>
 64 |     </repository>
 65 |   </repositories>
 66 | 
 67 |   <distributionManagement>
 68 |     <repository>
 69 |       <id>azure-sdk-for-java</id>
 70 |       <url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
 71 |       <releases>
 72 |         <enabled>true</enabled>
 73 |       </releases>
 74 |       <snapshots>
 75 |         <enabled>true</enabled>
 76 |       </snapshots>
 77 |     </repository>
 78 |   </distributionManagement>
 79 | 
 80 |   <build>
 81 |     <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
 82 |       <plugins>
 83 |         <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
 84 |         <plugin>
 85 |           <artifactId>maven-clean-plugin</artifactId>
 86 |           <version>3.1.0</version>
 87 |         </plugin>
 88 |         <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
 89 |         <plugin>
 90 |           <artifactId>maven-resources-plugin</artifactId>
 91 |           <version>3.0.2</version>
 92 |         </plugin>
 93 |         <plugin>
 94 |           <artifactId>maven-compiler-plugin</artifactId>
 95 |           <version>3.8.0</version>
 96 |         </plugin>
 97 |         <plugin>
 98 |           <artifactId>maven-surefire-plugin</artifactId>
 99 |           <version>2.22.1</version>
100 |         </plugin>
101 |         <plugin>
102 |           <artifactId>maven-jar-plugin</artifactId>
103 |           <version>3.0.2</version>
104 |         </plugin>
105 |         <plugin>
106 |           <artifactId>maven-install-plugin</artifactId>
107 |           <version>2.5.2</version>
108 |         </plugin>
109 |         <plugin>
110 |           <artifactId>maven-deploy-plugin</artifactId>
111 |           <version>2.8.2</version>
112 |         </plugin>
113 |         <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
114 |         <plugin>
115 |           <artifactId>maven-site-plugin</artifactId>
116 |           <version>3.7.1</version>
117 |         </plugin>
118 |         <plugin>
119 |           <artifactId>maven-project-info-reports-plugin</artifactId>
120 |           <version>3.0.0</version>
121 |         </plugin>
122 |       </plugins>
123 |     </pluginManagement>
124 |   </build>
125 | </project>
126 | 


--------------------------------------------------------------------------------
/LookupNumber/src/main/java/com/communication/lookup/quickstart/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.lookup.quickstart;
 2 | 
 3 | import com.azure.communication.phonenumbers.*;
 4 | import com.azure.communication.phonenumbers.models.*;
 5 | import com.azure.core.http.rest.*;
 6 | import com.azure.core.util.Context;
 7 | import com.azure.identity.*;
 8 | import java.io.*;
 9 | import java.util.ArrayList;
10 | 
11 | public class App
12 | {
13 |     public static void main( String[] args ) throws IOException
14 |     {
15 |         System.out.println("Azure Communication Services - Number Lookup Quickstart");
16 |         
17 |         if (args == null || args.length == 0)
18 |         {
19 |             throw new IOException("missing phone number argument");
20 |         }
21 |         String phoneNumber = args[0];
22 | 
23 |         // This code retrieves your connection string from an environment variable
24 |         String connectionString = System.getenv("COMMUNICATION_SERVICES_CONNECTION_STRING");
25 | 
26 |         PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
27 |             .connectionString(connectionString)
28 |             .buildClient();
29 | 
30 |         ArrayList<String> phoneNumbers = new ArrayList<String>();
31 |         phoneNumbers.add(phoneNumber);
32 | 
33 |         // Use the free number lookup functionality to get number formatting information
34 |         OperatorInformationResult formattingResult = phoneNumberClient.searchOperatorInformation(phoneNumbers);
35 |         OperatorInformation formattingInfo = formattingResult.getValues().get(0);
36 |         System.out.println(formattingInfo.getPhoneNumber() + " is formatted " 
37 |             + formattingInfo.getInternationalFormat() +  " internationally, and "
38 |             + formattingInfo.getNationalFormat() + " nationally");
39 | 
40 |         // Use the paid number lookup functionality to get operator specific details
41 |         // IMPORTANT NOTE: Invoking the method below will incur a charge to your account
42 |         OperatorInformationOptions options = new OperatorInformationOptions();
43 |         options.setIncludeAdditionalOperatorDetails(true);
44 |         Response<OperatorInformationResult> result = phoneNumberClient.searchOperatorInformationWithResponse(phoneNumbers, options, Context.NONE);
45 |         OperatorInformation operatorInfo = result.getValue().getValues().get(0);
46 | 
47 |         String numberType = operatorInfo.getNumberType() == null ? "unknown" : operatorInfo.getNumberType().toString();
48 |         String operatorName = "an unknown operator";
49 |         if (operatorInfo.getOperatorDetails()!= null && operatorInfo.getOperatorDetails().getName() != null)
50 |         {
51 |             operatorName = operatorInfo.getOperatorDetails().getName();
52 |         }
53 |         System.out.println(operatorInfo.getPhoneNumber() + " is a " + numberType + " number, operated in "
54 |             + operatorInfo.getIsoCountryCode() + " by " + operatorName);
55 |     }
56 | }
57 | 


--------------------------------------------------------------------------------
/ManageTeamsIdentityMobileAndDesktop/README.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - Java
 5 | products:
 6 | - azure
 7 | - azure-communication-services
 8 | ---
 9 | 
10 | 
11 | # Create and manage Communication access tokens for Teams users in mobile and desktop applications
12 | 
13 | This code sample walks you through the process of acquiring a Communication Token Credential by exchanging an Azure AD token of a user with a Teams license for a valid Communication access token.
14 | 
15 | This sample application utilizes the [MSAL Java](https://github.com/AzureAD/microsoft-authentication-library-for-java) library for authentication against the Azure AD and acquisition of a token with delegated permissions. The token exchange itself is facilitated by the `azure-communication-identity` package.
16 | 
17 | To be able to use the token for Calling, use it to initialize the `CommunicationTokenCredential` from the `azure-communication-common` library.
18 | 
19 | ## Prerequisites
20 | 
21 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
22 | - Java Development Kit (JDK) version 8 or above.
23 | - An active Communication Services resource and connection string. [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource/).
24 | - Azure Active Directory tenant with users that have a Teams license.
25 | 
26 | ## Before running sample code
27 | 
28 | 1. Complete the [Administrator actions](https://docs.microsoft.com/azure/communication-services/quickstarts/manage-teams-identity?pivots=programming-language-javascript#administrator-actions) from the [Manage access tokens for Teams users quickstart](https://docs.microsoft.com/azure/communication-services/quickstarts/manage-teams-identity).
29 |     - Take a note of Fabrikam's Azure AD Tenant ID and Contoso's Azure AD App Client ID. You'll need the values in the following steps.
30 | 1. On the Authentication pane of your Azure AD App, add a new platform of the mobile and desktop application type with the Redirect URI of `http://localhost`.
31 | 1. Open an instance of Windows Terminal, PowerShell, or an equivalent command line and navigate to the directory that you'd like to clone the sample to.
32 | 1. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
33 | 1. Navigate to the `ManageTeamsIdentityMobileAndDesktop` directory.
34 | 1. With the Communication Services procured in pre-requisites, add connection string, an Azure AD client ID and tenant ID in the App.java file.
35 | 
36 | ## Run the code
37 | 
38 | From a console prompt, navigate to the directory containing the `pom.xml` file, then execute the following node commands to run the app:
39 | 
40 | 1. Compile the project by using command `mvn compile`
41 | 2. Then, build the package using command `mvn package`
42 | 3. Run the command to execute the app `mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false`. If you are using Powershell CLI try to execute as follow `mvn exec:java -D exec.mainClass="com.communication.quickstart.App" -D exec.cleanupDaemonThreads=false`.
43 | 
44 | You should be presented with a browser window and navigated to the Azure AD login form. If the authentication is successful, the application receives an Azure AD access token and exchanges it for a Communication access token.


--------------------------------------------------------------------------------
/ManageTeamsIdentityMobileAndDesktop/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <project xmlns="http://maven.apache.org/POM/4.0.0"
 3 |          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |     <modelVersion>4.0.0</modelVersion>
 6 | 
 7 |     <groupId>com.communication.quickstart</groupId>
 8 |     <artifactId>communication-quickstart</artifactId>
 9 |     <version>1.0-SNAPSHOT</version>
10 | 
11 |     <name>communication-quickstart</name>
12 | 
13 |     <properties>
14 |         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
15 |         <maven.compiler.source>1.8</maven.compiler.source>
16 |         <maven.compiler.target>1.8</maven.compiler.target>
17 |     </properties>
18 | 
19 |     <dependencies>
20 |         <dependency>
21 |             <groupId>com.azure</groupId>
22 |             <artifactId>azure-communication-identity</artifactId>
23 |             <version>1.3.0</version>
24 |         </dependency>
25 |         <dependency>
26 |             <groupId>com.microsoft.azure</groupId>
27 |             <artifactId>msal4j</artifactId>
28 |             <version>1.11.0</version>
29 |         </dependency>
30 |         <dependency>
31 |             <groupId>com.fasterxml.jackson.core</groupId>
32 |             <artifactId>jackson-databind</artifactId>
33 |             <version>2.13.3</version>
34 |         </dependency>
35 |     </dependencies>
36 | 
37 |     <build>
38 |         <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
39 |             <plugins>
40 |                 <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
41 |                 <plugin>
42 |                     <artifactId>maven-clean-plugin</artifactId>
43 |                     <version>3.1.0</version>
44 |                 </plugin>
45 |                 <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
46 |                 <plugin>
47 |                     <artifactId>maven-resources-plugin</artifactId>
48 |                     <version>3.0.2</version>
49 |                 </plugin>
50 |                 <plugin>
51 |                     <artifactId>maven-compiler-plugin</artifactId>
52 |                     <version>3.8.0</version>
53 |                 </plugin>
54 |                 <plugin>
55 |                     <artifactId>maven-surefire-plugin</artifactId>
56 |                     <version>2.22.1</version>
57 |                 </plugin>
58 |                 <plugin>
59 |                     <artifactId>maven-jar-plugin</artifactId>
60 |                     <version>3.0.2</version>
61 |                 </plugin>
62 |                 <plugin>
63 |                     <artifactId>maven-install-plugin</artifactId>
64 |                     <version>2.5.2</version>
65 |                 </plugin>
66 |                 <plugin>
67 |                     <artifactId>maven-deploy-plugin</artifactId>
68 |                     <version>2.8.2</version>
69 |                 </plugin>
70 |                 <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
71 |                 <plugin>
72 |                     <artifactId>maven-site-plugin</artifactId>
73 |                     <version>3.7.1</version>
74 |                 </plugin>
75 |                 <plugin>
76 |                     <artifactId>maven-project-info-reports-plugin</artifactId>
77 |                     <version>3.0.0</version>
78 |                 </plugin>
79 |             </plugins>
80 |         </pluginManagement>
81 |     </build>
82 | 
83 | </project>


--------------------------------------------------------------------------------
/ManageTeamsIdentityMobileAndDesktop/src/main/java/com/communication/quickstart/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.quickstart;
 2 | 
 3 | import com.azure.communication.identity.CommunicationIdentityClient;
 4 | import com.azure.communication.identity.CommunicationIdentityClientBuilder;
 5 | import com.azure.communication.identity.models.GetTokenForTeamsUserOptions;
 6 | import com.azure.core.credential.AccessToken;
 7 | import com.microsoft.aad.msal4j.IAuthenticationResult;
 8 | import com.microsoft.aad.msal4j.InteractiveRequestParameters;
 9 | import com.microsoft.aad.msal4j.PublicClientApplication;
10 | 
11 | import java.net.URI;
12 | import java.util.HashSet;
13 | import java.util.Set;
14 | 
15 | public class App {
16 | 
17 |     public static void main( String[] args ) throws Exception {
18 |         System.out.println("Azure Communication Services - Communication access token Quickstart");
19 |         // Quickstart code goes here
20 | 
21 |         // You need to provide your Azure AD client ID and tenant ID
22 |         String appId = "<contoso_application_id>";
23 |         String tenantId = "<contoso_tenant_id>";
24 |         String authority = "https://login.microsoftonline.com/" + tenantId;
25 | 
26 |         // Create an instance of PublicClientApplication
27 |         PublicClientApplication pca = PublicClientApplication.builder(appId)
28 |                 .authority(authority)
29 |                 .build();
30 | 
31 |         String redirectUri = "http://localhost";
32 |         Set<String> scope = new HashSet<String>();
33 |         scope.add("https://auth.msft.communication.azure.com/Teams.ManageCalls");
34 |         scope.add("https://auth.msft.communication.azure.com/Teams.ManageChats");
35 | 
36 |         // Create an instance of InteractiveRequestParameters for acquiring the AAD token and object ID of a Teams user
37 |         InteractiveRequestParameters parameters = InteractiveRequestParameters
38 |                 .builder(new URI(redirectUri))
39 |                 .scopes(scope)
40 |                 .build();
41 | 
42 |         // Retrieve the AAD token and object ID of a Teams user
43 |         IAuthenticationResult result = pca.acquireToken(parameters).get();
44 |         String teamsUserAadToken = result.accessToken();
45 |         String[] accountIds = result.account().homeAccountId().split("\\.");
46 |         String userObjectId = accountIds[0];
47 |         System.out.println("Teams token: " + teamsUserAadToken);
48 | 
49 |         // You can find your connection string from your resource in the Azure portal
50 |         String connectionString = "<connection_string>";
51 | 
52 |         // Instantiate the identity client
53 |         CommunicationIdentityClient communicationIdentityClient = new CommunicationIdentityClientBuilder()
54 |                 .connectionString(connectionString)
55 |                 .buildClient();
56 | 
57 |         // Exchange the Azure AD access token of the Teams User for a Communication Identity access token
58 |         GetTokenForTeamsUserOptions options = new GetTokenForTeamsUserOptions(teamsUserAadToken, appId, userObjectId);
59 |         AccessToken accessToken = communicationIdentityClient.getTokenForTeamsUser(options);
60 |         System.out.println("Token: " + accessToken.getToken());
61 |     }
62 | }
63 | 


--------------------------------------------------------------------------------
/OutboundCallReminder/readme.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - java
 5 | products:
 6 | - azure
 7 | - azure-communication-services
 8 | ---
 9 | 
10 | # Outbound Reminder Call Sample
11 | 
12 | This sample application shows how the Azure Communication Services Server Calling SDK can be used to build IVR related solutions. This sample makes an outbound call to a phone number or a communication identifier and plays an audio message. If the callee presses 1 (tone1), to reschedule an appointment, then the application invites a new participant and then leaves the call. If the callee presses any other key then the application ends the call. This sample application is also capable of making multiple concurrent outbound calls.
13 | The application is a console based application build on Java development kit(JDK) 11.
14 | 
15 | ## Getting started
16 | 
17 | ### Prerequisites
18 | 
19 | - Create an Azure account with an active subscription. For details, see [Create an account for free](https://azure.microsoft.com/free/)
20 | - [Java Development Kit (JDK) version 11 or above](https://docs.microsoft.com/azure/developer/java/fundamentals/java-jdk-install)
21 | - [Apache Maven](https://maven.apache.org/download.cgi)
22 | - Create an Azure Communication Services resource. For details, see [Create an Azure Communication Resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource). You'll need to record your resource **connection string** for this sample.
23 | - Get a phone number for your new Azure Communication Services resource. For details, see [Get a phone number](https://docs.microsoft.com/azure/communication-services/quickstarts/telephony-sms/get-phone-number?pivots=platform-azp)
24 | - Download and install [Ngrok](https://www.ngrok.com/download). As the sample is run locally, Ngrok will enable the receiving of all the events.
25 | - (Optional) Create Azure Speech resource for generating custom message to be played by application. Follow [here](https://docs.microsoft.com/azure/cognitive-services/speech-service/overview#try-the-speech-service-for-free) to create the resource.
26 | 
27 | > Note: the samples make use of the Microsoft Cognitive Services Speech SDK. By downloading the Microsoft Cognitive Services Speech SDK, you acknowledge its license, see [Speech SDK license agreement](https://aka.ms/csspeech/license201809).
28 | 
29 | ### Configuring application
30 | 
31 | - Open the config.properities file to configure the following settings
32 | 
33 | 	- Connection String: Azure Communication Service resource's connection string.
34 | 	- Source Phone: Phone number associated with the Azure Communication Service resource.
35 | 	- DestinationIdentities: Multiple sets of outbound target and Transfer target. These sets are seperated by a semi-colon, and outbound target and Transfer target in a each set are seperated by a coma.
36 | 
37 |     	Format: "OutboundTarget1(PhoneNumber),TransferTarget1(PhoneNumber/MRI);OutboundTarget2(PhoneNumber),TransferTarget2(PhoneNumber/MRI);OutboundTarget3(PhoneNumber),TransferTarget3(PhoneNumber/MRI)".
38 | 
39 | 	  	For e.g. "+1425XXXAAAA,8:acs:ab12b0ea-85ea-4f83-b0b6-84d90209c7c4_00000009-bce0-da09-54b7-xxxxxxxxxxxx;+1425XXXBBBB,+1425XXXCCCC"
40 | 
41 | 	- NgrokExePath: Folder path where ngrok.exe is insalled/saved.
42 | 	- SecretPlaceholder: Secret/Password that would be part of callback and will be use to validate incoming requests.
43 | 	- CognitiveServiceKey: (Optional) Cognitive service key used for generating custom message
44 | 	- CognitiveServiceRegion: (Optional) Region associated with cognitive service
45 | 	- CustomMessage: (Optional) Text for the custom message to be converted to speech.
46 | 
47 | ### Run the Application
48 | 
49 | - Navigate to the directory containing the pom.xml file and use the following mvn commands:
50 | 	- Compile the application: mvn compile
51 | 	- Build the package: mvn package
52 | 	- Execute the app: mvn exec:java
53 | 


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/CallConfiguration.java:
--------------------------------------------------------------------------------
 1 | package com.communication.outboundcallreminder;
 2 | 
 3 | import com.communication.outboundcallreminder.EventHandler.EventAuthHandler;
 4 | 
 5 | public class CallConfiguration {
 6 |     public String connectionString;
 7 |     public String sourceIdentity;
 8 |     public String sourcePhoneNumber;
 9 |     public String appBaseUrl;
10 |     public String audioFileName;
11 |     public String appCallbackUrl;
12 |     public String audioFileUrl;
13 |     public int maxRetryAttemptCount;
14 | 
15 |     public CallConfiguration(String connectionString, String sourceIdentity, String sourcePhoneNumber,
16 |             String appBaseUrl, String audioFileName, String maxRetryAttemptCount) {
17 |         this.connectionString = connectionString;
18 |         this.sourceIdentity = sourceIdentity;
19 |         this.sourcePhoneNumber = sourcePhoneNumber;
20 |         this.appBaseUrl = appBaseUrl;
21 |         this.audioFileName = audioFileName;
22 |         EventAuthHandler eventhandler = EventAuthHandler.getInstance();
23 |         this.appCallbackUrl = appBaseUrl + "/api/outboundcall/callback?" + eventhandler.getSecretQuerystring();
24 |         audioFileUrl = appBaseUrl + "/audio/" + audioFileName;
25 |         this.maxRetryAttemptCount = Integer.parseInt(maxRetryAttemptCount);
26 |     }
27 | 
28 | }


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/CommunicationIdentifierKind.java:
--------------------------------------------------------------------------------
1 | package com.communication.outboundcallreminder;
2 | 
3 | public enum CommunicationIdentifierKind {
4 |     UserIdentity, PhoneIdentity, UnknownIdentity
5 | }
6 | 


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/ConfigurationManager.java:
--------------------------------------------------------------------------------
 1 | package com.communication.outboundcallreminder;
 2 | 
 3 | import java.io.File;
 4 | import java.io.FileNotFoundException;
 5 | import java.io.FileReader;
 6 | import java.io.IOException;
 7 | import java.util.Properties;
 8 | 
 9 | public class ConfigurationManager {
10 |     private static ConfigurationManager configurationManager = null;
11 |     private final Properties appSettings = new Properties();
12 | 
13 |     private ConfigurationManager() {
14 |     }
15 | 
16 |     // static method to create instance of ConfigurationManager class
17 |     public static ConfigurationManager getInstance() {
18 |         if (configurationManager == null) {
19 |             configurationManager = new ConfigurationManager();
20 |         }
21 |         return configurationManager;
22 |     }
23 | 
24 |     public void loadAppSettings() {
25 |         try {
26 |             File configFile = new File("src/main/java/com/communication/outboundcallreminder/config.properties");
27 |             FileReader reader = new FileReader(configFile);
28 |             appSettings.load(reader);
29 |             reader.close();
30 |         } catch (FileNotFoundException ex) {
31 |             Logger.logMessage(Logger.MessageType.INFORMATION,"Loading app settings failed with error -- > " + ex.getMessage());
32 |         } catch (IOException ex) {
33 |             Logger.logMessage(Logger.MessageType.ERROR,"Loading app settings failed with error -- > " + ex.getMessage());
34 |         }
35 |     }
36 | 
37 |     public String getAppSettings(String key) {
38 |         if (!key.isEmpty()) {
39 |             return appSettings.getProperty(key);
40 |         }
41 |         return "";
42 |     }
43 | }


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/Controllers/OutboundCallController.java:
--------------------------------------------------------------------------------
 1 | package com.communication.outboundcallreminder.Controllers;
 2 | 
 3 | import org.springframework.core.io.InputStreamResource;
 4 | import org.springframework.http.ResponseEntity;
 5 | import org.springframework.http.HttpHeaders;
 6 | import org.springframework.http.MediaType;
 7 | import java.io.File;
 8 | import java.io.FileInputStream;
 9 | import com.communication.outboundcallreminder.Logger;
10 | import com.communication.outboundcallreminder.EventHandler.EventAuthHandler;
11 | import com.communication.outboundcallreminder.EventHandler.EventDispatcher;
12 | import org.springframework.web.bind.annotation.PathVariable;
13 | import org.springframework.web.bind.annotation.RequestBody;
14 | import org.springframework.web.bind.annotation.RequestMapping;
15 | import org.springframework.web.bind.annotation.RequestParam;
16 | import org.springframework.web.bind.annotation.RestController;
17 | 
18 | @RestController
19 | public class OutboundCallController {
20 | 
21 | 	@RequestMapping("/api/outboundcall/callback")
22 | 	public static String onIncomingRequestAsync(@RequestBody(required = false) String data,
23 | 			@RequestParam(value = "secret", required = false) String secretKey) {
24 | 		EventAuthHandler eventhandler = EventAuthHandler.getInstance();
25 | 
26 | 		/// Validating the incoming request by using secret set in app.settings
27 | 		if (eventhandler.authorize(secretKey)) {
28 | 			(EventDispatcher.getInstance()).processNotification(data);
29 | 		} else {
30 | 			Logger.logMessage(Logger.MessageType.ERROR, "Unauthorized Request");
31 | 		}
32 | 
33 | 		return "OK";
34 | 	}
35 | 
36 | 	@RequestMapping("/audio/{fileName}")
37 | 	public ResponseEntity<Object> loadFile(@PathVariable(value = "fileName", required = false) String fileName) {
38 | 		String filePath = "src/main/java/com/communication/outboundcallreminder/audio/" + fileName;
39 | 		File file = new File(filePath);
40 | 		InputStreamResource resource = null;
41 | 
42 | 		try {
43 | 			resource = new InputStreamResource(new FileInputStream(file));
44 | 		} catch (Exception ex) {
45 | 			System.out.println(ex.getMessage());
46 | 		}
47 | 
48 | 		HttpHeaders headers = new HttpHeaders();
49 | 		headers.add("Cache-Control", "no-cache, no-store, must-revalidate");
50 | 		headers.add("Pragma", "no-cache");
51 | 
52 | 		return ResponseEntity.ok().headers(headers).contentLength(file.length())
53 | 				.contentType(MediaType.parseMediaType("audio/x-wav")).body(resource);
54 | 	}
55 | }
56 | 


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/EventHandler/EventAuthHandler.java:
--------------------------------------------------------------------------------
 1 | package com.communication.outboundcallreminder.EventHandler;
 2 | 
 3 | import com.communication.outboundcallreminder.ConfigurationManager;
 4 | 
 5 | public class EventAuthHandler {
 6 |     private String secretValue;
 7 |     public static EventAuthHandler eventAuthHandler = null;
 8 | 
 9 |     public EventAuthHandler() {
10 |         ConfigurationManager configuration = ConfigurationManager.getInstance();
11 |         secretValue = configuration.getAppSettings("SecretPlaceholder");
12 | 
13 |         if (secretValue == null) {
14 |             System.out.println("SecretPlaceholder is null");
15 |             secretValue = "h3llowW0rld";
16 |         }
17 |     }
18 | 
19 |     public static EventAuthHandler getInstance() {
20 |         if (eventAuthHandler == null) {
21 |             eventAuthHandler = new EventAuthHandler();
22 |         }
23 |         return eventAuthHandler;
24 |     }
25 | 
26 |     public Boolean authorize(String requestSecretValue) {
27 |         return requestSecretValue != null && requestSecretValue.equals(secretValue);
28 |     }
29 | 
30 |     public String getSecretQuerystring() {
31 |         String secretKey = "secret";
32 |         return (secretKey + "=" + secretValue);
33 |     }
34 | }


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/EventHandler/NotificationCallback.java:
--------------------------------------------------------------------------------
1 | package com.communication.outboundcallreminder.EventHandler;
2 | 
3 | import com.azure.communication.callingserver.models.events.CallingServerEventBase;
4 | 
5 | public interface NotificationCallback {
6 |     void callback(CallingServerEventBase callEvent);
7 | }


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/Logger.java:
--------------------------------------------------------------------------------
 1 | package com.communication.outboundcallreminder;
 2 | 
 3 | public class Logger {
 4 |     //Caution: Logging should be removed/disabled if you want to use this sample in production to avoid exposing sensitive information
 5 |     public enum MessageType
 6 |     {
 7 |         INFORMATION,
 8 |         ERROR
 9 |     }
10 | 
11 |     /// <summary>
12 |     /// Log message to console
13 |     /// </summary>
14 |     /// <param name="messageType">Type of the message: Information or Error</param>
15 |     /// <param name="message">Message string</param>
16 |     public static void logMessage(MessageType messageType, String message)
17 |     {
18 |         String logMessage;
19 |         logMessage = messageType + " " + message;
20 |        System.out.println(logMessage);
21 |     }
22 | }
23 | 


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/Ngrok/NgrokConnector.java:
--------------------------------------------------------------------------------
 1 | package com.communication.outboundcallreminder.Ngrok;
 2 | 
 3 | import net.minidev.json.JSONArray;
 4 | import net.minidev.json.JSONObject;
 5 | import net.minidev.json.parser.JSONParser;
 6 | import org.apache.http.HttpEntity;
 7 | import org.apache.http.HttpHeaders;
 8 | import org.apache.http.client.methods.CloseableHttpResponse;
 9 | import org.apache.http.client.methods.HttpGet;
10 | import org.apache.http.impl.client.CloseableHttpClient;
11 | import org.apache.http.util.EntityUtils;
12 | import org.apache.http.impl.client.HttpClients;
13 | import com.communication.outboundcallreminder.Logger;
14 | 
15 | public class NgrokConnector {
16 | 
17 |     /// The HTTP client.
18 |     private final CloseableHttpClient httpClient;
19 |     private final HttpGet request;
20 | 
21 |     NgrokConnector() {
22 |         httpClient = HttpClients.createDefault();
23 |         String ngrokTunnelUrl = "http://127.0.0.1:4040/api/tunnels";
24 |         request = new HttpGet(ngrokTunnelUrl);
25 |         // add request headers
26 |         request.addHeader(HttpHeaders.CONTENT_TYPE, "application/json");
27 |     }
28 | 
29 |     public JSONArray getAllTunnelsAsync() {
30 |         JSONArray tunnelList = null;
31 |         try {
32 |             CloseableHttpResponse response = httpClient.execute(request);
33 |             HttpEntity entity = response.getEntity();
34 | 
35 |             if (entity != null) {
36 |                 String tunnel = EntityUtils.toString(entity);
37 |                 JSONObject tunnelObject = (JSONObject) (new JSONParser(JSONParser.DEFAULT_PERMISSIVE_MODE).parse(tunnel));
38 |                 tunnelList = (JSONArray) tunnelObject.get("tunnels");
39 |             }
40 |         } catch (Exception ex) {
41 |             Logger.logMessage(Logger.MessageType.ERROR, "Failed to get Ngrok URL -- > " + ex.getMessage());
42 |         }
43 |         return tunnelList;
44 |     }
45 | }


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/Ngrok/NgrokService.java:
--------------------------------------------------------------------------------
  1 | package com.communication.outboundcallreminder.Ngrok;
  2 | 
  3 | import net.minidev.json.JSONArray;
  4 | import com.communication.outboundcallreminder.Logger;
  5 | 
  6 | import java.io.BufferedReader;
  7 | import java.io.InputStreamReader;
  8 | import java.util.Map;
  9 | 
 10 | public class NgrokService {
 11 |     /// The NGROK process
 12 |     private Process ngrokProcess;
 13 |     // NgrokConnector connector;
 14 |     private final NgrokConnector connector;
 15 | 
 16 |     public NgrokService(String ngrokPath, String authToken) {
 17 |         connector = new NgrokConnector();
 18 |         this.ensureNgrokNotRunning();
 19 |         this.createNgrokProcess(ngrokPath, authToken);
 20 |     }
 21 | 
 22 |     /// <summary>
 23 |     /// Ensures that NGROK is not running.
 24 |     /// </summary>
 25 |     private void ensureNgrokNotRunning() {
 26 |         BufferedReader input;
 27 |         String ngrokProcess = "ngrok.exe";
 28 |         String processFilter = "/nh /fi \"Imagename eq " + ngrokProcess + "\"";
 29 |         String tasksCmd = System.getenv("windir") + "/system32/tasklist.exe " + processFilter;
 30 |         try {
 31 |             Process process = Runtime.getRuntime().exec(tasksCmd);
 32 |             input = new BufferedReader(new InputStreamReader(process.getInputStream()));
 33 | 
 34 |             String line;
 35 |             while ((line = input.readLine()) != null) {
 36 |                 // It means ngrok.exe running
 37 |                 if (line.contains(ngrokProcess)) {
 38 |                     Logger.logMessage(Logger.MessageType.INFORMATION, "Looks like NGROK is still running. Please kill it before running the provider again.");
 39 |                     System.exit(0);
 40 |                 }
 41 |             }
 42 |             process.destroy();
 43 |             input.close();
 44 |         } catch (Exception ex) {
 45 |             Logger.logMessage(Logger.MessageType.ERROR ,"Not able to find the process -- > " + ex.getMessage());
 46 |         }
 47 |     }
 48 | 
 49 |     /// <summary>
 50 |     /// Kill ngrok.exe process
 51 |     /// </summary>
 52 |     public void dispose() {
 53 |         if (this.ngrokProcess != null) {
 54 |             this.ngrokProcess.destroy();
 55 |         }
 56 |     }
 57 | 
 58 |     /// <summary>
 59 |     /// Creates the NGROK process.
 60 |     /// </summary>
 61 |     private void createNgrokProcess(String ngrokPath, String authToken) {
 62 |         try {
 63 |             String authTokenArgs = "";
 64 |             if (authToken != null && !authToken.isEmpty()) {
 65 |                 authTokenArgs = " --authtoken " + authToken;
 66 |             }
 67 | 
 68 |             String openCmd = "cmd /c start cmd.exe /k ";
 69 |             String fileName = ngrokPath + "ngrok.exe";
 70 |             String arguments = " http http://localhost:9007/ -host-header=/localhost:9007/" + authTokenArgs;
 71 |             String command = openCmd + fileName + arguments;
 72 | 
 73 |             this.ngrokProcess = Runtime.getRuntime().exec(command);
 74 |         } catch (Exception ex) {
 75 |             Logger.logMessage(Logger.MessageType.ERROR,"Failed to start Ngrok.exe -- > " + ex.getMessage());
 76 |         }
 77 |     }
 78 | 
 79 |     /// <summary>
 80 |     /// Get Ngrok URL
 81 |     /// </summary>
 82 |     public String getNgrokUrl() {
 83 |         String ngrokUrl = null;
 84 |         int totalAttempts = 3;
 85 |         try {
 86 |             do {
 87 |                 // Wait for fetching the ngrok url as ngrok process might not be started yet.
 88 |                 Thread.sleep(2000);
 89 |                 JSONArray tunnelList = this.connector.getAllTunnelsAsync();
 90 | 
 91 |                 if (tunnelList.iterator().hasNext()) {
 92 |                     Map<?, ?> tunnel = (Map<?, ?>) tunnelList.iterator().next();
 93 | 
 94 |                     for (Map.Entry<?, ?> entry : tunnel.entrySet()) {
 95 |                         if ((entry.getKey()).equals("public_url")) {
 96 |                             ngrokUrl = (String) entry.getValue();
 97 |                             return ngrokUrl;
 98 |                         }
 99 |                     }
100 |                 }
101 |             } while (--totalAttempts > 0);
102 |         } catch (Exception ex) {
103 |             Logger.logMessage(Logger.MessageType.ERROR, "Failed to get Ngrok url -- > " + ex.getMessage());
104 |         }
105 |         return ngrokUrl;
106 |     }
107 | }


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/audio/custom-message.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/audio/custom-message.wav


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/audio/sample-message.wav:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/audio/sample-message.wav


--------------------------------------------------------------------------------
/OutboundCallReminder/src/main/java/com/communication/outboundcallreminder/config.properties:
--------------------------------------------------------------------------------
 1 | # app settings
 2 | 
 3 | #1. Configurations related to Communication Service resource
 4 | 
 5 | # Connection string of Azure Communication Service Resource.
 6 | Connectionstring=%Connectionstring%
 7 | 
 8 | # Phone number provisioned for the ACS resource (in E.164 Format, e.g. +1425XXXYYYY). This is an alternative phone id
 9 | SourcePhone=%SourcePhone%
10 | 
11 | # Destination identities to call. 
12 | # Format: "Outbound Target1(PhoneNumber), Transfer Target1(PhoneNumber/MRI);Outbound Target2(PhoneNumber), Transfer Target2(PhoneNumber/MRI);Outbound Target3(PhoneNumber), Transfer Target3(PhoneNumber/MRI)"
13 | # For e.g. "+1425XXXAAAA,8:acs:ab12b0ea-85ea-4f83-b0b6-84d90209c7c4_00000009-bce0-da09-54b7-xxxxxxxxxxxx;+1425XXXBBBB,+1425XXXCCCC"
14 | DestinationIdentities=%DestinationIdentities%
15 | 
16 | MaxRetryCount=2
17 | 
18 | # 2. Configurations related to environment
19 | 
20 | # Directory where ngrok.exe is saved.
21 | NgrokExePath=%NgrokExeDirectoryPath%
22 | # Secret for validating incoming request.
23 | SecretPlaceholder=h3llowW0rld
24 | 
25 | # Cognitive service key (Optional).
26 | CognitiveServiceKey=
27 | # Cognitive service region (Optional).
28 | CognitiveServiceRegion=
29 | # Custom message that will be translated by Azure Cognitive service (Optional).
30 | CustomMessage=Hello, this is a reminder call. If you would like to speak with a representative Press 1 or 2 if you want to hang up.
31 | 


--------------------------------------------------------------------------------
/PhoneNumbers/README.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - Java
 5 | products:
 6 | - azure
 7 | - azure-communication-phonenumbers
 8 | - azure-identity
 9 | - azure-communication-common
10 | ---
11 | 
12 | 
13 | # Manage Phone Numbers
14 | 
15 | For full instructions on how to build this code sample from scratch, look at [Quickstart: Manage Phone Numbers](https://docs.microsoft.com/azure/communication-services/quickstarts/telephony-sms/get-phone-number?pivots=programming-language-java)
16 | 
17 | ## Prerequisites
18 | 
19 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
20 | - [Java Development Kit (JDK)](https://docs.microsoft.com/azure/developer/java/fundamentals/java-jdk-install) version 8 or above
21 | - [Apache Maven](https://maven.apache.org/download.cgi)
22 | - An deployed Communication Services resource and connection string. For details, see [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
23 | 
24 | ## Code Structure
25 | 
26 | - **./PhoneNumbers/src/main/java/com/communication/quickstart/App.java:** contains code for managing phone numbers.
27 | - **pom.xml:** Project's Project Object Model, or [POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).
28 | 
29 | ## Before running sample code
30 | 
31 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you'd like to clone the sample to.
32 | 2. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
33 | 3.  With the Communication Services procured in pre-requisites, add connection string in the code at line no 26
34 |     ```String connectionString = "https://<RESOURCE_NAME>.communication.azure.com/;accesskey=<ACCESS_KEY>";```.
35 | 4.  With a purchased number, you can update the capabilities, pass the purchased number in the code at line no 68.
36 | 5.  You can release a purchased phone number, pass the purchased number in the code at line no 76.    
37 | 
38 | 
39 | ## Run the code
40 | 
41 | 1. Navigate to the directory containing the pom.xml file and compile the project by using command `mvn compile`.
42 | 2. Then, build the package using command `mvn package`.
43 | 3. Run the command to execute the app `mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false`.
44 | 


--------------------------------------------------------------------------------
/PhoneNumbers/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | 
 3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |   <modelVersion>4.0.0</modelVersion>
 6 | 
 7 |   <groupId>com.communication.quickstart</groupId>
 8 |   <artifactId>communication-quickstart</artifactId>
 9 |   <version>1.0-SNAPSHOT</version>
10 | 
11 |   <name>communication-quickstart</name>
12 |   <!-- FIXME change it to the project's website -->
13 |   <url>http://www.example.com</url>
14 | 
15 |   <properties>
16 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
17 |     <maven.compiler.source>1.7</maven.compiler.source>
18 |     <maven.compiler.target>1.7</maven.compiler.target>
19 |   </properties>
20 | 
21 |   <dependencies>
22 |     <dependency>
23 |       <groupId>junit</groupId>
24 |       <artifactId>junit</artifactId>
25 |       <version>4.11</version>
26 |       <scope>test</scope>
27 |     </dependency>
28 | 	<dependency>
29 | 		<groupId>com.azure</groupId>
30 | 		<artifactId>azure-communication-phonenumbers</artifactId>
31 | 		<version>1.0.3</version>
32 | 	</dependency>
33 | 	<dependency>
34 | 		<groupId>com.azure</groupId>
35 | 		<artifactId>azure-communication-common</artifactId>
36 | 		<version>1.0.3</version>
37 | 	</dependency>
38 | 	<dependency>
39 | 		<groupId>com.azure</groupId>
40 | 		<artifactId>azure-identity</artifactId>
41 | 		<version>1.3.5</version>
42 | 	</dependency>	
43 |   </dependencies>
44 | 
45 |   <build>
46 |     <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
47 |       <plugins>
48 |         <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
49 |         <plugin>
50 |           <artifactId>maven-clean-plugin</artifactId>
51 |           <version>3.1.0</version>
52 |         </plugin>
53 |         <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
54 |         <plugin>
55 |           <artifactId>maven-resources-plugin</artifactId>
56 |           <version>3.0.2</version>
57 |         </plugin>
58 |         <plugin>
59 |           <artifactId>maven-compiler-plugin</artifactId>
60 |           <version>3.8.0</version>
61 |         </plugin>
62 |         <plugin>
63 |           <artifactId>maven-surefire-plugin</artifactId>
64 |           <version>2.22.1</version>
65 |         </plugin>
66 |         <plugin>
67 |           <artifactId>maven-jar-plugin</artifactId>
68 |           <version>3.0.2</version>
69 |         </plugin>
70 |         <plugin>
71 |           <artifactId>maven-install-plugin</artifactId>
72 |           <version>2.5.2</version>
73 |         </plugin>
74 |         <plugin>
75 |           <artifactId>maven-deploy-plugin</artifactId>
76 |           <version>2.8.2</version>
77 |         </plugin>
78 |         <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
79 |         <plugin>
80 |           <artifactId>maven-site-plugin</artifactId>
81 |           <version>3.7.1</version>
82 |         </plugin>
83 |         <plugin>
84 |           <artifactId>maven-project-info-reports-plugin</artifactId>
85 |           <version>3.0.0</version>
86 |         </plugin>
87 |       </plugins>
88 |     </pluginManagement>
89 |   </build>
90 | </project>
91 | 


--------------------------------------------------------------------------------
/PhoneNumbers/src/main/java/com/communication/quickstart/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.quickstart;
 2 | import com.azure.communication.phonenumbers.*;
 3 | import com.azure.communication.phonenumbers.models.*;
 4 | import com.azure.core.http.rest.*;
 5 | import com.azure.core.util.Context;
 6 | import com.azure.core.util.polling.PollResponse;
 7 | import com.azure.identity.*;
 8 | import java.io.*;
 9 | 
10 | 
11 | public class App 
12 | {
13 |     public static void main( String[] args )
14 |     {
15 | 		
16 | 		System.out.println("Azure Communication Services - Phone Numbers Quickstart");
17 | 		// You can find your endpoint and access key from your resource in the Azure portal
18 | 		//String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";
19 | 
20 | 		//PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
21 | 			//.endpoint(endpoint)
22 | 			//.credential(new DefaultAzureCredentialBuilder().build())
23 | 			//.buildClient();		  
24 | 		
25 | 		// You can find your connection string from your resource in the Azure portal
26 | 		String connectionString = "https://<RESOURCE_NAME>.communication.azure.com/;accesskey=<ACCESS_KEY>";
27 | 
28 | 		PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
29 | 			.connectionString(connectionString)
30 | 			.buildClient();		
31 | 		
32 | 		
33 | 		// Search for Available Phone Numbers
34 | 		PhoneNumberCapabilities capabilities = new PhoneNumberCapabilities()
35 | 			.setCalling(PhoneNumberCapabilityType.INBOUND)
36 | 			.setSms(PhoneNumberCapabilityType.INBOUND_OUTBOUND);
37 | 		PhoneNumberSearchOptions searchOptions = new PhoneNumberSearchOptions().setAreaCode("833").setQuantity(1);
38 | 
39 | 		PhoneNumberSearchResult searchResult = phoneNumberClient
40 | 			.beginSearchAvailablePhoneNumbers("US", PhoneNumberType.TOLL_FREE, PhoneNumberAssignmentType.APPLICATION, capabilities,  searchOptions, Context.NONE)
41 | 			.getFinalResult();
42 | 
43 | 		System.out.println("Searched phone numbers: " + searchResult.getPhoneNumbers());
44 | 		System.out.println("Search expires by: " + searchResult.getSearchExpiresBy());
45 | 		System.out.println("Phone number costs:" + searchResult.getCost().getAmount());	
46 | 
47 | 		// Purchase Phone Numbers
48 | 		PollResponse<PhoneNumberOperation> purchaseResponse = phoneNumberClient.beginPurchasePhoneNumbers(searchResult.getSearchId(), Context.NONE).waitForCompletion();
49 | 		System.out.println("Purchase phone numbers operation is: " + purchaseResponse.getStatus());		
50 | 		
51 | 		
52 | 		// Get Phone Number(s)
53 | 		//PurchasedPhoneNumber phoneNumber = phoneNumberClient.getPurchasedPhoneNumber("<Phone Number>");
54 | 		//System.out.println("Phone Number Country Code: " + phoneNumber.getCountryCode());
55 | 		
56 | 		// You can also retrieve all the purchased phone numbers.
57 | 		PagedIterable<PurchasedPhoneNumber> phoneNumbers = phoneNumberClient.listPurchasedPhoneNumbers(Context.NONE);
58 | 		PurchasedPhoneNumber phoneNumber = phoneNumbers.iterator().next();
59 | 		System.out.println("Phone Number Country Code: " + phoneNumber.getCountryCode());
60 | 
61 | 
62 | 		// Update Phone Number Capabilities
63 | 		
64 | 		PhoneNumberCapabilities updatecapabilities = new PhoneNumberCapabilities();
65 | 		capabilities
66 | 			.setCalling(PhoneNumberCapabilityType.INBOUND)
67 | 			.setSms(PhoneNumberCapabilityType.INBOUND_OUTBOUND);
68 | 		PurchasedPhoneNumber updatephoneNumber = phoneNumberClient.beginUpdatePhoneNumberCapabilities("<Phone Number>", updatecapabilities, Context.NONE).getFinalResult();
69 | 
70 | 		System.out.println("Phone Number Calling capabilities: " + updatephoneNumber.getCapabilities().getCalling()); //Phone Number Calling capabilities: inbound
71 | 		System.out.println("Phone Number SMS capabilities: " + updatephoneNumber.getCapabilities().getSms()); //Phone Number SMS capabilities: inbound+outbound		
72 | 		
73 | 		
74 | 		// Release Phone Number
75 | 		PollResponse<PhoneNumberOperation> releaseResponse =
76 | 			phoneNumberClient.beginReleasePhoneNumber("<Phone Number>", Context.NONE).waitForCompletion();
77 | 		System.out.println("Release phone number operation is: " + releaseResponse.getStatus());		
78 | 		
79 | 		
80 |     }
81 | }
82 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # Azure Communication Services Web (Java) SDK
 2 | 
 3 | Azure Communication Services enable developers to add communication capabilities to their applications. 
 4 | 
 5 | ## Prerequisites
 6 | 
 7 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 8 | - [Java Development Kit (JDK)](https://docs.microsoft.com/azure/developer/java/fundamentals/java-jdk-install) version 8 or above.
 9 | - [Apache Maven.](https://maven.apache.org/download.cgi)
10 | - A deployed Communication Services resource and connection string. [Create an Azure Communication Resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
11 | 
12 | ## Quickstarts
13 | 
14 | 1. [Create and manage access tokens](https://docs.microsoft.com/azure/communication-services/quickstarts/access-tokens?pivots=programming-language-java)
15 | 
16 | 2. [Set up and manage access tokens for Teams users](https://docs.microsoft.com/azure/communication-services/quickstarts/manage-teams-identity?pivots=programming-language-java)
17 | 
18 | 3. [Add Chat to your app](https://docs.microsoft.com/azure/communication-services/quickstarts/chat/get-started?pivots=programming-language-java)
19 | 
20 | 4. [Send an SMS message](https://docs.microsoft.com/azure/communication-services/quickstarts/telephony-sms/send?pivots=programming-language-java)
21 | 
22 | 5. [Create and manage access tokens](https://docs.microsoft.com/azure/communication-services/quickstarts/access-tokens?pivots=programming-language-java)
23 | 
24 | 6. [Get started with Rooms](https://docs.microsoft.com/en-us/azure/communication-services/quickstarts/rooms/get-started-rooms?pivots=programming-language-java)
25 | 
26 | ## Data Collection
27 |  
28 | The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. Some Quickstart samples collect information about users and their use of the software that cannot be opted out of. Do not use Quickstart samples that collect information if you wish to avoid telemetry. You can learn more about data collection and use in the help documentation and Microsoft’s [privacy statement](https://go.microsoft.com/fwlink/?LinkID=824704). For more information on the data collected by the Azure SDK, please visit the [Telemetry Policy](https://learn.microsoft.com/azure/communication-services/concepts/privacy) page.
29 | 


--------------------------------------------------------------------------------
/ServerRecording/.gitignore:
--------------------------------------------------------------------------------
 1 | HELP.md
 2 | target/
 3 | !.mvn/wrapper/maven-wrapper.jar
 4 | !**/src/main/**/target/
 5 | !**/src/test/**/target/
 6 | 
 7 | ### STS ###
 8 | .apt_generated
 9 | .classpath
10 | .factorypath
11 | .project
12 | .settings
13 | .springBeans
14 | .sts4-cache
15 | 
16 | ### IntelliJ IDEA ###
17 | .idea
18 | *.iws
19 | *.iml
20 | *.ipr
21 | 
22 | ### NetBeans ###
23 | /nbproject/private/
24 | /nbbuild/
25 | /dist/
26 | /nbdist/
27 | /.nb-gradle/
28 | build/
29 | !**/src/main/**/build/
30 | !**/src/test/**/build/
31 | 
32 | ### VS Code ###
33 | .vscode/
34 | 


--------------------------------------------------------------------------------
/ServerRecording/src/main/java/com/acsrecording/api/ApiApplication.java:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation. All rights reserved.
 2 | // Licensed under the MIT License.
 3 | 
 4 | package com.acsrecording.api;
 5 | 
 6 | import org.springframework.boot.SpringApplication;
 7 | import org.springframework.boot.autoconfigure.SpringBootApplication;
 8 | 
 9 | @SpringBootApplication
10 | public class ApiApplication {
11 | 	public static void main(String[] args) {
12 | 		SpringApplication.run(ApiApplication.class, args);
13 | 	}
14 | 
15 | }
16 | 


--------------------------------------------------------------------------------
/ServerRecording/src/main/java/com/acsrecording/api/ConfigurationManager.java:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation. All rights reserved.
 2 | // Licensed under the MIT License.
 3 | 
 4 | package com.acsrecording.api;
 5 | 
 6 | import java.io.InputStream;
 7 | import java.io.InputStreamReader;
 8 | import java.io.Reader;
 9 | import java.util.Properties;
10 | 
11 | public class ConfigurationManager {
12 |     private static ConfigurationManager configurationManager = null;
13 |     private final Properties appSettings = new Properties();
14 | 
15 |     private ConfigurationManager() {
16 |     }
17 | 
18 |     // static method to create instance of ConfigurationManager class
19 |     public static ConfigurationManager getInstance() {
20 |         if (configurationManager == null) {
21 |             configurationManager = new ConfigurationManager();
22 |             configurationManager.loadAppSettings();
23 |         }
24 |         return configurationManager;
25 |     }
26 | 
27 |     public void loadAppSettings() {
28 |         try {
29 |             ClassLoader classLoader = getClass().getClassLoader();
30 |             InputStream inputStream = classLoader.getResourceAsStream("config.properties");
31 |             assert inputStream != null;
32 |             Reader reader = new InputStreamReader(inputStream);
33 |             appSettings.load(reader);
34 |             reader.close();
35 |         } catch (Exception ex) {
36 |             System.out.print("\n Loading app settings failed with error - " + ex.getMessage());
37 |         }
38 |     }
39 | 
40 |     public String getAppSettings(String key) {
41 |         if (!key.isEmpty()) {
42 |             return appSettings.getProperty(key);
43 |         }
44 |         return "";
45 |     }
46 | }


--------------------------------------------------------------------------------
/ServerRecording/src/main/java/com/acsrecording/api/Models/AudioConfiguration.java:
--------------------------------------------------------------------------------
 1 | package com.acsrecording.api.Models;
 2 | 
 3 | public class AudioConfiguration {
 4 |   private float sampleRate;
 5 |   private float bitRate;
 6 |   private float channels;
 7 | 
 8 |   public float getSampleRate() {
 9 |     return sampleRate;
10 |   }
11 | 
12 |   public float getBitRate() {
13 |     return bitRate;
14 |   }
15 | 
16 |   public float getChannels() {
17 |     return channels;
18 |   }
19 | 
20 |   public void setSampleRate(float sampleRate) {
21 |     this.sampleRate = sampleRate;
22 |   }
23 | 
24 |   public void setBitRate(float bitRate) {
25 |     this.bitRate = bitRate;
26 |   }
27 | 
28 |   public void setChannels(float channels) {
29 |     this.channels = channels;
30 |   }
31 | }
32 | 


--------------------------------------------------------------------------------
/ServerRecording/src/main/java/com/acsrecording/api/Models/FileDownloadType.java:
--------------------------------------------------------------------------------
 1 | package com.acsrecording.api.Models;
 2 | 
 3 | public class FileDownloadType {
 4 |     private final static String recording = "recording";
 5 |     private final static String metadata = "metadata";
 6 | 
 7 |     public static String getRecording() {
 8 |         return recording;
 9 |     }
10 | 
11 |     public static String getMetadata() {
12 |         return metadata;
13 |     }
14 | }
15 | 


--------------------------------------------------------------------------------
/ServerRecording/src/main/java/com/acsrecording/api/Models/FileFormat.java:
--------------------------------------------------------------------------------
 1 | package com.acsrecording.api.Models;
 2 | 
 3 | public class FileFormat {
 4 |     private final static String json = "json";
 5 |     private final static String mp4 = "mp4";
 6 |     private final static String mp3 = "mp3";
 7 |     private final static String wav = "wav";
 8 | 
 9 |     public static String getJson() {
10 |         return json;
11 |     }
12 | 
13 |     public static String getMp4() {
14 |         return mp4;
15 |     }
16 | 
17 |     public static String getMp3() {
18 |         return mp3;
19 |     }
20 | 
21 |     public static String getWav() {
22 |         return wav;
23 |     }
24 | }
25 | 


--------------------------------------------------------------------------------
/ServerRecording/src/main/java/com/acsrecording/api/Models/Mapper.java:
--------------------------------------------------------------------------------
 1 | package com.acsrecording.api.Models;
 2 | 
 3 | import java.util.Map;
 4 | import java.util.HashMap;
 5 | import com.azure.communication.callautomation.models.RecordingContent;
 6 | import com.azure.communication.callautomation.models.RecordingChannel;
 7 | import com.azure.communication.callautomation.models.RecordingFormat;
 8 | 
 9 | public class Mapper {
10 |     static Map<String, RecordingContent> recContentMap = new HashMap<String, RecordingContent>() {
11 |         {
12 |             put("audiovideo", RecordingContent.AUDIO_VIDEO);
13 |             put("audio", RecordingContent.AUDIO);
14 |         }
15 |     };
16 | 
17 |     static Map<String, RecordingChannel> recChannelMap = new HashMap<String, RecordingChannel>() {
18 |         {
19 |             put("mixed", RecordingChannel.MIXED);
20 |             put("unmixed", RecordingChannel.UNMIXED);
21 |         }
22 |     };
23 | 
24 |     static Map<String, RecordingFormat> recFormatMap = new HashMap<String, RecordingFormat>() {
25 |         {
26 |             put("mp3", RecordingFormat.MP3);
27 |             put("mp4", RecordingFormat.MP4);
28 |             put("wav", RecordingFormat.WAV);
29 |         }
30 |     };
31 | 
32 |     public static Map<String, RecordingContent> getRecordingContentMap() {
33 |         return recContentMap;
34 |     }
35 | 
36 |     public static Map<String, RecordingChannel> getRecordingChannelMap() {
37 |         return recChannelMap;
38 |     }
39 | 
40 |     public static Map<String, RecordingFormat> getRecordingFormatMap() {
41 |         return recFormatMap;
42 |     }
43 | }


--------------------------------------------------------------------------------
/ServerRecording/src/main/java/com/acsrecording/api/Models/RecordingInfo.java:
--------------------------------------------------------------------------------
 1 | package com.acsrecording.api.Models;
 2 | 
 3 | public class RecordingInfo {
 4 |   private String contentType;
 5 |   private String channelType;
 6 |   private String format;
 7 |   AudioConfiguration AudioConfigurationObject;
 8 |   VideoConfiguration VideoConfigurationObject;
 9 | 
10 |   public String getContentType() {
11 |     return contentType;
12 |   }
13 | 
14 |   public String getChannelType() {
15 |     return channelType;
16 |   }
17 | 
18 |   public String getFormat() {
19 |     return format;
20 |   }
21 | 
22 |   public AudioConfiguration getAudioConfiguration() {
23 |     return AudioConfigurationObject;
24 |   }
25 | 
26 |   public VideoConfiguration getVideoConfiguration() {
27 |     return VideoConfigurationObject;
28 |   }
29 | 
30 |   public void setContentType(String contentType) {
31 |     this.contentType = contentType;
32 |   }
33 | 
34 |   public void setChannelType(String channelType) {
35 |     this.channelType = channelType;
36 |   }
37 | 
38 |   public void setFormat(String format) {
39 |     this.format = format;
40 |   }
41 | 
42 |   public void setAudioConfiguration(AudioConfiguration audioConfigurationObject) {
43 |     this.AudioConfigurationObject = audioConfigurationObject;
44 |   }
45 | 
46 |   public void setVideoConfiguration(VideoConfiguration videoConfigurationObject) {
47 |     this.VideoConfigurationObject = videoConfigurationObject;
48 |   }
49 | }
50 | 


--------------------------------------------------------------------------------
/ServerRecording/src/main/java/com/acsrecording/api/Models/Root.java:
--------------------------------------------------------------------------------
 1 | package com.acsrecording.api.Models;
 2 | 
 3 | import java.util.*;
 4 | 
 5 | public class Root {
 6 |   private String resourceId;
 7 |   private String callId;
 8 |   private String chunkDocumentId;
 9 |   private float chunkIndex;
10 |   private String chunkStartTime;
11 |   private float chunkDuration;
12 |   ArrayList<Object> pauseResumeIntervals = new ArrayList<Object>();
13 |   RecordingInfo recordingInfo;
14 |   ArrayList<Object> participants = new ArrayList<Object>();
15 | 
16 |   public String getResourceId() {
17 |     return resourceId;
18 |   }
19 | 
20 |   public String getCallId() {
21 |     return callId;
22 |   }
23 | 
24 |   public String getChunkDocumentId() {
25 |     return chunkDocumentId;
26 |   }
27 | 
28 |   public float getChunkIndex() {
29 |     return chunkIndex;
30 |   }
31 | 
32 |   public String getChunkStartTime() {
33 |     return chunkStartTime;
34 |   }
35 | 
36 |   public float getChunkDuration() {
37 |     return chunkDuration;
38 |   }
39 | 
40 |   public RecordingInfo getRecordingInfo() {
41 |     return recordingInfo;
42 |   }
43 | 
44 |   public void setResourceId(String resourceId) {
45 |     this.resourceId = resourceId;
46 |   }
47 | 
48 |   public void setCallId(String callId) {
49 |     this.callId = callId;
50 |   }
51 | 
52 |   public void setChunkDocumentId(String chunkDocumentId) {
53 |     this.chunkDocumentId = chunkDocumentId;
54 |   }
55 | 
56 |   public void setChunkIndex(float chunkIndex) {
57 |     this.chunkIndex = chunkIndex;
58 |   }
59 | 
60 |   public void setChunkStartTime(String chunkStartTime) {
61 |     this.chunkStartTime = chunkStartTime;
62 |   }
63 | 
64 |   public void setChunkDuration(float chunkDuration) {
65 |     this.chunkDuration = chunkDuration;
66 |   }
67 | 
68 |   public void setRecordingInfo(RecordingInfo recordingInfo) {
69 |     this.recordingInfo = recordingInfo;
70 |   }
71 | }
72 | 


--------------------------------------------------------------------------------
/ServerRecording/src/main/java/com/acsrecording/api/Models/VideoConfiguration.java:
--------------------------------------------------------------------------------
 1 | package com.acsrecording.api.Models;
 2 | 
 3 | public class VideoConfiguration {
 4 |   private float longerSideLength;
 5 |   private float shorterSideLength;
 6 |   private float framerate;
 7 |   private float bitRate;
 8 | 
 9 |   public float getLongerSideLength() {
10 |     return longerSideLength;
11 |   }
12 | 
13 |   public float getShorterSideLength() {
14 |     return shorterSideLength;
15 |   }
16 | 
17 |   public float getFramerate() {
18 |     return framerate;
19 |   }
20 | 
21 |   public float getBitRate() {
22 |     return bitRate;
23 |   }
24 | 
25 |   public void setLongerSideLength(float longerSideLength) {
26 |     this.longerSideLength = longerSideLength;
27 |   }
28 | 
29 |   public void setShorterSideLength(float shorterSideLength) {
30 |     this.shorterSideLength = shorterSideLength;
31 |   }
32 | 
33 |   public void setFramerate(float framerate) {
34 |     this.framerate = framerate;
35 |   }
36 | 
37 |   public void setBitRate(float bitRate) {
38 |     this.bitRate = bitRate;
39 |   }
40 | }
41 | 


--------------------------------------------------------------------------------
/ServerRecording/src/main/resources/application.properties:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/ServerRecording/src/main/resources/application.properties


--------------------------------------------------------------------------------
/ServerRecording/src/main/resources/config.properties:
--------------------------------------------------------------------------------
1 | Connectionstring=endpoint=https://REDACTED.communication.azure.com/;accesskey=QWNjZXNzS2V5
2 | BlobStorageConnectionString=DefaultEndpointsProtocol=https;AccountName=REDACTED;AccountKey=QWNjZXNzS2V5;EndpointSuffix=core.windows.net
3 | ContainerName=acs-recording-container-name


--------------------------------------------------------------------------------
/ServerRecording/src/test/java/com/acsrecording/api/ApiApplicationTests.java:
--------------------------------------------------------------------------------
 1 | package com.acsrecording.api;
 2 | 
 3 | import org.junit.jupiter.api.Test;
 4 | import org.springframework.boot.test.context.SpringBootTest;
 5 | 
 6 | @SpringBootTest
 7 | class ApiApplicationTests {
 8 | 
 9 | 	@Test
10 | 	void contextLoads() {
11 | 	}
12 | 
13 | }
14 | 


--------------------------------------------------------------------------------
/access-token-quickstart/README.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - Java
 5 | products:
 6 | - azure
 7 | - azure-communication-services
 8 | ---
 9 | 
10 | 
11 | # Create and manage access tokens
12 | 
13 | For full instructions on how to build this code sample from scratch, look at [Quickstart: Create and manage access tokens](https://docs.microsoft.com/en-us/azure/communication-services/quickstarts/access-tokens?pivots=programming-language-java)
14 | 
15 | ## Prerequisites
16 | 
17 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
18 | - [Java Development Kit (JDK)](https://docs.microsoft.com/en-us/azure/developer/java/fundamentals/java-jdk-install) version 8 or above
19 | - [Apache Maven](https://maven.apache.org/download.cgi)
20 | - A deployed Communication Services resource and connection string. For details, see [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
21 | 
22 | ## Code Structure
23 | 
24 | - **./communication-quickstart/src/main/java/com/communication/quickstart:** contains code for creating and managing access tokens.
25 | - **pom.xml:** Project's Project Object Model, or [POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).
26 | 
27 | ## Before running sample code
28 | 
29 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you'd like to clone the sample to.
30 | 2. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
31 | 3.  With the Communication Services procured in pre-requisites, add connection string with the access key in the code.
32 | 
33 | ## Run the code
34 | 
35 | 1. Navigate to the directory containing the pom.xml file and compile the project by using command `mvn compile`
36 | 2. Then, build the package using command `mvn package`
37 | 3. Run the command to execute the app `mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false`
38 | 


--------------------------------------------------------------------------------
/access-token-quickstart/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | 
 3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 | 	<modelVersion>4.0.0</modelVersion>
 6 | 
 7 | 	<groupId>com.communication.quickstart</groupId>
 8 | 	<artifactId>communication-quickstart</artifactId>
 9 | 	<version>1.0-SNAPSHOT</version>
10 | 
11 | 	<name>communication-quickstart</name>
12 | 	<!-- FIXME change it to the project's website -->
13 | 	<url>http://www.example.com</url>
14 | 
15 | 	<properties>
16 | 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
17 | 		<maven.compiler.source>1.7</maven.compiler.source>
18 | 		<maven.compiler.target>1.7</maven.compiler.target>
19 | 	</properties>
20 | 
21 | 	<dependencies>
22 | 		<dependency>
23 | 			<groupId>junit</groupId>
24 | 			<artifactId>junit</artifactId>
25 | 			<version>4.11</version>
26 | 			<scope>test</scope>
27 | 		</dependency>
28 | 		<dependency>
29 | 			<groupId>com.azure</groupId>
30 | 			<artifactId>azure-communication-identity</artifactId>
31 | 			<version>[1.4.0,)</version>
32 | 		</dependency>
33 | 	</dependencies>
34 | 
35 | 	<build>
36 | 		<pluginManagement>
37 | 			<!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
38 | 			<plugins>
39 | 				<!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
40 | 				<plugin>
41 | 					<artifactId>maven-clean-plugin</artifactId>
42 | 					<version>3.1.0</version>
43 | 				</plugin>
44 | 				<!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
45 | 				<plugin>
46 | 					<artifactId>maven-resources-plugin</artifactId>
47 | 					<version>3.0.2</version>
48 | 				</plugin>
49 | 				<plugin>
50 | 					<artifactId>maven-compiler-plugin</artifactId>
51 | 					<version>3.8.0</version>
52 | 				</plugin>
53 | 				<plugin>
54 | 					<artifactId>maven-surefire-plugin</artifactId>
55 | 					<version>2.22.1</version>
56 | 				</plugin>
57 | 				<plugin>
58 | 					<artifactId>maven-jar-plugin</artifactId>
59 | 					<version>3.0.2</version>
60 | 				</plugin>
61 | 				<plugin>
62 | 					<artifactId>maven-install-plugin</artifactId>
63 | 					<version>2.5.2</version>
64 | 				</plugin>
65 | 				<plugin>
66 | 					<artifactId>maven-deploy-plugin</artifactId>
67 | 					<version>2.8.2</version>
68 | 				</plugin>
69 | 				<!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
70 | 				<plugin>
71 | 					<artifactId>maven-site-plugin</artifactId>
72 | 					<version>3.7.1</version>
73 | 				</plugin>
74 | 				<plugin>
75 | 					<artifactId>maven-project-info-reports-plugin</artifactId>
76 | 					<version>3.0.0</version>
77 | 				</plugin>
78 | 			</plugins>
79 | 		</pluginManagement>
80 | 	</build>
81 | </project>
82 | 


--------------------------------------------------------------------------------
/access-token-quickstart/src/main/java/com/communication/quickstart/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.quickstart;
 2 | 
 3 | import com.azure.communication.common.*;
 4 | import com.azure.communication.identity.*;
 5 | import com.azure.communication.identity.models.*;
 6 | import com.azure.core.credential.*;
 7 | 
 8 | import java.io.IOException;
 9 | import java.time.*;
10 | import java.util.*;
11 | 
12 | public class App
13 | {
14 |     public static void main( String[] args ) throws IOException
15 |     {
16 |         System.out.println("Azure Communication Services - Access Tokens Quickstart");
17 |        
18 |         // Your can find your connection string from your resource in the Azure portal
19 |         String connectionString = "<connection_string>";
20 | 
21 |         CommunicationIdentityClient communicationIdentityClient = new CommunicationIdentityClientBuilder()
22 |             .connectionString(connectionString)
23 |             .buildClient();
24 | 
25 |          // Create an identity
26 |         CommunicationUserIdentifier user = communicationIdentityClient.createUser();
27 |         System.out.println("\nCreated an identity with ID: " + user.getId());
28 |         
29 | 
30 |         // Issue an access token with a validity of 24 hours and the "voip" scope for a user identity
31 |         List<CommunicationTokenScope> scopes = new ArrayList<>(Arrays.asList(CommunicationTokenScope.VOIP));
32 |         AccessToken accessToken = communicationIdentityClient.getToken(user, scopes);
33 |         OffsetDateTime expiresAt = accessToken.getExpiresAt();
34 |         String token = accessToken.getToken();
35 |         System.out.println("\nIssued an access token with 'voip' scope that expires at " + expiresAt + ": " + token);
36 | 
37 |         // Issue an access token with a validity of an hour and the "voip" scope for a user identity
38 |         Duration tokenExpiresIn = Duration.ofHours(1);
39 |         accessToken = communicationIdentityClient.getToken(user, scopes, tokenExpiresIn);
40 | 
41 |         //Create an identity and issue token with a validity of 24 hours in one call
42 |         List<CommunicationTokenScope> scope = Arrays.asList(CommunicationTokenScope.CHAT);
43 |         CommunicationUserIdentifierAndToken result = communicationIdentityClient.createUserAndToken(scope);
44 |         CommunicationUserIdentifier userIdentifier = result.getUser();
45 |         System.out.println("\nCreated a user identity with ID: " + userIdentifier.getId());
46 |         AccessToken userTokenResult = result.getUserToken();
47 |         OffsetDateTime expiresTime = userTokenResult.getExpiresAt();
48 |         String userToken = userTokenResult.getToken();
49 |         System.out.println("\nIssued an access token with 'chat' scope that expires at " + expiresTime + ": " + userToken);
50 | 
51 |         // Refresh access tokens - existingIdentity represents identity of Azure Communication Services stored during identity creation
52 |         CommunicationUserIdentifier identity = new CommunicationUserIdentifier(userIdentifier.getId());
53 |         AccessToken response = communicationIdentityClient.getToken(identity, scope);
54 | 
55 |         // Revoke access tokens
56 |         communicationIdentityClient.revokeTokens(userIdentifier);
57 |         System.out.println("\nSuccessfully revoked all access tokens for user identity with ID: " + userIdentifier.getId());
58 | 
59 |         // Delete an identity
60 |         communicationIdentityClient.deleteUser(userIdentifier);
61 |         System.out.println("\nDeleted the user identity with ID: " + userIdentifier.getId());
62 | 
63 |     }
64 | }


--------------------------------------------------------------------------------
/chat-quickstart-java/README.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - Java
 5 | products:
 6 | - azure
 7 | - azure-communication-services
 8 | ---
 9 | 
10 | 
11 | # Add Chat to your Application
12 | 
13 | For full instructions on how to build this code sample from scratch, look at [Quickstart: Add Chat to your App](https://docs.microsoft.com/en-us/azure/communication-services/quickstarts/chat/get-started?pivots=programming-language-java)
14 | 
15 | ## Prerequisites
16 | 
17 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
18 | - [Java Development Kit (JDK)](https://docs.microsoft.com/en-us/azure/developer/java/fundamentals/java-jdk-install)
19 | - [Apache Maven](https://maven.apache.org/download.cgi)
20 | - A deployed Communication Services resource and connection string. For details, see [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
21 | - A [User Access Token](https://docs.microsoft.com/en-us/azure/communication-services/quickstarts/access-tokens?pivots=programming-language-java). Be sure to set the scope to "chat", and note the token string as well as the userId string.
22 | 
23 | ## Code Structure
24 | 
25 | - **src/main/java directory:** contains the project source code.
26 | - **pom.xml:** Project's Project Object Model, or [POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).
27 | 
28 | ## Before running sample code
29 | 
30 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you'd like to clone the sample to.
31 | 2. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
32 | 3.  With the Communication Services procured in pre-requisites, add connection string with the access key in the code.
33 | 
34 | ## Run the code
35 | 1. Navigate to the directory containing the pom.xml file and compile the project by using command `mvn compile`
36 | 2. Then, build the package using command `mvn package`
37 | 3. Run the command to execute the app `mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false`
38 | 


--------------------------------------------------------------------------------
/chat-quickstart-java/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | 
 3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |   <modelVersion>4.0.0</modelVersion>
 6 | 
 7 |   <groupId>com.communication.quickstart</groupId>
 8 |   <artifactId>communication-quickstart</artifactId>
 9 |   <version>1.0-SNAPSHOT</version>
10 | 
11 |   <name>communication-quickstart</name>
12 |   <!-- FIXME change it to the project's website -->
13 |   <url>http://www.example.com</url>
14 | 
15 |   <properties>
16 | 	  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
17 | 	  <maven.compiler.source>1.8</maven.compiler.source>
18 | 	  <maven.compiler.target>1.8</maven.compiler.target>
19 |   </properties>
20 | 
21 |   <dependencies>
22 |     <dependency>
23 |       <groupId>junit</groupId>
24 |       <artifactId>junit</artifactId>
25 |       <version>4.11</version>
26 |       <scope>test</scope>
27 |     </dependency>
28 | 	  <dependency>
29 | 		  <groupId>com.azure</groupId>
30 | 		  <artifactId>azure-communication-chat</artifactId>
31 | 		  <version>1.0.1</version>
32 | 	  </dependency>
33 | 	  <dependency>
34 | 		  <groupId>com.azure</groupId>
35 | 		  <artifactId>azure-communication-common</artifactId>
36 | 		  <version>1.0.3</version>
37 | 	  </dependency>
38 |   </dependencies>
39 | 
40 |   <build>
41 |     <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
42 |       <plugins>
43 |         <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
44 |         <plugin>
45 |           <artifactId>maven-clean-plugin</artifactId>
46 |           <version>3.1.0</version>
47 |         </plugin>
48 |         <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
49 |         <plugin>
50 |           <artifactId>maven-resources-plugin</artifactId>
51 |           <version>3.0.2</version>
52 |         </plugin>
53 |         <plugin>
54 |           <artifactId>maven-compiler-plugin</artifactId>
55 |           <version>3.8.0</version>
56 |         </plugin>
57 |         <plugin>
58 |           <artifactId>maven-surefire-plugin</artifactId>
59 |           <version>2.22.1</version>
60 |         </plugin>
61 |         <plugin>
62 |           <artifactId>maven-jar-plugin</artifactId>
63 |           <version>3.0.2</version>
64 |         </plugin>
65 |         <plugin>
66 |           <artifactId>maven-install-plugin</artifactId>
67 |           <version>2.5.2</version>
68 |         </plugin>
69 |         <plugin>
70 |           <artifactId>maven-deploy-plugin</artifactId>
71 |           <version>2.8.2</version>
72 |         </plugin>
73 |         <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
74 |         <plugin>
75 |           <artifactId>maven-site-plugin</artifactId>
76 |           <version>3.7.1</version>
77 |         </plugin>
78 |         <plugin>
79 |           <artifactId>maven-project-info-reports-plugin</artifactId>
80 |           <version>3.0.0</version>
81 |         </plugin>
82 |       </plugins>
83 |     </pluginManagement>
84 |   </build>
85 | </project>
86 | 


--------------------------------------------------------------------------------
/chat-quickstart-java/src/main/java/com/communication/quickstart/App.java:
--------------------------------------------------------------------------------
 1 | // <Create a chat client>
 2 | package com.communication.quickstart;
 3 | 
 4 | import com.azure.communication.chat.*;
 5 | import com.azure.communication.chat.models.*;
 6 | import com.azure.communication.common.*;
 7 | import com.azure.core.http.rest.PagedIterable;
 8 | 
 9 | import java.io.*;
10 | import java.util.*;
11 | 
12 | public class App
13 | {
14 |     public static void main( String[] args ) throws IOException
15 |     {
16 |         System.out.println("Azure Communication Services - Chat Quickstart");
17 | 
18 |         String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";
19 | 
20 |         String userAccessToken = "<USER_ACCESS_TOKEN>";
21 | 
22 |         CommunicationTokenCredential userCredential = new CommunicationTokenCredential(userAccessToken);
23 | 
24 |         final ChatClientBuilder builder = new ChatClientBuilder();
25 |         builder.endpoint(endpoint)
26 |             .credential(userCredential);
27 |         ChatClient chatClient = builder.buildClient();
28 | 
29 |         // <Start a chat thread>
30 |         String userId1 = "<USER_Id1>";
31 |         ChatParticipant firstThreadParticipant = new ChatParticipant()
32 |         .setCommunicationIdentifier(new CommunicationUserIdentifier(userId1))
33 |         .setDisplayName("Display Name 1");
34 | 
35 |         String userId2 = "<USER_Id2>";
36 |         ChatParticipant secondThreadParticipant = new ChatParticipant()
37 |         .setCommunicationIdentifier(new CommunicationUserIdentifier(userId2))
38 |         .setDisplayName("Display Name 2");
39 | 
40 |         CreateChatThreadOptions createChatThreadOptions = new CreateChatThreadOptions("Topic")
41 |         .addParticipant(firstThreadParticipant)
42 |         .addParticipant(secondThreadParticipant);
43 | 
44 |         CreateChatThreadResult result = chatClient.createChatThread(createChatThreadOptions);
45 |         String chatThreadId = result.getChatThread().getId();
46 | 
47 |         // <List chat threads>
48 |         PagedIterable<ChatThreadItem> chatThreads = chatClient.listChatThreads();
49 | 
50 |         chatThreads.forEach(chatThread -> {
51 |           System.out.printf("ChatThread id is %s.\n", chatThread.getId());
52 |         });
53 | 
54 |         // <Get a chat thread client>
55 |         ChatThreadClient chatThreadClient = chatClient.getChatThreadClient(chatThreadId);
56 | 
57 |         // <Send a message to a chat thread>
58 |         SendChatMessageOptions sendChatMessageOptions = new SendChatMessageOptions()
59 |         .setContent("Message content")
60 |         .setType(ChatMessageType.TEXT)
61 |         .setSenderDisplayName("Sender Display Name");
62 | 
63 |         SendChatMessageResult sendChatMessageResult = chatThreadClient.sendMessage(sendChatMessageOptions);
64 |         String chatMessageId = sendChatMessageResult.getId();
65 | 
66 |         // <Receive chat messages from a chat thread>
67 |         chatThreadClient.listMessages().forEach(message -> {
68 |           System.out.printf("Message id is %s.\n", message.getId());
69 |         });
70 | 
71 |         // <Send read receipt>
72 |         chatThreadClient.sendReadReceipt(chatMessageId);
73 | 
74 |         // <List chat participants>
75 |         PagedIterable<ChatParticipant> chatParticipantsResponse = chatThreadClient.listParticipants();
76 |         chatParticipantsResponse.forEach(chatParticipant -> {
77 |         System.out.printf("Participant id is %s.\n", ((CommunicationUserIdentifier) chatParticipant.getCommunicationIdentifier()).getId());
78 |         });
79 | 
80 |         //<Add a user as participant to the chat thread>
81 |         List<ChatParticipant> participants = new ArrayList<ChatParticipant>();
82 | 
83 |         String userId3 = "<USER_Id3>";
84 |         ChatParticipant thirdThreadParticipant = new ChatParticipant()
85 |         .setCommunicationIdentifier(new CommunicationUserIdentifier(userId3))
86 |         .setDisplayName("Display Name 3");
87 | 
88 |         String userId4 = "<USER_Id4>";
89 |         ChatParticipant fourthThreadParticipant = new ChatParticipant()
90 |         .setCommunicationIdentifier(new CommunicationUserIdentifier(userId4))
91 |         .setDisplayName("Display Name 4");
92 | 
93 |         participants.add(thirdThreadParticipant);
94 |         participants.add(fourthThreadParticipant);
95 | 
96 |         chatThreadClient.addParticipants(participants);
97 |     }
98 | }
99 | 


--------------------------------------------------------------------------------
/jobrouter-quickstart-java/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | 
  3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5 |   <modelVersion>4.0.0</modelVersion>
  6 | 
  7 |   <groupId>com.communication.jobrouter.quickstart</groupId>
  8 |   <artifactId>jobrouter-quickstart-java</artifactId>
  9 |   <version>1.0-SNAPSHOT</version>
 10 | 
 11 |   <name>jobrouter-quickstart-java</name>
 12 |   <url>http://www.example.com</url>
 13 | 
 14 |   <properties>
 15 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 16 |     <maven.compiler.source>1.7</maven.compiler.source>
 17 |     <maven.compiler.target>1.7</maven.compiler.target>
 18 |   </properties>
 19 | 
 20 |   <dependencies>
 21 |     <dependency>
 22 |       <groupId>junit</groupId>
 23 |       <artifactId>junit</artifactId>
 24 |       <version>4.11</version>
 25 |       <scope>test</scope>
 26 |     </dependency>
 27 |     <dependency>
 28 |       <groupId>com.azure</groupId>
 29 |       <artifactId>azure-communication-jobrouter</artifactId>
 30 |       <version>2.0.0-alpha.20240412.6</version>
 31 |     </dependency>
 32 |   </dependencies>
 33 | 
 34 |   <repositories>
 35 |     <repository>
 36 |       <id>azure-sdk-for-java</id>
 37 |       <url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
 38 |       <releases>
 39 |         <enabled>true</enabled>
 40 |       </releases>
 41 |       <snapshots>
 42 |         <enabled>true</enabled>
 43 |       </snapshots>
 44 |     </repository>
 45 |   </repositories>
 46 | 
 47 |   <distributionManagement>
 48 |     <repository>
 49 |       <id>azure-sdk-for-java</id>
 50 |       <url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
 51 |       <releases>
 52 |         <enabled>true</enabled>
 53 |       </releases>
 54 |       <snapshots>
 55 |         <enabled>true</enabled>
 56 |       </snapshots>
 57 |     </repository>
 58 |   </distributionManagement>
 59 | 
 60 |   <build>
 61 |     <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
 62 |       <plugins>
 63 |         <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
 64 |         <plugin>
 65 |           <artifactId>maven-clean-plugin</artifactId>
 66 |           <version>3.1.0</version>
 67 |         </plugin>
 68 |         <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
 69 |         <plugin>
 70 |           <artifactId>maven-resources-plugin</artifactId>
 71 |           <version>3.0.2</version>
 72 |         </plugin>
 73 |         <plugin>
 74 |           <artifactId>maven-compiler-plugin</artifactId>
 75 |           <version>3.8.0</version>
 76 |         </plugin>
 77 |         <plugin>
 78 |           <artifactId>maven-surefire-plugin</artifactId>
 79 |           <version>2.22.1</version>
 80 |         </plugin>
 81 |         <plugin>
 82 |           <artifactId>maven-jar-plugin</artifactId>
 83 |           <version>3.0.2</version>
 84 |         </plugin>
 85 |         <plugin>
 86 |           <artifactId>maven-install-plugin</artifactId>
 87 |           <version>2.5.2</version>
 88 |         </plugin>
 89 |         <plugin>
 90 |           <artifactId>maven-deploy-plugin</artifactId>
 91 |           <version>2.8.2</version>
 92 |         </plugin>
 93 |         <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
 94 |         <plugin>
 95 |           <artifactId>maven-site-plugin</artifactId>
 96 |           <version>3.7.1</version>
 97 |         </plugin>
 98 |         <plugin>
 99 |           <artifactId>maven-project-info-reports-plugin</artifactId>
100 |           <version>3.0.0</version>
101 |         </plugin>
102 |       </plugins>
103 |     </pluginManagement>
104 |     <plugins>
105 |       <plugin>
106 |         <groupId>org.apache.maven.plugins</groupId>
107 |         <artifactId>maven-compiler-plugin</artifactId>
108 |         <configuration>
109 |           <source>9</source>
110 |           <target>9</target>
111 |         </configuration>
112 |       </plugin>
113 |     </plugins>
114 |   </build>
115 | </project>
116 | 


--------------------------------------------------------------------------------
/jobrouter-quickstart-java/readme.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - java
 5 | products:
 6 | - azure
 7 | - azure-communication-services
 8 | ---
 9 | 
10 | # Azure Communication Services - Job Router
11 | 
12 | For full instructions on how to build this code sample from scratch, look at [Quickstart: Submit a job for queuing and routing](https://learn.microsoft.com/azure/communication-services/quickstarts/router/get-started-router?pivots=programming-language-java)
13 | 
14 | ## Prerequisites
15 | 
16 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
17 | - An active Communication Services resource and connection string.
18 | - [Java Development Kit (JDK)](https://docs.microsoft.com/azure/developer/java/fundamentals/java-jdk-install) version 8 or above.
19 | - [Apache Maven](https://maven.apache.org/download.cgi)
20 | 
21 | ## Code structure
22 | 
23 | - **src/main/java/com/communication/jobrouter/quickstart/App.java**: includes source code for quick start.
24 | - **pom.xml:** Project's Project Object Model, or [POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).
25 | 
26 | ## Before running sample code
27 | 
28 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you'd like to clone the sample to.
29 | 1. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
30 | 1. With the Communication Services resource connection string procured in pre-requisites, replace the placeholder
31 |    ```String connectionString = "<connection-string>";```.
32 | 
33 | ## Run the code
34 | 
35 | 1. Navigate to the directory containing the pom.xml file and compile the project by using command `mvn compile`.
36 | 2. Build the package using command `mvn package`.
37 | 3. Run the command (in command prompt or bash) to execute the app `mvn exec:java -Dexec.mainClass="com.communication.jobrouter.quickstart.App" -Dexec.cleanupDaemonThreads=false`.
38 | 


--------------------------------------------------------------------------------
/jobrouter-quickstart-java/src/main/java/com/communication/jobrouter/quickstart/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.jobrouter.quickstart;
 2 | 
 3 | import com.azure.communication.jobrouter.JobRouterAdministrationClient;
 4 | import com.azure.communication.jobrouter.JobRouterAdministrationClientBuilder;
 5 | import com.azure.communication.jobrouter.JobRouterClient;
 6 | import com.azure.communication.jobrouter.JobRouterClientBuilder;
 7 | import com.azure.communication.jobrouter.models.*;
 8 | 
 9 | import java.time.Duration;
10 | import java.util.List;
11 | import java.util.Map;
12 | 
13 | /**
14 |  * Azure Communication Services - Job Router Quickstart
15 |  */
16 | public class App 
17 | {
18 |     public static void main( String[] args ) throws InterruptedException {
19 |         System.out.println("Azure Communication Services - Job Router Quickstart");
20 | 
21 |         // Get a connection string to our Azure Communication Services resource.
22 |         String connectionString = "your_connection_string";
23 |         JobRouterAdministrationClient routerAdminClient = new JobRouterAdministrationClientBuilder()
24 |                 .connectionString(connectionString).buildClient();
25 |         JobRouterClient routerClient = new JobRouterClientBuilder().connectionString(connectionString).buildClient();
26 | 
27 |         DistributionPolicy distributionPolicy = routerAdminClient.createDistributionPolicy(
28 |             new CreateDistributionPolicyOptions("distribution-policy-1", Duration.ofMinutes(1), new LongestIdleMode())
29 |                 .setName("My distribution policy"));
30 | 
31 |         RouterQueue queue = routerAdminClient.createQueue(
32 |             new CreateQueueOptions("queue-1",distributionPolicy.getId()).setName("My queue"));
33 | 
34 |         RouterJob job = routerClient.createJob(new CreateJobOptions("job-1", "voice", queue.getId())
35 |             .setPriority(1)
36 |             .setRequestedWorkerSelectors(List.of(
37 |                 new RouterWorkerSelector("Some-Skill", LabelOperator.GREATER_THAN, new RouterValue(10)))));
38 | 
39 |         RouterWorker worker = routerClient.createWorker(
40 |             new CreateWorkerOptions("worker-1", 1)
41 |                 .setQueues(List.of(queue.getId()))
42 |                 .setLabels(Map.of("Some-Skill", new RouterValue(11)))
43 |                 .setChannels(List.of(new RouterChannel("voice", 1)))
44 |                 .setAvailableForOffers(true));
45 | 
46 |         Thread.sleep(10000);
47 |         worker = routerClient.getWorker(worker.getId());
48 |         for (RouterJobOffer offer : worker.getOffers()) {
49 |             System.out.printf("Worker %s has an active offer for job %s\n", worker.getId(), offer.getJobId());
50 |         }
51 | 
52 |         AcceptJobOfferResult accept = routerClient.acceptJobOffer(worker.getId(), worker.getOffers().get(0).getOfferId());
53 |         System.out.printf("Worker %s is assigned job %s\n", worker.getId(), accept.getJobId());
54 | 
55 |         routerClient.completeJobWithResponse(accept.getJobId(), accept.getAssignmentId(), null);
56 |         System.out.printf("Worker %s has completed job %s\n", worker.getId(), accept.getJobId());
57 | 
58 |         routerClient.closeJobWithResponse(accept.getJobId(), accept.getAssignmentId(), null);
59 |         System.out.printf("Worker %s has closed job %s\n", worker.getId(), accept.getJobId());
60 | 
61 |         routerClient.deleteJob(accept.getJobId());
62 |         System.out.printf("Deleted job %s\n", accept.getJobId());
63 |     }
64 | }
65 | 


--------------------------------------------------------------------------------
/jobrouter-quickstart-java/src/test/java/com/communication/jobrouter/quickstart/AppTest.java:
--------------------------------------------------------------------------------
 1 | package com.communication.jobrouter.quickstart;
 2 | 
 3 | import static org.junit.Assert.assertTrue;
 4 | 
 5 | import org.junit.Test;
 6 | 
 7 | /**
 8 |  * Unit test for simple App.
 9 |  */
10 | public class AppTest 
11 | {
12 |     /**
13 |      * Rigorous Test :-)
14 |      */
15 |     @Test
16 |     public void shouldAnswerWithTrue()
17 |     {
18 |         assertTrue( true );
19 |     }
20 | }
21 | 


--------------------------------------------------------------------------------
/rooms-quickstart-java/README.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - java
 5 | products:
 6 | - azure
 7 | - azure-communication-services
 8 | ---
 9 | 
10 | # Azure Communication Services - Rooms
11 | 
12 | This quickstart will help you get started with Azure Communication Services Rooms. A `room` is a server-managed communications space for a known, fixed set of participants to collaborate for a pre-determined duration. The [rooms conceptual documentation](https://docs.microsoft.com/azure/communication-services/concepts/rooms/room-concept) covers more details and use cases for `rooms`.
13 | 
14 | ## Prerequisites
15 | 
16 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
17 | - An active Communication Services resource and connection string.
18 | - Two or more Communication User Identities.
19 | - [Java Development Kit (JDK)](/java/azure/jdk/?view=azure-java-stable&preserve-view=true) version 8 or above.
20 | - [Apache Maven](https://maven.apache.org/download.cgi)
21 | 
22 | ## Code structure
23 | 
24 | - **src/main/java/com/communication/rooms/quickstart/App.java**: includes source code for manging rooms and room participants.
25 | - **pom.xml:** Project's Project Object Model, or [POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).
26 | 
27 | ## Before running sample code
28 | 
29 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you'd like to clone the sample to.
30 | 1. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
31 | 1. With the Communication Services resource connection string procured in pre-requisites, replace the placeholder at line no 31
32 |     ```String connectionString = "<connection-string>";```.
33 | 
34 | ## Run the code
35 | 
36 | 1. Navigate to the directory containing the pom.xml file and compile the project by using command `mvn compile`.
37 | 2. Build the package using command `mvn package`.
38 | 3. Run the command to execute the app `mvn -e exec:java -D"exec.mainClass"="com.communication.rooms.quickstart.App" -D"exec.cleanupDaemonThreads"=false`.
39 | 


--------------------------------------------------------------------------------
/rooms-quickstart-java/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | 
  3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5 |   <modelVersion>4.0.0</modelVersion>
  6 | 
  7 |   <groupId>com.communication.rooms.quickstart</groupId>
  8 |   <artifactId>rooms-quickstart</artifactId>
  9 |   <version>1.1.0</version>
 10 | 
 11 |   <name>rooms-quickstart</name>
 12 |   <!-- FIXME change it to the project's website -->
 13 |   <url>http://www.example.com</url>
 14 | 
 15 | <repositories>
 16 |     <repository>
 17 |         <id>azure-communication-rooms</id>
 18 |         <url>file://${project.basedir}\azure-communication-rooms</url>
 19 |     </repository>
 20 |    </repositories>
 21 | 
 22 |   <properties>
 23 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 24 |     <maven.compiler.source>1.8</maven.compiler.source>
 25 |     <maven.compiler.target>1.8</maven.compiler.target>
 26 |   </properties>
 27 |   <dependencyManagement>
 28 |     <dependencies>
 29 |       <dependency>
 30 |           <groupId>com.azure</groupId>
 31 |           <artifactId>azure-core</artifactId>
 32 |           <version>1.48.0</version>
 33 |       </dependency>
 34 |       <dependency>
 35 |         <groupId>com.azure</groupId>
 36 |         <artifactId>azure-communication-common</artifactId>
 37 |         <version>1.2.8</version>
 38 |       </dependency>
 39 |       <dependency>
 40 |         <groupId>com.azure</groupId>
 41 |         <artifactId>azure-sdk-bom</artifactId>
 42 |         <version>1.2.3</version>
 43 |         <type>pom</type>
 44 |         <scope>import</scope>
 45 |       </dependency>
 46 |     </dependencies>
 47 |   </dependencyManagement>
 48 |   <dependencies>
 49 |     <dependency>
 50 |       <groupId>junit</groupId>
 51 |       <artifactId>junit</artifactId>
 52 |       <version>4.11</version>
 53 |       <scope>test</scope>
 54 |     </dependency>
 55 |     <dependency>
 56 |       <groupId>com.azure</groupId>
 57 |       <artifactId>azure-communication-rooms</artifactId>
 58 |       <version>1.2.0</version>
 59 |     </dependency>
 60 |     <dependency>
 61 |     <groupId>com.azure</groupId>
 62 |     <artifactId>azure-communication-identity</artifactId>
 63 |     <version>1.4.6</version>
 64 |     </dependency>
 65 |     <dependency>
 66 |       <groupId>com.azure</groupId>
 67 |       <artifactId>azure-identity</artifactId>
 68 |       <version>1.4.2</version>
 69 |     </dependency>
 70 |     <dependency>
 71 |       <groupId>com.azure</groupId>
 72 |       <artifactId>azure-communication-common</artifactId>
 73 |     </dependency>
 74 |   </dependencies>
 75 |   <build>
 76 |     <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
 77 |       <plugins>
 78 |         <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
 79 |         <plugin>
 80 |           <artifactId>maven-clean-plugin</artifactId>
 81 |           <version>3.1.0</version>
 82 |         </plugin>
 83 |         <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
 84 |         <plugin>
 85 |           <artifactId>maven-resources-plugin</artifactId>
 86 |           <version>3.0.2</version>
 87 |         </plugin>
 88 |         <plugin>
 89 |           <artifactId>maven-compiler-plugin</artifactId>
 90 |           <version>3.8.0</version>
 91 |         </plugin>
 92 |         <plugin>
 93 |           <artifactId>maven-surefire-plugin</artifactId>
 94 |           <version>2.22.1</version>
 95 |         </plugin>
 96 |         <plugin>
 97 |           <artifactId>maven-jar-plugin</artifactId>
 98 |           <version>3.0.2</version>
 99 |         </plugin>
100 |         <plugin>
101 |           <artifactId>maven-install-plugin</artifactId>
102 |           <version>2.5.2</version>
103 |         </plugin>
104 |         <plugin>
105 |           <artifactId>maven-deploy-plugin</artifactId>
106 |           <version>2.8.2</version>
107 |         </plugin>
108 |         <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
109 |         <plugin>
110 |           <artifactId>maven-site-plugin</artifactId>
111 |           <version>3.7.1</version>
112 |         </plugin>
113 |         <plugin>
114 |           <artifactId>maven-project-info-reports-plugin</artifactId>
115 |           <version>3.0.0</version>
116 |         </plugin>
117 |       </plugins>
118 |     </pluginManagement>
119 |   </build>
120 | </project>
121 | 


--------------------------------------------------------------------------------
/send-email-advanced/README.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - Java
 5 | products:
 6 | - azure
 7 | - azure-communication-email
 8 | ---
 9 | 
10 | 
11 | # Email Sample
12 | 
13 | This sample sends an email to the selected recipients of any domain using an [Email Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/email/create-email-communication-resource).
14 | 
15 | Additional documentation for this sample can be found on [Microsoft Docs](https://docs.microsoft.com/azure/communication-services/concepts/email/email-overview).
16 | 
17 | ## Prerequisites
18 | 
19 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
20 | - [Java Development Kit (JDK)](https://docs.microsoft.com/azure/developer/java/fundamentals/java-jdk-install) version 8 or above.
21 | - [Apache Maven](https://maven.apache.org/download.cgi).
22 | - A deployed Communication Services resource and connection string. For details, see [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
23 | - Create an [Azure Email Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/email/create-email-communication-resource) to start sending emails.
24 | - A setup managed identity for a development environment, [see Authorize access with managed identity](https://docs.microsoft.com/azure/communication-services/quickstarts/managed-identity-from-cli).
25 | 
26 | > Note: We can also send an email from our own verified domain [Add custom verified domains to Email Communication Service](https://docs.microsoft.com/azure/communication-services/quickstarts/email/add-custom-verified-domains).
27 | 
28 | ### Prerequisite check
29 | 
30 | - To view the domains verified with your Email Communication Services resource, sign in to the [Azure portal](https://portal.azure.com/). Locate your Email Communication Services resource and open the **Provision domains** tab from the left navigation pane.
31 | 
32 | ## Code Structure
33 | 
34 | - **./sample-name/src/main/java/com/communication/email/App.java:** contains code for sending email.
35 | - **pom.xml:** Project's Project Object Model, or [POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).
36 | 
37 | ## Before running sample code
38 | 
39 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you'd like to clone the sample to.
40 | 2. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
41 | 3. Open **App.java** file to configure the following settings:
42 | 
43 |    - `connectionString`: Replace `<ACS_CONNECTION_STRING>` with the connection string found within the 'Keys' blade of the Azure Communication Service resource.
44 |    - `senderAddress`: Replace `<SENDER_EMAIL_ADDRESS>` with the sender email address obtained from the linked domain resource.
45 |    - `recipientAddress`: Replace `<RECIPIENT_EMAIL_ADDRESS>` with the recipient email address.
46 | 
47 | ## Run the code
48 | 
49 | Run the following commands to build and execute the code.
50 | 
51 | ```powershell
52 | mvn clean compile assembly:single
53 | java -jar .\target\send-email-1.0-SNAPSHOT-jar-with-dependencies.jar
54 | ```
55 | 


--------------------------------------------------------------------------------
/send-email-advanced/send-email-attachments/attachment.pdf:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/send-email-advanced/send-email-attachments/attachment.pdf


--------------------------------------------------------------------------------
/send-email-advanced/send-email-attachments/attachment.txt:
--------------------------------------------------------------------------------
1 | Testing of email attachments.


--------------------------------------------------------------------------------
/send-email-advanced/send-email-attachments/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | 
  3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5 |   <modelVersion>4.0.0</modelVersion>
  6 | 
  7 |   <groupId>com.communication.quickstart</groupId>
  8 |   <artifactId>send-email</artifactId>
  9 |   <version>1.0-SNAPSHOT</version>
 10 | 
 11 |   <name>send-email</name>
 12 |   <!-- FIXME change it to the project's website -->
 13 |   <url>http://www.example.com</url>
 14 | 
 15 |   <properties>
 16 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 17 |     <maven.compiler.source>1.8</maven.compiler.source>
 18 |     <maven.compiler.target>1.8</maven.compiler.target>
 19 |   </properties>
 20 | 
 21 |   <dependencies>
 22 |     <dependency>
 23 |       <groupId>junit</groupId>
 24 |       <artifactId>junit</artifactId>
 25 |       <version>4.11</version>
 26 |       <scope>test</scope>
 27 |     </dependency>
 28 |     <dependency>
 29 |       <groupId>com.azure</groupId>
 30 |       <artifactId>azure-communication-email</artifactId>
 31 |       <version>1.0.0</version>
 32 |     </dependency>
 33 |     <dependency>
 34 |       <groupId>com.azure</groupId>
 35 |       <artifactId>azure-communication-common</artifactId>
 36 |       <version>1.2.0</version>
 37 |     </dependency>
 38 |    
 39 |   </dependencies>
 40 | 
 41 |   <build>
 42 |     <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
 43 |       <plugins>
 44 |         <plugin>
 45 |           <artifactId>maven-assembly-plugin</artifactId>
 46 |           <configuration>
 47 |             <archive>
 48 |               <manifest>
 49 |                 <mainClass>com.communication.email.App</mainClass>
 50 |               </manifest>
 51 |             </archive>
 52 |             <descriptorRefs>
 53 |               <descriptorRef>jar-with-dependencies</descriptorRef>
 54 |             </descriptorRefs>
 55 |           </configuration>
 56 |         </plugin>
 57 |         <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
 58 |         <plugin>
 59 |           <artifactId>maven-clean-plugin</artifactId>
 60 |           <version>3.1.0</version>
 61 |         </plugin>
 62 |         <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
 63 |         <plugin>
 64 |           <artifactId>maven-resources-plugin</artifactId>
 65 |           <version>3.0.2</version>
 66 |         </plugin>
 67 |         <plugin>
 68 |           <artifactId>maven-compiler-plugin</artifactId>
 69 |           <version>3.8.0</version>
 70 |         </plugin>
 71 |         <plugin>
 72 |           <artifactId>maven-surefire-plugin</artifactId>
 73 |           <version>2.22.1</version>
 74 |         </plugin>
 75 |         <plugin>
 76 |           <artifactId>maven-jar-plugin</artifactId>
 77 |           <version>3.0.2</version>
 78 |             <configuration>
 79 |               <archive>
 80 |                 <manifest>
 81 |                   <addClasspath>true</addClasspath>
 82 |                   <mainClass>com.communication.email.App</mainClass>
 83 |                 </manifest>
 84 |               </archive>
 85 |             </configuration>
 86 |         </plugin>
 87 |         <plugin>
 88 |           <artifactId>maven-install-plugin</artifactId>
 89 |           <version>2.5.2</version>
 90 |         </plugin>
 91 |         <plugin>
 92 |           <artifactId>maven-deploy-plugin</artifactId>
 93 |           <version>2.8.2</version>
 94 |         </plugin>
 95 |         <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
 96 |         <plugin>
 97 |           <artifactId>maven-site-plugin</artifactId>
 98 |           <version>3.7.1</version>
 99 |         </plugin>
100 |         <plugin>
101 |           <artifactId>maven-project-info-reports-plugin</artifactId>
102 |           <version>3.0.0</version>
103 |         </plugin>
104 |       </plugins>
105 |     </pluginManagement>
106 |   </build>
107 | </project>
108 | 


--------------------------------------------------------------------------------
/send-email-advanced/send-email-attachments/src/main/java/com/communication/email/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.email;
 2 | import java.time.Duration;
 3 | import java.io.File;  
 4 | 
 5 | import com.azure.communication.email.models.*;
 6 | import com.azure.communication.email.*;
 7 | import com.azure.core.util.BinaryData;
 8 | import com.azure.core.util.polling.SyncPoller;
 9 | import com.azure.core.util.polling.LongRunningOperationStatus;
10 | import com.azure.core.util.polling.PollResponse;
11 | 
12 | 
13 | public class App 
14 | {
15 |     public static final Duration POLLER_WAIT_TIME = Duration.ofSeconds(10);
16 | 
17 |     public static void main( String[] args )
18 |     {
19 |         String connectionString = "<ACS_CONNECTION_STRING>";
20 |         String senderAddress = "<SENDER_EMAIL_ADDRESS>";
21 |         String recipientAddress = "<RECIPIENT_EMAIL_ADDRESS>";
22 | 
23 |         BinaryData pdfAttachmentContent = BinaryData.fromFile(new File("./attachment.pdf").toPath());
24 |         EmailAttachment pdfAttachment = new EmailAttachment(
25 |             "attachment.pdf",
26 |             "application/pdf",
27 |             pdfAttachmentContent
28 |         );
29 | 
30 |         BinaryData txtAttachmentContent = BinaryData.fromFile(new File("./attachment.txt").toPath());
31 |         EmailAttachment txtAttachment = new EmailAttachment(
32 |             "attachment.txt",
33 |             "text/plain",
34 |             txtAttachmentContent
35 |         );
36 | 
37 |         EmailClient client = new EmailClientBuilder()
38 |             .connectionString(connectionString)
39 |             .buildClient();
40 | 
41 |         EmailMessage message = new EmailMessage()
42 |             .setSenderAddress(senderAddress)
43 |             .setToRecipients(recipientAddress)
44 |             .setSubject("Test email from Java Sample")
45 |             .setBodyPlainText("This is plaintext body of test email.")
46 |             .setBodyHtml("<html><h1>This is the html body of test email.</h1></html>")
47 |             .setAttachments(pdfAttachment, txtAttachment);
48 | 
49 |         try
50 |         {
51 |             SyncPoller<EmailSendResult, EmailSendResult> poller = client.beginSend(message, null);
52 | 
53 |             PollResponse<EmailSendResult> pollResponse = null;
54 | 
55 |             Duration timeElapsed = Duration.ofSeconds(0);
56 | 
57 |              while (pollResponse == null
58 |                      || pollResponse.getStatus() == LongRunningOperationStatus.NOT_STARTED
59 |                      || pollResponse.getStatus() == LongRunningOperationStatus.IN_PROGRESS)
60 |              {
61 |                  pollResponse = poller.poll();
62 |                  System.out.println("Email send poller status: " + pollResponse.getStatus());
63 | 
64 |                  Thread.sleep(POLLER_WAIT_TIME.toMillis());
65 |                  timeElapsed = timeElapsed.plus(POLLER_WAIT_TIME);
66 | 
67 |                  if (timeElapsed.compareTo(POLLER_WAIT_TIME.multipliedBy(18)) >= 0)
68 |                  {
69 |                      throw new RuntimeException("Polling timed out.");
70 |                  }
71 |              }
72 | 
73 |              if (poller.getFinalResult().getStatus() == EmailSendStatus.SUCCEEDED)
74 |              {
75 |                  System.out.printf("Successfully sent the email (operation id: %s)", poller.getFinalResult().getId());
76 |              }
77 |              else
78 |              {
79 |                  throw new RuntimeException(poller.getFinalResult().getError().getMessage());
80 |              }
81 |         }
82 |         catch (Exception exception)
83 |         {
84 |             System.out.println(exception.getMessage());
85 |         }
86 |     }
87 | }
88 | 


--------------------------------------------------------------------------------
/send-email-advanced/send-email-inline-attachments/inline-attachment.jpg:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/send-email-advanced/send-email-inline-attachments/inline-attachment.jpg


--------------------------------------------------------------------------------
/send-email-advanced/send-email-inline-attachments/inline-attachment.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/Azure-Samples/communication-services-java-quickstarts/347650175630885e4d877ba32d72cc7f2c1de9d6/send-email-advanced/send-email-inline-attachments/inline-attachment.png


--------------------------------------------------------------------------------
/send-email-advanced/send-email-inline-attachments/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | 
  3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5 |   <modelVersion>4.0.0</modelVersion>
  6 | 
  7 |   <groupId>com.communication.quickstart</groupId>
  8 |   <artifactId>send-email</artifactId>
  9 |   <version>1.0-SNAPSHOT</version>
 10 | 
 11 |   <name>send-email</name>
 12 |   <!-- FIXME change it to the project's website -->
 13 |   <url>http://www.example.com</url>
 14 | 
 15 |   <properties>
 16 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 17 |     <maven.compiler.source>1.8</maven.compiler.source>
 18 |     <maven.compiler.target>1.8</maven.compiler.target>
 19 |   </properties>
 20 | 
 21 |   <dependencies>
 22 |     <dependency>
 23 |       <groupId>junit</groupId>
 24 |       <artifactId>junit</artifactId>
 25 |       <version>4.11</version>
 26 |       <scope>test</scope>
 27 |     </dependency>
 28 |     <dependency>
 29 |       <groupId>com.azure</groupId>
 30 |       <artifactId>azure-communication-email</artifactId>
 31 |       <version>1.1.0-beta.1</version>
 32 |     </dependency>
 33 |     <dependency>
 34 |       <groupId>com.azure</groupId>
 35 |       <artifactId>azure-communication-common</artifactId>
 36 |       <version>1.2.0</version>
 37 |     </dependency>
 38 | 
 39 |   </dependencies>
 40 | 
 41 |   <build>
 42 |     <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
 43 |       <plugins>
 44 |         <plugin>
 45 |           <artifactId>maven-assembly-plugin</artifactId>
 46 |           <configuration>
 47 |             <archive>
 48 |               <manifest>
 49 |                 <mainClass>com.communication.email.App</mainClass>
 50 |               </manifest>
 51 |             </archive>
 52 |             <descriptorRefs>
 53 |               <descriptorRef>jar-with-dependencies</descriptorRef>
 54 |             </descriptorRefs>
 55 |           </configuration>
 56 |         </plugin>
 57 |         <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
 58 |         <plugin>
 59 |           <artifactId>maven-clean-plugin</artifactId>
 60 |           <version>3.1.0</version>
 61 |         </plugin>
 62 |         <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
 63 |         <plugin>
 64 |           <artifactId>maven-resources-plugin</artifactId>
 65 |           <version>3.0.2</version>
 66 |         </plugin>
 67 |         <plugin>
 68 |           <artifactId>maven-compiler-plugin</artifactId>
 69 |           <version>3.8.0</version>
 70 |         </plugin>
 71 |         <plugin>
 72 |           <artifactId>maven-surefire-plugin</artifactId>
 73 |           <version>2.22.1</version>
 74 |         </plugin>
 75 |         <plugin>
 76 |           <artifactId>maven-jar-plugin</artifactId>
 77 |           <version>3.0.2</version>
 78 |             <configuration>
 79 |               <archive>
 80 |                 <manifest>
 81 |                   <addClasspath>true</addClasspath>
 82 |                   <mainClass>com.communication.email.App</mainClass>
 83 |                 </manifest>
 84 |               </archive>
 85 |             </configuration>
 86 |         </plugin>
 87 |         <plugin>
 88 |           <artifactId>maven-install-plugin</artifactId>
 89 |           <version>2.5.2</version>
 90 |         </plugin>
 91 |         <plugin>
 92 |           <artifactId>maven-deploy-plugin</artifactId>
 93 |           <version>2.8.2</version>
 94 |         </plugin>
 95 |         <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
 96 |         <plugin>
 97 |           <artifactId>maven-site-plugin</artifactId>
 98 |           <version>3.7.1</version>
 99 |         </plugin>
100 |         <plugin>
101 |           <artifactId>maven-project-info-reports-plugin</artifactId>
102 |           <version>3.0.0</version>
103 |         </plugin>
104 |       </plugins>
105 |     </pluginManagement>
106 |   </build>
107 | </project>
108 | 


--------------------------------------------------------------------------------
/send-email-advanced/send-email-inline-attachments/src/main/java/com/communication/email/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.email;
 2 | import java.time.Duration;
 3 | import java.util.Base64;
 4 | import java.io.File;
 5 | import java.nio.file.Files;
 6 | 
 7 | import com.azure.communication.email.models.*;
 8 | import com.azure.communication.email.*;
 9 | import com.azure.core.util.BinaryData;
10 | import com.azure.core.util.polling.SyncPoller;
11 | import com.azure.core.util.polling.LongRunningOperationStatus;
12 | import com.azure.core.util.polling.PollResponse;
13 | 
14 | 
15 | public class App
16 | {
17 |     public static final Duration POLLER_WAIT_TIME = Duration.ofSeconds(10);
18 | 
19 |     public static void main( String[] args )
20 |     {
21 |         String connectionString = "<ACS_CONNECTION_STRING>";
22 |         String senderAddress = "<SENDER_EMAIL_ADDRESS>";
23 |         String recipientAddress = "<RECIPIENT_EMAIL_ADDRESS>";
24 | 
25 |         try
26 |         {
27 |             byte[] jpgContent = Files.readAllBytes(new File("./inline-attachment.jpg").toPath());
28 |             byte[] jpgEncodedContent = Base64.getEncoder().encodeToString(jpgContent).getBytes();
29 |             EmailAttachment jpgInlineAttachment = new EmailAttachment(
30 |                 "inline-attachment.jpg",
31 |                 "image/jpeg",
32 |                 BinaryData.fromBytes(jpgEncodedContent)
33 |             ).setContentId("kittens-1");
34 | 
35 |             byte[] pngContent = Files.readAllBytes(new File("./inline-attachment.png").toPath());
36 |             byte[] pngEncodedContent = Base64.getEncoder().encodeToString(pngContent).getBytes();
37 |             EmailAttachment pngInlineAttachment = new EmailAttachment(
38 |                 "inline-attachment.png",
39 |                 "image/png",
40 |                 BinaryData.fromBytes(pngEncodedContent)
41 |             ).setContentId("kittens-2");
42 | 
43 |             EmailClient client = new EmailClientBuilder()
44 |                 .connectionString(connectionString)
45 |                 .buildClient();
46 | 
47 |             EmailMessage message = new EmailMessage()
48 |                 .setSenderAddress(senderAddress)
49 |                 .setToRecipients(recipientAddress)
50 |                 .setSubject("Test email from Java Sample")
51 |                 .setBodyPlainText("This is plaintext body of test email.")
52 |                 .setBodyHtml("<html><h1>HTML body inline images:</h1><img src=\"cid:kittens-1\" /><img src=\"cid:kittens-2\" /></html>")
53 |                 .setAttachments(jpgInlineAttachment, pngInlineAttachment);
54 | 
55 |             SyncPoller<EmailSendResult, EmailSendResult> poller = client.beginSend(message, null);
56 | 
57 |             PollResponse<EmailSendResult> pollResponse = null;
58 | 
59 |             Duration timeElapsed = Duration.ofSeconds(0);
60 | 
61 |              while (pollResponse == null
62 |                      || pollResponse.getStatus() == LongRunningOperationStatus.NOT_STARTED
63 |                      || pollResponse.getStatus() == LongRunningOperationStatus.IN_PROGRESS)
64 |              {
65 |                  pollResponse = poller.poll();
66 |                  System.out.println("Email send poller status: " + pollResponse.getStatus());
67 | 
68 |                  Thread.sleep(POLLER_WAIT_TIME.toMillis());
69 |                  timeElapsed = timeElapsed.plus(POLLER_WAIT_TIME);
70 | 
71 |                  if (timeElapsed.compareTo(POLLER_WAIT_TIME.multipliedBy(18)) >= 0)
72 |                  {
73 |                      throw new RuntimeException("Polling timed out.");
74 |                  }
75 |              }
76 | 
77 |              if (poller.getFinalResult().getStatus() == EmailSendStatus.SUCCEEDED)
78 |              {
79 |                  System.out.printf("Successfully sent the email (operation id: %s)", poller.getFinalResult().getId());
80 |              }
81 |              else
82 |              {
83 |                  throw new RuntimeException(poller.getFinalResult().getError().getMessage());
84 |              }
85 |         }
86 |         catch (Exception exception)
87 |         {
88 |             System.out.println(exception.getMessage());
89 |         }
90 |     }
91 | }
92 | 


--------------------------------------------------------------------------------
/send-email-advanced/send-email-multiple-recipients/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | 
  3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5 |   <modelVersion>4.0.0</modelVersion>
  6 | 
  7 |   <groupId>com.communication.quickstart</groupId>
  8 |   <artifactId>send-email</artifactId>
  9 |   <version>1.0-SNAPSHOT</version>
 10 | 
 11 |   <name>send-email</name>
 12 |   <!-- FIXME change it to the project's website -->
 13 |   <url>http://www.example.com</url>
 14 | 
 15 |   <properties>
 16 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 17 |     <maven.compiler.source>1.8</maven.compiler.source>
 18 |     <maven.compiler.target>1.8</maven.compiler.target>
 19 |   </properties>
 20 | 
 21 |   <dependencies>
 22 |     <dependency>
 23 |       <groupId>junit</groupId>
 24 |       <artifactId>junit</artifactId>
 25 |       <version>4.11</version>
 26 |       <scope>test</scope>
 27 |     </dependency>
 28 |     <dependency>
 29 |       <groupId>com.azure</groupId>
 30 |       <artifactId>azure-communication-email</artifactId>
 31 |       <version>1.0.0</version>
 32 |     </dependency>
 33 |     <dependency>
 34 |       <groupId>com.azure</groupId>
 35 |       <artifactId>azure-communication-common</artifactId>
 36 |       <version>1.2.0</version>
 37 |     </dependency>
 38 |    
 39 |   </dependencies>
 40 | 
 41 |   <build>
 42 |     <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
 43 |       <plugins>
 44 |         <plugin>
 45 |           <artifactId>maven-assembly-plugin</artifactId>
 46 |           <configuration>
 47 |             <archive>
 48 |               <manifest>
 49 |                 <mainClass>com.communication.email.App</mainClass>
 50 |               </manifest>
 51 |             </archive>
 52 |             <descriptorRefs>
 53 |               <descriptorRef>jar-with-dependencies</descriptorRef>
 54 |             </descriptorRefs>
 55 |           </configuration>
 56 |         </plugin>
 57 |         <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
 58 |         <plugin>
 59 |           <artifactId>maven-clean-plugin</artifactId>
 60 |           <version>3.1.0</version>
 61 |         </plugin>
 62 |         <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
 63 |         <plugin>
 64 |           <artifactId>maven-resources-plugin</artifactId>
 65 |           <version>3.0.2</version>
 66 |         </plugin>
 67 |         <plugin>
 68 |           <artifactId>maven-compiler-plugin</artifactId>
 69 |           <version>3.8.0</version>
 70 |         </plugin>
 71 |         <plugin>
 72 |           <artifactId>maven-surefire-plugin</artifactId>
 73 |           <version>2.22.1</version>
 74 |         </plugin>
 75 |         <plugin>
 76 |           <artifactId>maven-jar-plugin</artifactId>
 77 |           <version>3.0.2</version>
 78 |             <configuration>
 79 |               <archive>
 80 |                 <manifest>
 81 |                   <addClasspath>true</addClasspath>
 82 |                   <mainClass>com.communication.email.App</mainClass>
 83 |                 </manifest>
 84 |               </archive>
 85 |             </configuration>
 86 |         </plugin>
 87 |         <plugin>
 88 |           <artifactId>maven-install-plugin</artifactId>
 89 |           <version>2.5.2</version>
 90 |         </plugin>
 91 |         <plugin>
 92 |           <artifactId>maven-deploy-plugin</artifactId>
 93 |           <version>2.8.2</version>
 94 |         </plugin>
 95 |         <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
 96 |         <plugin>
 97 |           <artifactId>maven-site-plugin</artifactId>
 98 |           <version>3.7.1</version>
 99 |         </plugin>
100 |         <plugin>
101 |           <artifactId>maven-project-info-reports-plugin</artifactId>
102 |           <version>3.0.0</version>
103 |         </plugin>
104 |       </plugins>
105 |     </pluginManagement>
106 |   </build>
107 | </project>
108 | 


--------------------------------------------------------------------------------
/send-email-advanced/send-email-multiple-recipients/src/main/java/com/communication/email/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.email;
 2 | import java.time.Duration;
 3 | 
 4 | import com.azure.communication.email.EmailClientBuilder;
 5 | import com.azure.communication.email.EmailClient;
 6 | import com.azure.communication.email.models.EmailSendResult;
 7 | import com.azure.communication.email.models.EmailSendStatus;
 8 | import com.azure.communication.email.models.EmailMessage;
 9 | import com.azure.core.util.polling.SyncPoller;
10 | import com.azure.core.util.polling.LongRunningOperationStatus;
11 | import com.azure.core.util.polling.PollResponse;
12 | 
13 | 
14 | public class App 
15 | {
16 |     public static final Duration POLLER_WAIT_TIME = Duration.ofSeconds(10);
17 | 
18 |     public static void main( String[] args )
19 |     {
20 |         String connectionString = "<ACS_CONNECTION_STRING>";
21 |         String senderAddress = "<SENDER_EMAIL_ADDRESS>";
22 |         String recipientAddress = "<RECIPIENT_EMAIL_ADDRESS>";
23 |         String replyToAddress = "<REPLYTO_EMAIL_ADDRESS>";
24 | 
25 |         EmailClient client = new EmailClientBuilder()
26 |             .connectionString(connectionString)
27 |             .buildClient();
28 | 
29 |         EmailMessage message = new EmailMessage()
30 |             .setSenderAddress(senderAddress)
31 |             .setToRecipients(recipientAddress, recipientAddress)
32 |             .setCcRecipients(recipientAddress)
33 |             .setBccRecipients(recipientAddress)
34 |             .setReplyTo(replyToAddress)
35 |             .setSubject("Test email from Java Sample")
36 |             .setBodyPlainText("This is plaintext body of test email.")
37 |             .setBodyHtml("<html><h1>This is the html body of test email.</h1></html>");
38 | 
39 |         try
40 |         {
41 |             SyncPoller<EmailSendResult, EmailSendResult> poller = client.beginSend(message, null);
42 | 
43 |             PollResponse<EmailSendResult> pollResponse = null;
44 | 
45 |             Duration timeElapsed = Duration.ofSeconds(0);
46 | 
47 |              while (pollResponse == null
48 |                      || pollResponse.getStatus() == LongRunningOperationStatus.NOT_STARTED
49 |                      || pollResponse.getStatus() == LongRunningOperationStatus.IN_PROGRESS)
50 |              {
51 |                  pollResponse = poller.poll();
52 |                  System.out.println("Email send poller status: " + pollResponse.getStatus());
53 | 
54 |                  Thread.sleep(POLLER_WAIT_TIME.toMillis());
55 |                  timeElapsed = timeElapsed.plus(POLLER_WAIT_TIME);
56 | 
57 |                  if (timeElapsed.compareTo(POLLER_WAIT_TIME.multipliedBy(18)) >= 0)
58 |                  {
59 |                      throw new RuntimeException("Polling timed out.");
60 |                  }
61 |              }
62 | 
63 |              if (poller.getFinalResult().getStatus() == EmailSendStatus.SUCCEEDED)
64 |              {
65 |                  System.out.printf("Successfully sent the email (operation id: %s)", poller.getFinalResult().getId());
66 |              }
67 |              else
68 |              {
69 |                  throw new RuntimeException(poller.getFinalResult().getError().getMessage());
70 |              }
71 |         }
72 |         catch (Exception exception)
73 |         {
74 |             System.out.println(exception.getMessage());
75 |         }
76 |     }
77 | }
78 | 


--------------------------------------------------------------------------------
/send-email/README.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - Java
 5 | products:
 6 | - azure
 7 | - azure-communication-email
 8 | ---
 9 | 
10 | 
11 | # Email Sample
12 | 
13 | This sample sends an email to the selected recipients of any domain using an [Email Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/email/create-email-communication-resource).
14 | 
15 | Additional documentation for this sample can be found on [Microsoft Docs](https://docs.microsoft.com/azure/communication-services/concepts/email/email-overview).
16 | 
17 | ## Prerequisites
18 | 
19 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
20 | - [Java Development Kit (JDK)](https://docs.microsoft.com/azure/developer/java/fundamentals/java-jdk-install) version 8 or above.
21 | - [Apache Maven](https://maven.apache.org/download.cgi).
22 | - A deployed Communication Services resource and connection string. For details, see [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
23 | - Create an [Azure Email Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/email/create-email-communication-resource) to start sending emails.
24 | - A setup managed identity for a development environment, [see Authorize access with managed identity](https://docs.microsoft.com/azure/communication-services/quickstarts/managed-identity-from-cli).
25 | 
26 | > Note: We can also send an email from our own verified domain [Add custom verified domains to Email Communication Service](https://docs.microsoft.com/azure/communication-services/quickstarts/email/add-custom-verified-domains).
27 | 
28 | ### Prerequisite check
29 | 
30 | - To view the domains verified with your Email Communication Services resource, sign in to the [Azure portal](https://portal.azure.com/). Locate your Email Communication Services resource and open the **Provision domains** tab from the left navigation pane.
31 | 
32 | ## Code Structure
33 | 
34 | - **./send-email/src/main/java/com/communication/email/App.java:** contains code for sending email.
35 | - **pom.xml:** Project's Project Object Model, or [POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).
36 | 
37 | ## Before running sample code
38 | 
39 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you'd like to clone the sample to.
40 | 2. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
41 | 3. Open **App.java** file to configure the following settings:
42 | 
43 |    - `connectionString`: Replace `<ACS_CONNECTION_STRING>` with the connection string found within the 'Keys' blade of the Azure Communication Service resource.
44 |    - `senderAddress`: Replace `<SENDER_EMAIL_ADDRESS>` with the sender email address obtained from the linked domain resource.
45 |    - `recipientAddress`: Replace `<RECIPIENT_EMAIL_ADDRESS>` with the recipient email address.
46 | 
47 | ## Run the code
48 | 
49 | Run the following commands to build and execute the code.
50 | 
51 | ```powershell
52 | mvn clean compile assembly:single
53 | java -jar .\target\send-email-1.0-SNAPSHOT-jar-with-dependencies.jar
54 | ```
55 | 


--------------------------------------------------------------------------------
/send-email/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | 
  3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5 |   <modelVersion>4.0.0</modelVersion>
  6 | 
  7 |   <groupId>com.communication.quickstart</groupId>
  8 |   <artifactId>send-email</artifactId>
  9 |   <version>1.0-SNAPSHOT</version>
 10 | 
 11 |   <name>send-email</name>
 12 |   <!-- FIXME change it to the project's website -->
 13 |   <url>http://www.example.com</url>
 14 | 
 15 |   <properties>
 16 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 17 |     <maven.compiler.source>1.8</maven.compiler.source>
 18 |     <maven.compiler.target>1.8</maven.compiler.target>
 19 |   </properties>
 20 | 
 21 |   <dependencies>
 22 |     <dependency>
 23 |       <groupId>junit</groupId>
 24 |       <artifactId>junit</artifactId>
 25 |       <version>4.11</version>
 26 |       <scope>test</scope>
 27 |     </dependency>
 28 |     <dependency>
 29 |       <groupId>com.azure</groupId>
 30 |       <artifactId>azure-communication-email</artifactId>
 31 |       <version>1.0.0</version>
 32 |     </dependency>
 33 |     <dependency>
 34 |       <groupId>com.azure</groupId>
 35 |       <artifactId>azure-communication-common</artifactId>
 36 |       <version>1.2.0</version>
 37 |     </dependency>
 38 |    
 39 |   </dependencies>
 40 | 
 41 |   <build>
 42 |     <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
 43 |       <plugins>
 44 |         <plugin>
 45 |           <artifactId>maven-assembly-plugin</artifactId>
 46 |           <configuration>
 47 |             <archive>
 48 |               <manifest>
 49 |                 <mainClass>com.communication.email.App</mainClass>
 50 |               </manifest>
 51 |             </archive>
 52 |             <descriptorRefs>
 53 |               <descriptorRef>jar-with-dependencies</descriptorRef>
 54 |             </descriptorRefs>
 55 |           </configuration>
 56 |         </plugin>
 57 |         <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
 58 |         <plugin>
 59 |           <artifactId>maven-clean-plugin</artifactId>
 60 |           <version>3.1.0</version>
 61 |         </plugin>
 62 |         <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
 63 |         <plugin>
 64 |           <artifactId>maven-resources-plugin</artifactId>
 65 |           <version>3.0.2</version>
 66 |         </plugin>
 67 |         <plugin>
 68 |           <artifactId>maven-compiler-plugin</artifactId>
 69 |           <version>3.8.0</version>
 70 |         </plugin>
 71 |         <plugin>
 72 |           <artifactId>maven-surefire-plugin</artifactId>
 73 |           <version>2.22.1</version>
 74 |         </plugin>
 75 |         <plugin>
 76 |           <artifactId>maven-jar-plugin</artifactId>
 77 |           <version>3.0.2</version>
 78 |             <configuration>
 79 |               <archive>
 80 |                 <manifest>
 81 |                   <addClasspath>true</addClasspath>
 82 |                   <mainClass>com.communication.email.App</mainClass>
 83 |                 </manifest>
 84 |               </archive>
 85 |             </configuration>
 86 |         </plugin>
 87 |         <plugin>
 88 |           <artifactId>maven-install-plugin</artifactId>
 89 |           <version>2.5.2</version>
 90 |         </plugin>
 91 |         <plugin>
 92 |           <artifactId>maven-deploy-plugin</artifactId>
 93 |           <version>2.8.2</version>
 94 |         </plugin>
 95 |         <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
 96 |         <plugin>
 97 |           <artifactId>maven-site-plugin</artifactId>
 98 |           <version>3.7.1</version>
 99 |         </plugin>
100 |         <plugin>
101 |           <artifactId>maven-project-info-reports-plugin</artifactId>
102 |           <version>3.0.0</version>
103 |         </plugin>
104 |       </plugins>
105 |     </pluginManagement>
106 |   </build>
107 | </project>
108 | 


--------------------------------------------------------------------------------
/send-email/src/main/java/com/communication/email/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.email;
 2 | import java.time.Duration;
 3 | 
 4 | import com.azure.communication.email.EmailClientBuilder;
 5 | import com.azure.communication.email.EmailClient;
 6 | import com.azure.communication.email.models.EmailSendResult;
 7 | import com.azure.communication.email.models.EmailSendStatus;
 8 | import com.azure.communication.email.models.EmailMessage;
 9 | import com.azure.core.util.polling.SyncPoller;
10 | import com.azure.core.util.polling.LongRunningOperationStatus;
11 | import com.azure.core.util.polling.PollResponse;
12 | 
13 | 
14 | public class App 
15 | {
16 |     public static final Duration POLLER_WAIT_TIME = Duration.ofSeconds(10);
17 | 
18 |     public static void main( String[] args )
19 |     {
20 |         String connectionString = "<ACS_CONNECTION_STRING>";
21 |         String senderAddress = "<SENDER_EMAIL_ADDRESS>";
22 |         String recipientAddress = "<RECIPIENT_EMAIL_ADDRESS>";
23 | 
24 |         EmailClient client = new EmailClientBuilder()
25 |             .connectionString(connectionString)
26 |             .buildClient();
27 | 
28 |         EmailMessage message = new EmailMessage()
29 |             .setSenderAddress(senderAddress)
30 |             .setToRecipients(recipientAddress)
31 |             .setSubject("Test email from Java Sample")
32 |             .setBodyPlainText("This is plaintext body of test email.")
33 |             .setBodyHtml("<html><h1>This is the html body of test email.</h1></html>");
34 | 
35 |         try
36 |         {
37 |             SyncPoller<EmailSendResult, EmailSendResult> poller = client.beginSend(message, null);
38 | 
39 |             PollResponse<EmailSendResult> pollResponse = null;
40 | 
41 |             Duration timeElapsed = Duration.ofSeconds(0);
42 | 
43 |              while (pollResponse == null
44 |                      || pollResponse.getStatus() == LongRunningOperationStatus.NOT_STARTED
45 |                      || pollResponse.getStatus() == LongRunningOperationStatus.IN_PROGRESS)
46 |              {
47 |                  pollResponse = poller.poll();
48 |                  System.out.println("Email send poller status: " + pollResponse.getStatus());
49 | 
50 |                  Thread.sleep(POLLER_WAIT_TIME.toMillis());
51 |                  timeElapsed = timeElapsed.plus(POLLER_WAIT_TIME);
52 | 
53 |                  if (timeElapsed.compareTo(POLLER_WAIT_TIME.multipliedBy(18)) >= 0)
54 |                  {
55 |                      throw new RuntimeException("Polling timed out.");
56 |                  }
57 |              }
58 | 
59 |              if (poller.getFinalResult().getStatus() == EmailSendStatus.SUCCEEDED)
60 |              {
61 |                  System.out.printf("Successfully sent the email (operation id: %s)", poller.getFinalResult().getId());
62 |              }
63 |              else
64 |              {
65 |                  throw new RuntimeException(poller.getFinalResult().getError().getMessage());
66 |              }
67 |         }
68 |         catch (Exception exception)
69 |         {
70 |             System.out.println(exception.getMessage());
71 |         }
72 |     }
73 | }
74 | 


--------------------------------------------------------------------------------
/send-sms-quickstart/README.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - Java
 5 | products:
 6 | - azure
 7 | - azure-communication-sms
 8 | ---
 9 | 
10 | 
11 | # Send an SMS message
12 | 
13 | For full instructions on how to build this code sample from scratch, see [Quickstart: Send an SMS message](https://docs.microsoft.com/azure/communication-services/quickstarts/telephony-sms/send?pivots=programming-language-java).
14 | 
15 | ## Prerequisites
16 | 
17 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
18 | - [Java Development Kit (JDK)](https://docs.microsoft.com/azure/developer/java/fundamentals/java-jdk-install) version 8 or above.
19 | - [Apache Maven](https://maven.apache.org/download.cgi).
20 | - An deployed Communication Services resource and connection string. For details, see [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
21 | - An SMS enabled telephone number [Get a phone number](https://docs.microsoft.com/azure/communication-services/quickstarts/telephony-sms/get-phone-number?pivots=programming-language-java).
22 | - A setup managed identity for a development environment, [see Authorize access with managed identity](https://docs.microsoft.com/azure/communication-services/quickstarts/managed-identity-from-cli).
23 | ## Code Structure
24 | 
25 | - **./send-sms-quickstart/src/main/java/com/communication/quickstart/App.java:** contains code for sending SMS messages.
26 | - **pom.xml:** Project's Project Object Model, or [POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).
27 | 
28 | ## Before running sample code
29 | 
30 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you'd like to clone the sample to.
31 | 2. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
32 | 3. With the Communication Services procured in pre-requisites, add connection string in the code at line no 24
33 |     ```String connectionString = "ACS_Connection_String";```.
34 | 4.  With the SMS enabled telephone number procured in pre-requisites, add it to the **App.java** file. Assign your ACS telephone number and sender numbers at line 46 and 47.
35 | 
36 | ## Run the code
37 | 
38 | 1. Navigate to the directory containing the pom.xml file and compile the project by using command `mvn compile`.
39 | 2. Build the package using command `mvn package`.
40 | 3. Run the command to execute the app `mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false`.
41 | 


--------------------------------------------------------------------------------
/send-sms-quickstart/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | 
 3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |   <modelVersion>4.0.0</modelVersion>
 6 | 
 7 |   <groupId>com.communication.quickstart</groupId>
 8 |   <artifactId>communication-quickstart</artifactId>
 9 |   <version>1.0-SNAPSHOT</version>
10 | 
11 |   <name>communication-quickstart</name>
12 |   <!-- FIXME change it to the project's website -->
13 |   <url>http://www.example.com</url>
14 | 
15 |   <properties>
16 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
17 |     <maven.compiler.source>1.7</maven.compiler.source>
18 |     <maven.compiler.target>1.7</maven.compiler.target>
19 |   </properties>
20 | 
21 |   <dependencies>
22 |     <dependency>
23 |       <groupId>junit</groupId>
24 |       <artifactId>junit</artifactId>
25 |       <version>4.11</version>
26 |       <scope>test</scope>
27 |     </dependency>
28 | 	<dependency>
29 |     <groupId>com.azure</groupId>
30 |     <artifactId>azure-communication-sms</artifactId>
31 |     <version>1.0.3</version>
32 | 	</dependency>
33 | 	<dependency>
34 | 		<groupId>com.azure</groupId>
35 | 		<artifactId>azure-core-http-netty</artifactId>
36 | 		<version>1.10.1</version>
37 | 	</dependency>
38 |     <dependency>
39 |     <groupId>com.azure</groupId>
40 |     <artifactId>azure-core</artifactId>
41 |     <version>1.19.0</version> <!-- {x-version-update;com.azure:azure-core;dependency} -->
42 | 	</dependency>
43 |   </dependencies>
44 | 
45 |   <build>
46 |     <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
47 |       <plugins>
48 |         <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
49 |         <plugin>
50 |           <artifactId>maven-clean-plugin</artifactId>
51 |           <version>3.1.0</version>
52 |         </plugin>
53 |         <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
54 |         <plugin>
55 |           <artifactId>maven-resources-plugin</artifactId>
56 |           <version>3.0.2</version>
57 |         </plugin>
58 |         <plugin>
59 |           <artifactId>maven-compiler-plugin</artifactId>
60 |           <version>3.8.0</version>
61 |         </plugin>
62 |         <plugin>
63 |           <artifactId>maven-surefire-plugin</artifactId>
64 |           <version>2.22.1</version>
65 |         </plugin>
66 |         <plugin>
67 |           <artifactId>maven-jar-plugin</artifactId>
68 |           <version>3.0.2</version>
69 |         </plugin>
70 |         <plugin>
71 |           <artifactId>maven-install-plugin</artifactId>
72 |           <version>2.5.2</version>
73 |         </plugin>
74 |         <plugin>
75 |           <artifactId>maven-deploy-plugin</artifactId>
76 |           <version>2.8.2</version>
77 |         </plugin>
78 |         <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
79 |         <plugin>
80 |           <artifactId>maven-site-plugin</artifactId>
81 |           <version>3.7.1</version>
82 |         </plugin>
83 |         <plugin>
84 |           <artifactId>maven-project-info-reports-plugin</artifactId>
85 |           <version>3.0.0</version>
86 |         </plugin>
87 |       </plugins>
88 |     </pluginManagement>
89 |   </build>
90 | </project>
91 | 


--------------------------------------------------------------------------------
/send-sms-quickstart/src/main/java/com/communication/quickstart/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.quickstart;
 2 | 
 3 | import com.azure.communication.sms.models.*;
 4 | import com.azure.core.credential.AzureKeyCredential;
 5 | import com.azure.communication.sms.*;
 6 | import com.azure.core.util.Context;
 7 | import java.util.Arrays;
 8 | 
 9 | public class App
10 | {
11 |     public static void main( String[] args )
12 |     {
13 |         // Quickstart code goes here
14 | 		// You can find your endpoint and access key from your resource in the Azure portal
15 | 		//String endpoint = "https://<resource-name>.communication.azure.com/";
16 | 		//AzureKeyCredential azureKeyCredential = new AzureKeyCredential("<access-key-credential>");
17 | 
18 | 		//SmsClient smsClient = new SmsClientBuilder()
19 | 						//.endpoint(endpoint)
20 | 						//.credential(azureKeyCredential)
21 | 						//.buildClient();
22 | 
23 | 		// You can find your connection string from your resource in the Azure portal
24 | 		String connectionString = "ACS_Connection_String";
25 | 
26 | 		SmsClient smsClient = new SmsClientBuilder()
27 | 					.connectionString(connectionString)
28 | 					.buildClient();		
29 | 
30 | 		//Send a 1:1 SMS message
31 | 		//SmsSendResult sendResult = smsClient.send(
32 | 		//				"<from-phone-number>",
33 | 		//				"<to-phone-number>",
34 | 		//				"Weekly Promotion");
35 | 
36 | 		//System.out.println("Message Id: " + sendResult.getMessageId());
37 | 		//System.out.println("Recipient Number: " + sendResult.getTo());
38 | 		//System.out.println("Send Result Successful:" + sendResult.isSuccessful());
39 | 
40 | 		//Send a 1:N SMS message with options
41 | 		SmsSendOptions options = new SmsSendOptions();
42 | 		options.setDeliveryReportEnabled(true);
43 | 		options.setTag("Marketing");
44 | 
45 | 		Iterable<SmsSendResult> sendResults = smsClient.sendWithResponse(
46 | 			"<from-phone-number>",
47 | 			Arrays.asList("<to-phone-number1>", "<to-phone-number2>"),
48 | 			"Weekly Promotion",
49 | 			options /* Optional */,
50 | 			Context.NONE).getValue();
51 | 
52 | 		for (SmsSendResult result : sendResults) {
53 | 			System.out.println("Message Id: " + result.getMessageId());
54 | 			System.out.println("Recipient Number: " + result.getTo());
55 | 			System.out.println("Send Result Successful:" + result.isSuccessful());
56 | 		}		
57 |     }
58 | }


--------------------------------------------------------------------------------
/use-managed-Identity/README.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | page_type: sample
 3 | languages:
 4 | - Java
 5 | products:
 6 | - azure
 7 | - azure-communication-services
 8 | ---
 9 | 
10 | 
11 | # Create and manage access tokens
12 | 
13 | For full instructions on how to build this code sample from scratch, look at [Quickstart: Create and manage access tokens](https://docs.microsoft.com/azure/communication-services/quickstarts/access-tokens?pivots=programming-language-java)
14 | 
15 | ## Prerequisites
16 | 
17 | - An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F). 
18 | - [Java Development Kit (JDK)](https://docs.microsoft.com/azure/developer/java/fundamentals/java-jdk-install) version 8 or above.
19 | - [Apache Maven](https://maven.apache.org/download.cgi).
20 | - A deployed Communication Services resource and connection string. For details, see [Create a Communication Services resource](https://docs.microsoft.com/azure/communication-services/quickstarts/create-communication-resource).
21 | - To send an SMS you will need a [Phone Number](https://docs.microsoft.com/azure/communication-services/quickstarts/telephony-sms/get-phone-number?pivots=programming-language-java).
22 | - A setup managed identity for a development environment, [see Authorize access with managed identity](https://docs.microsoft.com/azure/communication-services/quickstarts/managed-identity-from-cli).
23 | ## Code Structure
24 | 
25 | - **./use-managed-Identity/src/main/java/com/communication/quickstart/App.java:** contains code for creating and managing access tokens and sending sms.
26 | - **pom.xml:** Project's Project Object Model, or [POM](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).
27 | 
28 | ## Before running sample code
29 | 
30 | 1. Open an instance of PowerShell, Windows Terminal, Command Prompt or equivalent and navigate to the directory that you'd like to clone the sample to.
31 | 2. `git clone https://github.com/Azure-Samples/communication-services-java-quickstarts.git`
32 | 3.  With the Communication Services procured in pre-requisites, add endpoint to the **app.Java** file in the code at line no 41 
33 | ```String endpoint = "https://<RESOURCE_NAME>.communication.azure.com/";```.
34 | 4.  With the SMS enabled telephone number procured in pre-requisites, add it to the **app.Java** file. Assign your ACS telephone number and sender no in line 49 
35 | ```SmsSendResult result = instance.sendSms(endpoint, "<FROM NUMBER>", "<TO NUMBER>", "Hello from Managed Identities");```.
36 | 
37 | ## Run the code
38 | 
39 | 1. Navigate to the directory containing the pom.xml file and compile the project by using command `mvn compile`.
40 | 2. Build the package using command `mvn package`.
41 | 3. Run the command to execute the app `mvn exec:java -Dexec.mainClass="com.communication.quickstart.App" -Dexec.cleanupDaemonThreads=false`.
42 | 


--------------------------------------------------------------------------------
/use-managed-Identity/pom.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | 
 3 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 5 |   <modelVersion>4.0.0</modelVersion>
 6 | 
 7 |   <groupId>com.communication.quickstart</groupId>
 8 |   <artifactId>communication-quickstart</artifactId>
 9 |   <version>1.0-SNAPSHOT</version>
10 | 
11 |   <name>communication-quickstart</name>
12 |   <!-- FIXME change it to the project's website -->
13 |   <url>http://www.example.com</url>
14 | 
15 |   <properties>
16 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
17 |     <maven.compiler.source>1.7</maven.compiler.source>
18 |     <maven.compiler.target>1.7</maven.compiler.target>
19 |   </properties>
20 | 
21 |   <dependencies>
22 |     <dependency>
23 |       <groupId>junit</groupId>
24 |       <artifactId>junit</artifactId>
25 |       <version>4.11</version>
26 |       <scope>test</scope>
27 |     </dependency>
28 | 	<dependency>
29 | 		<groupId>com.azure</groupId>
30 | 		<artifactId>azure-communication-identity</artifactId>
31 | 		<version>1.1.1</version>
32 | 	</dependency>
33 | 	<dependency>
34 | 		<groupId>com.azure</groupId>
35 | 		<artifactId>azure-communication-sms</artifactId>
36 | 		<version>1.0.3</version>
37 | 	</dependency>
38 | 	<dependency>
39 | 		<groupId>com.azure</groupId>
40 | 		<artifactId>azure-identity</artifactId>
41 | 		<version>1.3.5</version>
42 | 	</dependency>	
43 |   </dependencies>
44 | 
45 |   <build>
46 |     <pluginManagement><!-- lock down plugins versions to avoid using Maven defaults (may be moved to parent pom) -->
47 |       <plugins>
48 |         <!-- clean lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#clean_Lifecycle -->
49 |         <plugin>
50 |           <artifactId>maven-clean-plugin</artifactId>
51 |           <version>3.1.0</version>
52 |         </plugin>
53 |         <!-- default lifecycle, jar packaging: see https://maven.apache.org/ref/current/maven-core/default-bindings.html#Plugin_bindings_for_jar_packaging -->
54 |         <plugin>
55 |           <artifactId>maven-resources-plugin</artifactId>
56 |           <version>3.0.2</version>
57 |         </plugin>
58 |         <plugin>
59 |           <artifactId>maven-compiler-plugin</artifactId>
60 |           <version>3.8.0</version>
61 |         </plugin>
62 |         <plugin>
63 |           <artifactId>maven-surefire-plugin</artifactId>
64 |           <version>2.22.1</version>
65 |         </plugin>
66 |         <plugin>
67 |           <artifactId>maven-jar-plugin</artifactId>
68 |           <version>3.0.2</version>
69 |         </plugin>
70 |         <plugin>
71 |           <artifactId>maven-install-plugin</artifactId>
72 |           <version>2.5.2</version>
73 |         </plugin>
74 |         <plugin>
75 |           <artifactId>maven-deploy-plugin</artifactId>
76 |           <version>2.8.2</version>
77 |         </plugin>
78 |         <!-- site lifecycle, see https://maven.apache.org/ref/current/maven-core/lifecycles.html#site_Lifecycle -->
79 |         <plugin>
80 |           <artifactId>maven-site-plugin</artifactId>
81 |           <version>3.7.1</version>
82 |         </plugin>
83 |         <plugin>
84 |           <artifactId>maven-project-info-reports-plugin</artifactId>
85 |           <version>3.0.0</version>
86 |         </plugin>
87 |       </plugins>
88 |     </pluginManagement>
89 |   </build>
90 | </project>
91 | 


--------------------------------------------------------------------------------
/use-managed-Identity/src/main/java/com/communication/quickstart/App.java:
--------------------------------------------------------------------------------
 1 | package com.communication.quickstart;
 2 | 
 3 | import com.azure.communication.common.*;
 4 | import com.azure.communication.identity.*;
 5 | import com.azure.communication.identity.models.*;
 6 | import com.azure.communication.sms.*;
 7 | import com.azure.communication.sms.models.*;
 8 | import com.azure.core.credential.*;
 9 | import com.azure.identity.*;
10 | 
11 | import java.util.*;
12 | 
13 | public class App 
14 | {
15 | 
16 |     private TokenCredential credential = new DefaultAzureCredentialBuilder().build();
17 | 
18 |     public SmsSendResult sendSms(String endpoint, String from, String to, String message) {
19 |           SmsClient smsClient = new SmsClientBuilder()
20 |                .endpoint(endpoint)
21 |                .credential(this.credential)
22 |                .buildClient();
23 | 
24 |           // Send the message and check the response for a message id
25 |           return smsClient.send(from, to, message);
26 |     }
27 |     public AccessToken createIdentityAndGetTokenAsync(String endpoint) {
28 |           CommunicationIdentityClient communicationIdentityClient = new CommunicationIdentityClientBuilder()
29 |                     .endpoint(endpoint)
30 |                     .credential(this.credential)
31 |                     .buildClient();
32 | 
33 |           CommunicationUserIdentifier user = communicationIdentityClient.createUser();
34 |           return communicationIdentityClient.getToken(user, new ArrayList<>(Arrays.asList(CommunicationTokenScope.CHAT)));
35 |     }
36 | 
37 |     public static void main(String[] args) {
38 |           App instance = new App();
39 |           // You can find your endpoint and access key from your resource in the Azure portal
40 |           // e.g. "https://<RESOURCE_NAME>.communication.azure.com";
41 |           String endpoint = "https://<RESOURCE_NAME>.communication.azure.com/";
42 | 
43 |           System.out.println("Retrieving new Access Token, using Managed Identities");
44 |           AccessToken token = instance.createIdentityAndGetTokenAsync(endpoint);
45 |           System.out.println("Retrieved Access Token: "+ token.getToken());
46 | 
47 |           System.out.println("Sending SMS using Managed Identities");
48 |           // You will need a phone number from your resource to send an SMS.
49 |           SmsSendResult result = instance.sendSms(endpoint, "<FROM NUMBER>", "<TO NUMBER>", "Hello from Managed Identities");
50 |           System.out.println("Sms id: "+ result.getMessageId());
51 |           System.out.println("Send Result Successful: "+ result.isSuccessful());
52 |     }
53 | }


--------------------------------------------------------------------------------