Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
c0dbdda
Added SWML example to create/receive call guide
Manny-r31 Oct 31, 2025
e11fde2
Merge branch 'main' into Manny/SWML-make-call-example
Manny-r31 Nov 3, 2025
d2c31cc
Merge branch 'main' into Manny/SWML-make-call-example
Manny-r31 Nov 10, 2025
acc2e08
Merge branch 'main' into Manny/SWML-make-call-example
Devon-White Nov 17, 2025
ff367d1
Merge branch 'main' into Manny/SWML-make-call-example
Manny-r31 Nov 21, 2025
dfc480a
Merge branch 'main' into Manny/SWML-make-call-example
Manny-r31 Nov 21, 2025
8eab9a0
Merge branch 'main' into Manny/SWML-make-call-example
Manny-r31 Nov 21, 2025
0156cdd
Completed create call example, various changes to formatting.
Manny-r31 Nov 21, 2025
20d7efd
Fixed broken link
Manny-r31 Nov 21, 2025
b363b81
Merge branch 'main' into Manny/SWML-make-call-example
Manny-r31 Nov 25, 2025
dbedee8
Merge branch 'main' into Manny/SWML-make-call-example
hey-august Dec 1, 2025
8723d24
Merge branch 'main' into Manny/SWML-make-call-example
hey-august Dec 9, 2025
72e363d
add usage detail to inline swml
hey-august Dec 9, 2025
854ced6
Add base64 encoding for auth
hey-august Dec 9, 2025
85bfb8a
Add base64 encoding for auth
hey-august Dec 9, 2025
f73f40e
update introduction, add ref-style links
hey-august Dec 9, 2025
d6b8690
accordions
hey-august Dec 9, 2025
c4c27a3
misc edits
hey-august Dec 9, 2025
01465fa
add 'SWML object' tab, add escaping to inline SWML example
hey-august Dec 9, 2025
2828743
tabs vs spaces :P
hey-august Dec 10, 2025
0ed5e79
wording in last paragraph
hey-august Dec 10, 2025
8b6917a
Merge branch 'main' into Manny/SWML-make-call-example
hey-august Dec 10, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions website/docs/main/_common/dashboard/create-cxml-script.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@

<TabItem value="newui" label="New Dashboard">

If you're on the **new UI**, go to the "Resources" section from the sidebar, and create a new Resource.
In the new resource picker, select "Script" and create a "cXML script".
If you're on the **new UI**, go to the **Resources** section from the sidebar, and create a new Resource.
In the new resource picker, select **Script** and create a **cXML script**.

<Frame>
![Attach Phone Number](@image/dashboard/resources/new-cxml-bin.png)
Expand All @@ -13,7 +13,7 @@

<TabItem value="legacyui" label="Legacy Dashboard">

If you're on the **Legacy UI**, go to the "cXML/LaML" section in your [SignalWire Space](https://signalwire.com/signin), then click on "Bins", and create a new script.
If you're on the **Legacy UI**, go to the **cXML/LaML** section in your [SignalWire Space](https://signalwire.com/signin), then click on **Bins**, and create a new script.

<Frame>
![Legacy bin](@image/dashboard/legacy/xml-bins.png)
Expand Down
6 changes: 3 additions & 3 deletions website/docs/main/_common/dashboard/create-swml-script.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@

<TabItem value="newui" label="New Dashboard">

To create a SWML Script in the **new UI**, go to the "Resources" section from the sidebar, and create a new Resource.
In the new resource picker, select "Script" and create a "SWML Application".
To create a SWML Script in the **new UI**, go to the **Resources** section from the sidebar, and create a new Resource.
In the new resource picker, select **Script** and create a **SWML Application**.

<Frame>
![Attach Phone Number](@image/dashboard/resources/swml-resource-vid.webp)
Expand All @@ -13,7 +13,7 @@

<TabItem value="legacyui" label="Legacy Dashboard">

If you are using the **Legacy UI**, go to the "Relay/SWML" section in your sidebar, then click on the "SWML Scripts" tab. Click on "Create a SWML Script",
If you are using the **Legacy UI**, go to the "Relay/SWML" section in your sidebar, then click on the **SWML Scripts** tab. Click on **Create a SWML Script**,
and then give it a name and pass it some instructions. You can use the following as a starting point:

<Frame>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ To be able to make calls, you will need:

