You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/communication-services/concepts/voice-video-calling/call-automation.md
+10-5Lines changed: 10 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -61,7 +61,12 @@ The following list presents the set of features that are currently available in
61
61
62
62
Call Automation uses a REST API interface to receive requests and provide responses to all actions performed within the service. Due to the asynchronous nature of calling, most actions will have corresponding events that are triggered when the action completes successfully or fails.
63
63
64
-
Event Grid – Azure Communication Services uses Event Grid to deliver the IncomingCall event that can be triggered by an inbound PSTN call to a number you've acquired in the portal or by connecting your telephony infrastructure using an SBC. The IncomingCall event is also sent for any call between Azure Communication Services users (one-to-one), when a user is added to an existing call (group call) or an existing 1:1 call is transferred to a communication user.
64
+
Event Grid – Azure Communication Services uses Event Grid to deliver the IncomingCall event. This event can be triggered:
65
+
- by an inbound PSTN call to a number you've acquired in the portal,
66
+
- by connecting your telephony infrastructure using an SBC,
67
+
- for one-on-one calls between Communication Service users,
68
+
- when a Communication Services user is added to an existing call (group call),
69
+
- an existing 1:1 call is transferred to a Communication Service user.
65
70
66
71
Web hooks – Calling Automation SDKs use standard web hook HTTP/S callbacks for call state change events and responses to mid-call actions.
67
72
@@ -74,21 +79,21 @@ Web hooks – Calling Automation SDKs use standard web hook HTTP/S callbacks for
74
79
75
80
These actions are performed before the destination endpoint listed in the IncomingCall event notification is connected. Web hook callback events only communicate the “answer” pre-call action, not for reject or redirect actions.
76
81
77
-
**Answer** – Using the IncomingCall event from Event Grid and Call Automation SDK, a call can be answered by your application. This action allows for IVR scenarios where an inbound PSTN call can be answered programmatically by your application. Other scenarios include answering a call on behalf of a user or answering an outbound call sent to a PSTN number in the same Azure Communication Services resource.
82
+
**Answer** – Using the IncomingCall event from Event Grid and Call Automation SDK, a call can be answered by your application. This action allows for IVR scenarios where an inbound PSTN call can be answered programmatically by your application. Other scenarios include answering a call on behalf of a user, or answering an outbound call to a phone number in the same Azure Communication Services resource.
78
83
79
84
**Reject** – To reject a call means your application can receive the IncomingCall event and prevent the call from being connected to the destination endpoint.
80
85
81
-
**Redirect** – Using the IncomingCall event from Event Grid, a call can be redirected to one or more endpoints creating a single or simultaneous ringing (sim-ring) scenario. This means the call is not answered by your application, it is simply ‘redirected’ to another destination endpoint to be answered.
86
+
**Redirect** – Using the IncomingCall event from Event Grid, a call can be redirected to one or more endpoints creating a single or simultaneous ringing (sim-ring) scenario. Redirect means it isn't answered by your application, it's simply ‘redirected’ to another destination endpoint to be answered.
82
87
83
88
**Make Call** - Make Call action can be used to place outbound calls to phone numbers and to other communication users. Use cases include your application placing outbound calls to proactively inform users about an outage or notify about an order update.
84
89
85
90
### Mid-call actions
86
91
87
-
These actions can be performed if Calling Automation SDKs were used to answer an inbound call or place an outbound call. Each mid-call action has a corresponding success or failure web hook callback event.
92
+
These actions can be performed on the calls that are answered or placed using Call Automation SDKs. Each mid-call action has a corresponding success or failure web hook callback event.
88
93
89
94
**Add/Remove participant(s)** – One or more participants can be added in a single request with each participant being a variation of supported destination endpoints. A web hook callback is sent for every participant successfully added to the call.
90
95
91
-
**Play** - When your application answers a call or places an outbound call it can, you can play an audio prompt for the caller, this can be looped if needed in scenarios like playing hold music. To learn more, view our [quickstart](../../quickstarts/voice-video-calling/Play-Action.md)
96
+
**Play** - When your application answers a call or places an outbound call, you can play an audio prompt for the caller. The audio prompt can be looped for scenarios like playing hold music. To learn more, view our [quickstart](../../quickstarts/voice-video-calling/Play-Action.md).
92
97
93
98
**Transfer** – When your application answers a call or places an outbound call to an endpoint, that endpoint can be transferred to another destination endpoint. Transferring a 1:1 call will remove your application's ability to control the call using the Call Automation SDKs.
0 commit comments