manualSetProxyUrl

Manually set the proxy URL base used for generating webhook callback URLs. Call this when automatic proxy detection does not work for your deployment (e.g., behind a custom load balancer or tunneling service).

Overrides any value auto-detected from the SWML_PROXY_URL_BASE environment variable or inferred from request headers, and clears the “from env” flag so subsequent env changes won’t overwrite your explicit setting.

The proxy URL affects how webhook URLs are generated for SWAIG function callbacks, post-prompt URLs, and other webhook endpoints. Without a correct proxy URL, SignalWire cannot reach your service’s webhook endpoints when deployed behind a reverse proxy or tunnel.

Parameters

url

stringRequired

The base URL to use for webhook generation (e.g., "https://my-agent.ngrok.io"). Trailing slashes are stripped automatically. Empty strings are ignored.

Returns

this — returns the service for fluent chaining.

Example

1 import { SWMLService } from '@signalwire/sdk';
2 
3 const service = new SWMLService({ name: 'my-service' });
4 
5 // Set proxy URL for ngrok tunnel
6 service.manualSetProxyUrl('https://abc123.ngrok.io');
7 
8 service.addVerb('answer', {});
9 await service.serve();

1	import { SWMLService } from '@signalwire/sdk';
2
3	const service = new SWMLService({ name: 'my-service' });
4
5	// Set proxy URL for ngrok tunnel
6	service.manualSetProxyUrl('https://abc123.ngrok.io');
7
8	service.addVerb('answer', {});
9	await service.serve();