Troubleshooting

Fresh

Authentication Issues

Problem: 401 Unauthorized responses

Solutions:

• Verify your Project ID and API Token are correct
• Ensure you're using Basic Auth format: ProjectID:APIToken as Base64
• Check that your Space URL is correct

Call Not Connecting

Problem: Outbound calls fail or drop immediately

Solutions:

• Verify the destination number is in E.164 format
• Check that your account has sufficient credits
• Ensure the from number is a verified SignalWire number

SWML Execution Errors

Problem: SWML document fails to execute

Solutions:

• Validate your YAML indentation — use 2 spaces, not tabs
• Ensure version: 1.0.0 is at the top
• Verify all verb names are lowercase
• Check that sections contains a main key

Webhook Not Receiving Events

Problem: Webhooks aren't firing or returning 404

Solutions:

• Ensure your webhook URL is publicly accessible (not localhost)
• Verify your server returns HTTP 200 for webhook POST requests
• Check SignalWire dashboard for webhook delivery logs
• Ensure your SSL certificate is valid if using HTTPS

AI Agent Not Responding

Problem: AI agent doesn't speak or hangs

Solutions:

• Verify your SWML ai verb has a prompt.text field
• Check that post_prompt_url is accessible if configured
• Review logs in the SignalWire dashboard for SWAIG function errors

Rate Limiting

Problem: Receiving 429 Too Many Requests

Solutions:

• Implement exponential backoff in your retry logic
• Batch operations where possible
• Review your message/call volume against plan limits