mirror of
https://github.com/dograh-hq/dograh.git
synced 2026-06-07 07:55:16 +02:00
docs(asterisk-ari): add required TLS config for Dograh Cloud and reload/codec notes
This commit is contained in:
parent
92c8dadd34
commit
9e12d96ebb
1 changed files with 22 additions and 4 deletions
|
|
@ -13,14 +13,14 @@ This guide focuses on the Dograh-specific configuration. For general Asterisk in
|
|||
|
||||
Before setting up the ARI integration, ensure you have:
|
||||
|
||||
- A running Asterisk instance (version 16 or later recommended)
|
||||
- A running Asterisk instance with `chan_websocket` and `res_websocket_client` modules available. Known-working setups: (a) Asterisk 22+, (b) Asterisk 20 LTS with these modules included
|
||||
- ARI module enabled in Asterisk
|
||||
- `chan_websocket` (WebSocket channel driver) enabled in your Asterisk build
|
||||
- `chan_websocket` (WebSocket channel driver) and `res_websocket_client` (loads `websocket_client.conf`) enabled in your Asterisk build. Verify with `asterisk -rx "module show like chan_websocket"` and `asterisk -rx "module show like res_websocket_client"` — both should report **Running**.
|
||||
- Network connectivity between your Dograh instance and Asterisk
|
||||
- Dograh AI instance running and accessible
|
||||
|
||||
<Note>
|
||||
If you compiled Asterisk from source, ensure `chan_websocket` is included during the build. This module is required for external media streaming between Asterisk and Dograh. Refer to the [Asterisk build system documentation](https://docs.asterisk.org/) for details on enabling modules.
|
||||
If you compiled Asterisk from source, ensure both `chan_websocket` and `res_websocket_client` are included during the build. These modules are required for external media streaming between Asterisk and Dograh. Refer to the [Asterisk build system documentation](https://docs.asterisk.org/) for details on enabling modules.
|
||||
</Note>
|
||||
|
||||
## Asterisk Configuration
|
||||
|
|
@ -80,10 +80,12 @@ Dograh uses Asterisk's external media streaming to send and receive audio over W
|
|||
type = websocket_client
|
||||
uri = wss://api.dograh.com/api/v1/telephony/ws/ari
|
||||
protocols = media
|
||||
tls_enabled = yes
|
||||
ca_list_file = /etc/ssl/certs/ca-certificates.crt
|
||||
```
|
||||
|
||||
<Note>
|
||||
Dograh Cloud requires a secure WebSocket connection (`wss://`). Make sure your Asterisk build includes TLS support for `chan_websocket`. The ARI credentials (**Stasis App Name** and **App Password**) must match what you configure in the Dograh dashboard under Telephony Settings.
|
||||
`tls_enabled = yes` is required even though the URI scheme is `wss://` — without it Asterisk will not negotiate TLS and the connection will fail. The ARI credentials (**Stasis App Name** and **App Password**) must match what you configure in the Dograh dashboard under Telephony Settings.
|
||||
</Note>
|
||||
</Tab>
|
||||
<Tab title="Self-hosted">
|
||||
|
|
@ -104,8 +106,24 @@ Dograh uses Asterisk's external media streaming to send and receive audio over W
|
|||
The section name (e.g., `dograh`) is the **WebSocket Client Name** you'll enter in the Dograh telephony configuration. This name tells Asterisk which WebSocket connection to use for external media streaming during calls.
|
||||
</Note>
|
||||
|
||||
<Note>
|
||||
Dograh's external media channel uses **G.711 μ-law (`ulaw`)**. Make sure any PJSIP endpoint or SIP trunk that places or receives calls through Dograh allows `ulaw` (e.g. `allow=ulaw` in the endpoint config).
|
||||
</Note>
|
||||
|
||||
Refer to the [Asterisk WebSocket documentation](https://docs.asterisk.org/) for additional `websocket_client.conf` options and TLS configuration.
|
||||
|
||||
### Apply the configuration changes
|
||||
|
||||
After editing any of the files above, reload the affected Asterisk modules from the Asterisk CLI (`asterisk -rvvv`):
|
||||
|
||||
```bash
|
||||
ari reload # picks up ari.conf changes
|
||||
dialplan reload # picks up extensions.conf changes
|
||||
module reload res_websocket_client.so # picks up websocket_client.conf changes
|
||||
```
|
||||
|
||||
Changes to `http.conf` require a full Asterisk reload (`core reload`) or a service restart.
|
||||
|
||||
## Configuration in Dograh
|
||||
|
||||
### Step 1: Navigate to Telephony Settings
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue