Skip to main content

Quickstart

Deploy your first SWML script in 5 minutes

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:

Deploy your SWML script

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:

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.

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.

Test your application

Call your assigned phone number to test your SWML application.

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:

SignalWire Dashboard with SWML tab open

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.

SignalWire Dashboard's phone number setting screen, selecting a SWML script as call handler.

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

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: