Quickstart | SignalWire

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

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:

1 version: 1.0.0
2 sections:
3   main:
4     - answer: {}
5     - play:
6         url: "say:Hello World!"
7     - play:
8         url: "say:Congratulations on successfully deploying your script!"
9     - 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.

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:

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.