To acquire a phone number, [Log in](https://signalwire.com/signin) to your SignalWire Space. From the [Phone Numbers section](https://my.signalwire.com/?phone_numbers), you can [buy a new phone number](/platform/phone-numbers/getting-started/buying-a-phone-number). You will need at least one number to make and receive calls.

For what concerns your API credentials, find these in the API section of your Space, as shown in the following figure. You may need to create a new token if you never used one. Make sure that your token has the "Voice" scope enabled.
For what concerns your API credentials, find these in the API section of your Space, as shown in the following figure. You may need to create a new token if you never used one. Make sure that your token has the **Voice** scope enabled.

<Frame caption="You can find your Project ID and Token from the API tab in your SignalWire Space. Make sure your token has the 'Voice' scope enabled.">

Expand All @@ -54,12 +54,12 @@ import NewLegacy from '/docs/main/_common/dashboard/_ui-accordion.mdx'
To handle incoming calls we need to configure the phone number in our
[SignalWire Space](https://signalwire.com/signin) to answer calls using a SWML Script.

To create a SWML Script in the **new UI**, go to the "Resources" section from the sidebar, and create a new Resource.
In the new resource picker, select "Script" and create a "SWML Application".
To create a SWML Script in the **new UI**, go to the **Resources** section from the sidebar, and create a new Resource.
In the new resource picker, select **Script** and create a **SWML Application**.


If you are using the **Legacy UI**, go to the "Relay/SWML" section in your sidebar, then click on the "SWML Scripts" tab. Click on "Create a SWML Script",
and then give it a name and pass it some instructions. You can use the following as a starting point:
If you are using the **Legacy UI**, go to the **Relay/SWML** section in your sidebar, then click on the **SWML Scripts** tab.
Click on **Create a SWML Script*, and then give it a name and pass it some instructions. You can use the following as a starting point:

```yaml andJson
version: 1.0.0
Expand All @@ -68,9 +68,11 @@ sections:
- play: say:Hello from SignalWire!
```

Take note of the Request URL for the SWML Script that we created. You can even create a new script if you want to define a different behavior for incoming calls.
Take note of the Request URL for the SWML Script that we created.
You can even create a new script if you want to define a different behavior for incoming calls.

To configure your number to handle incoming calls with an SWML Script, click the ["Phone Numbers" section](https://my.signalwire.com/?phone_numbers) within your SignalWire Space, and edit the settings of the specific number you would like to use to answer calls. Set "Handle calls using" to "a SWML Script", then select your SWML Script from the dropdown:
To configure your number to handle incoming calls with an SWML Script, click the [**Phone Numbers**](https://my.signalwire.com/?phone_numbers) section within your SignalWire Space, and edit the settings of the specific number you would like to use to answer calls.
Set **Handle calls using** to **a SWML Script**, then select your SWML Script from the dropdown:

That's it! Inbound calls to this SignalWire number will execute the specified SWML Script.

Expand All @@ -84,10 +86,10 @@ We want to call a number and play an audio message which says "Welcome to
SignalWire. This is my first call". We are going to define this behavior in an
XML bin, which is used to declare what should happen during a call.

If you're on the **new UI**, go to the "Resources" section from the sidebar, and create a new Resource.
In the new resource picker, select "Script" and create a "cXML script".
If you're on the **new UI**, go to the **Resources** section from the sidebar, and create a new Resource.
In the new resource picker, select **Script** and create a **cXML script**.

If you're on the **Legacy UI**, go to the "cXML/LaML" section in your [SignalWire Space](https://signalwire.com/signin), then click on "Bins".
If you're on the **Legacy UI**, go to the **cXML/LaML** section in your [SignalWire Space](https://signalwire.com/signin), then click on **Bins**.

Create a new bin, and paste the following XML in it:

Expand Down Expand Up @@ -133,15 +135,15 @@ To handle incoming calls we need to configure the phone number in our
[SignalWire Space](https://signalwire.com/signin) to answer calls using a cXML
bin.

If you're on the **new UI**, go to the "Phone Numbers" section from the sidebar, and
If you're on the **new UI**, go to the **Phone Numbers** section from the sidebar, and
edit the phone number you want to answer calls from. There, click on the
"Assign Resource" button for incoming calls, and select the cXML or SWML script you'd like to connect.
**Assign Resource** button for incoming calls, and select the cXML or SWML script you'd like to connect.

If you're on the **old UI**, take note of the Request URL for the bin that we created in the previous
section. You can even create a new bin if you want to define a different
behavior for incoming calls.

Click the "Phone Numbers" section from your sidebar, and select the specific number you would like to use to answer calls. The same number we used before can work.
Click the **Phone Numbers** section from your sidebar, and select the specific number you would like to use to answer calls. The same number we used before can work.

Make sure that "_Accept Calls As_" is set to "_Voice Calls_", "_Handle Calls Using_" is set to "_LaML Webhooks_", and paste your Bin URL in as the value for "_When a Call Comes In_". Click "_Save_", and you're done! Inbound calls to this SignalWire number will execute the specified bin.

Expand Down
Loading