Skip to main content

Connect a SIP provider

Updated over a week ago

This guide explains how to establish SIP connectivity within the Newo platform to enable voice capabilities. By configuring the Newo Voice integration with standard SIP credentials, you can connect your preferred telephony provider to your AI Employee.

Prerequisites

Before configuring the connection, ensure you have the following requirements in place:

  • SIP Provider Account: You must have an active SIP account with your provider.

  • Standard SIP Support: Your provider must support standard SIP capabilities.

  • Protocol Support: TCP or TLS protocol support is recommended for optimal performance, though UDP is also supported.

  • Phone Number: A phone number assigned to your SIP account for caller ID.

  • Provider Testing: Verify that your SIP provider has been tested and works correctly before integration.

πŸ—’οΈ NOTE

Newo does not use IP trunk connections. Only standard SIP account registration is supported. No additional configuration or integration is required beyond the SIP credentials.

Required SIP credentials

You must obtain specific credentials from your SIP provider to complete the setup.

The following table outlines the required information:

Parameter

Description

SIP hostname

The SIP server address, including the port (e.g., sip.yourprovider.com:5060).

SIP username

Your SIP account username or login credentials.

SIP password

Your SIP account password.

SIP caller id

The phone number that routes to your SIP account.

SIP connection type

The protocol supported by your provider (UDP, TCP, or TLS).

Configure the voice connector

Follow these steps to apply your SIP credentials in the Newo builder interface.

  1. Navigate to the Integrations page in the Builder.

  2. Locate the Newo Voice integration in your integrations list.

  3. Click the newo_voice_connector (ensure it shows "Running" status), select the three dots menu, and choose Edit Settings.

  4. Enter your credentials in the Provider: SIP section:

    • SIP caller id: Enter your caller ID.

    • SIP connection type: Select the protocol supported by your provider.

    • SIP hostname: Enter your SIP server address.

    • SIP password: Enter your SIP account password.

    • SIP username: Enter your SIP account username.

  5. Change the Provider field from Twilio to SIP.

  6. Click Save and Publish All.

  7. Make a test call to your configured SIP caller ID number to verify the connection.

  8. If the call connects successfully, your SIP connection is properly configured and ready for use.

Network configuration

Most SIP providers do not require IP whitelisting. You should only add addresses to your provider's whitelist if your service provider specifically requests it.

If required, whitelist the following IP addresses:

  • NAT Gateway IP (Egress): 34.135.75.172, 136.111.192.221.

  • TURN Server IP Addresses: 34.9.125.3.

SIP connection types and security

You must use a connection type that your SIP provider explicitly supports. Most providers support either TCP or UDP, but not necessarily both.

  • TCP (Transmission Control Protocol): Recommended for Newo. It is more reliable than UDP and ensures packet delivery.

  • UDP (User Datagram Protocol): Widely supported by most SIP providers and suitable for most voice calls.

  • TLS (Transport Layer Security): An encrypted connection for enhanced security. Use this only if your provider supports it.

Security recommendations

To ensure a secure connection, consider the following best practices:

  • Protocol Choice: Use the TLS connection type if your provider supports it for encryption.

  • Credentials: Regularly update your SIP account passwords.

  • Monitoring: Monitor call logs for any unauthorized usage.

  • Network: Ensure your network firewall is properly configured.

  • Providers: Work with reputable SIP providers that have been tested with Newo.

❗❗ IMPORTANT

Check with your provider before changing protocols. You cannot switch to unsupported protocols.

FAQs

  • Do phone numbers need to be registered on Newo's server or with the provider?
    Phone numbers must be registered with your SIP provider, not on Newo's server. Newo connects to your provider using standard SIP account registration. If you're registering numbers from outside your provider's primary service region, check if your provider requires IP whitelisting.

  • Does Newo require trunk registration or an IP-based connection?
    No, Newo does not use IP trunk connections. Only standard SIP account registration is supported. You need to provide your provider's SIP credentials (hostname, login, password).

  • What configuration is required on the provider side?
    No special configuration is required beyond standard SIP account setup. Your provider needs to support standard SIP capabilities and, preferably, TCP or TLS.

  • Do I need to whitelist Newo's IP addresses?
    Most SIP providers do not require IP whitelisting. Only whitelist the Newo NAT gateway (34.135.75.172, 136.111.192.221) and TURN server (34.9.125.3) addresses if your provider specifically requests it.

  • What is the difference between a SIP account and a SIP connection?
    These terms are often used interchangeably. Your SIP connection is established using your SIP account credentials provided by your provider.

Did this answer your question?