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.
| Input | Where to find it in SignalWire |
|---|---|
| Space URL | Your Space's address, for example https://example.signalwire.com |
| Project ID | API Credentials |
| API token | API Credentials. Give it the Fax scope to send, and the Numbers scope too if wawa should set up receiving for you |
| Signing key | API Credentials. This is not the API token; wawa uses it to check that fax notifications really come from SignalWire |
| Fax numbers | The 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
- Go to Settings → Integrations → SignalWire Fax.
- 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.
- On the Configuration tab, add your fax numbers and turn on Enable fax.
- 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
| Symptom | Check |
|---|---|
| Sent faxes never leave "queued", or incoming faxes never appear | The provider account has a signing key under Webhook security; without one, wawa rejects SignalWire's notifications |
| Set Up Receive reports a number as not found | The number is in the same SignalWire project as the provider account |
| Set Up Receive reports a missing scope | The API token has the Numbers scope |
| Sending works but incoming faxes never appear | Each 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 list | Reload the page; the list does not refresh on its own |