Skip to main content

SignalWire Fax

Status
Available
Region
Global
Vendor
SignalWire
Data flow
Two-way: faxes sent from wawa; faxes to your numbers received into wawa
Connectivity
SignalWire Compatibility API, authorised by your API token
Set up by
Clinic account administrator

Send and receive faxes from the Faxes page in wawa, using fax numbers in your own SignalWire account.

  • Write a fax, attach one or more PDFs and send it. Each fax shows whether it was delivered or failed, with a plain explanation when it fails.
  • Faxes sent to your numbers appear on the same page with their PDF, for everyone in the clinic.
  • Filter the page to faxes received or sent.

What we need from you​

You set this up yourself; you need a SignalWire account with at least one fax-capable number.

InputWhere to find it in SignalWire
Space URLYour Space's address, for example https://example.signalwire.com
Project IDAPI Credentials
API tokenAPI Credentials. Give it the Fax scope to send, and the Numbers scope too if wawa should set up receiving for you
Signing keyAPI Credentials. This is not the API token; wawa uses it to check that fax notifications really come from SignalWire
Fax numbersThe numbers in that project you want to use, in international format (for example +15551234567)

A fax number can be used by only one clinic on wawa.

Setting it up​

  1. Go to Settings → Integrations → SignalWire Fax.
  2. Under Provider accounts, add your SignalWire account: the Space URL, Project ID and API token, and the signing key under Webhook security. Click Test Connection to check the details.
  3. On the Configuration tab, add your fax numbers and turn on Enable fax.
  4. Route incoming faxes to wawa (below).

Routing incoming faxes​

SignalWire only hands a fax to wawa if each number runs a cXML script that receives the fax and sends it to wawa's webhook. Without it, sending works but nothing you receive reaches wawa.

  • Set Up Receive (recommended), on the provider account, does this for you: it creates a cXML script named "Wawa inbound fax" in your SignalWire project and points each of your numbers at it, with the receive mode set to Fax. It replaces whatever each number currently does with incoming calls, so it asks you to confirm first. Running it again is safe, and is needed after you add a number.
  • Set Up Manually shows the webhook URL and the cXML script to paste if you prefer to do it in the SignalWire dashboard. Under cXML scripts, create a script with that content; then under Phone numbers, edit each fax number, set it to receive Fax, and choose that script as the handler for incoming calls.

Once Enable fax is on, everyone in the clinic sees Faxes in the main menu. Turning it off hides the page, stops new faxes being sent and stops incoming faxes being saved.

Troubleshooting​

SymptomCheck
Sent faxes never leave "queued", or incoming faxes never appearThe provider account has a signing key under Webhook security; without one, wawa rejects SignalWire's notifications
Set Up Receive reports a number as not foundThe number is in the same SignalWire project as the provider account
Set Up Receive reports a missing scopeThe API token has the Numbers scope
Sending works but incoming faxes never appearEach number receives as Fax and uses the wawa cXML script; run Set Up Receive again, especially after adding a number
A new fax is missing from the listReload the page; the list does not refresh on its own