This guide will walk you through deploying your first SWML script to handle incoming calls. By the end of this quickstart, you’ll have a working phone number that runs your SWML application.

Prerequisites

Before you begin, make sure you have:

• A SignalWire account
• A SWML script ready for deployment

Deploy your SWML script

1

Create new script

From your SignalWire Dashboard, click Script, then SWML script. This will open the New SWML Script dialog box.

Paste your SWML Script into the Primary Script field, then select Create.

If necessary, copy and paste the below example script:

YAMLJSON

version: 1.0.0

sections:

  main:

    - answer: {}

    - play:

        url: "say:Hello World!"

    - play:

        url: "say:Congratulations on successfully deploying your script!"

    - hangup: {}

Your script will be saved in the “My Resources” section under “Scripts”.

It will remain housed here under the name you provide for easy reference.

2

Assign a phone number

• Navigate to Phone Numbers in your Dashboard.
• Purchase a phone number if needed by clicking the ”+ New” button in the top right hand corner of the page.
• Click on your phone number, then click “Edit Settings”.
• Click on ”+ Assign Resource”, then assign your SWML Script.

3

Test your application

Call your assigned phone number to test your SWML application.

In the Legacy Dashboard

You can write and save new SWML scripts from the “RELAY/SWML” section of your Dashboard. In that section, switch to the tab named SWML Scripts. Once there, you can create a new SWML script:

[Image]

After you save the SWML, navigate to the Phone Numbers page. Open the settings for a phone number you own (you may have to buy a new one), and configure it to handle incoming calls using the SWML script you just saved.

[Image]

Learn about the Legacy Dashboard migration

For SignalWire Spaces created before January 2025

Identify your Dashboard and select between Legacy and New UIs using the tabs below.

New Dashboard

Legacy Dashboard

[The redesigned main menu.]

The new SignalWire Dashboard features a streamlined sidebar menu. Many items are now located in the unified My Resources menu.

Resources that were previously accessible in the sidebar of the legacy UI are now located in the unified My Resources menu.

Next steps

Now that you’ve deployed your first SWML script, explore these resources:

Methods reference\ \ Explore all available SWML methods SWML AI guides\ \ Learn how AI methods are used in SWML Deployment\ \ Learn about deploying SWML via your own web server Agents SDK quickstart\ \ Get started with the AI Agents SDK