Overview

This guide outlines the process for integrating your existing SIP service with Hooman Labs for both inbound and outbound calling. Our team will handle the final provisioning of the connection once you provide the necessary technical information.

1. Information Required by HoomanLabs

To get started, please share the following details with our team:

• Account Basics: Telephony ID, Company ID, and your technical contact's name and email.

• Network Details: Trunk region (if applicable), SIP signaling domain/IP address, SIP port, and transport protocol (UDP or TCP).

• Authentication:

  • IP Authentication: Provide the IP addresses that should be allowed by your SIP service.

  • Username/Password Registration: Provide your SIP username, password, and registration server.

• Media: Supported codecs and any specific media requirements.

2. Inbound Calling Setup

You can route inbound calls to your agents using one of two methods:

Option A: DID-Based Routing

Use this method to route calls from specific phone numbers to your Hooman agents.

Details to share with Hooman:

• List of DIDs to be routed to Hooman.

• Your SIP service's source IPs, CIDRs, or domains used for signaling and media.

• Preferred destination number format (e.g., +14155550100) and Caller ID format.

Setup Steps:

1. Share the required inbound details with Hooman.

2. Hooman will provide you with the necessary SIP endpoint and network configuration.

3. In your SIP service portal, route your DIDs to the Hooman-provided SIP endpoint.

4. Whitelist Hooman’s SIP and media IPs if your network requires it.

5. Configure DID-to-agent routing within the Hooman Labs dashboard.

6. Place test calls to ensure they reach the correct agents.

Option B: Direct Agent SIP URI Routing

Use this if your platform can route calls directly to a specific SIP URI assigned to an agent.

Details to share with Hooman:

• Source IPs, CIDRs, or domains for signaling and media.

• Caller ID format and confirmation that your platform can set the SIP URI user value.

Setup Steps:

1. Request the SIP endpoint format from Hooman.

2. Configure your platform to send calls to the Hooman-provided SIP address.

3. Set the Hooman agent or routing identifier as the SIP URI user value.

4. Whitelist Hooman’s SIP and media IPs if required.

5. Perform a test call to confirm direct routing.

3. Outbound Calling Setup

To enable outbound dialing, please provide the following:

• Connectivity: Outbound termination domain/IP, port, and transport protocol (UDP or TCP).

• Caller ID: Approved outbound Caller IDs and required formatting.

• Restrictions: Any regional, country-specific, or number-type restrictions.

• Testing: Provide test destination numbers for our team.

Customer Steps:

1. Share the outbound details listed above.

2. Whitelist Hooman’s SIP and media IPs if using IP authentication.

3. Hooman will provision your outbound route.

4. Conduct test outbound calls directly from the Hooman Labs dashboard.

4. Network Requirements

To ensure call quality and connectivity, please ensure your firewall or SIP service allows:

• SIP signaling over UDP or TCP.

• RTP media traffic.

• Two-way traffic between your IPs and Hooman-provided SIP/media IPs.

Note: TLS is not currently supported.

5. Validation Checklist

Before going live, verify the following:

• [ ] Inbound DID calls reach the correct agent configured in the dashboard.

• [ ] Direct agent SIP URI calls route successfully.

• [ ] Outbound calls placed from the Hooman Labs dashboard complete successfully.

• [ ] Two-way audio is clear and consistent.

• [ ] Caller ID displays in your expected format.

• [ ] Failed calls trigger appropriate SIP response codes or error logs for debugging.