SIP Integrations

Guava agents can receive inbound calls over the SIP protocol. You can use this feature to directly dial Guava agents from an SBC, PBX, or softphone without going out to the PSTN.

Using Twilio? See the Twilio Programmable Voice guide or the Twilio Elastic SIP guide for step-by-step walkthroughs.

Contact us for peer whitelisting

Currently, we are whitelisting SIP peers at our firewall level. Contact us at hi@goguava.ai to get your source IPs whitelisted. The following providers are already whitelisted. If your SIP calls originate from one of them, you can skip this step.

Twilio

Check connectivity

Once whitelisted, try to make an OPTIONS ping to our SIP trunk at sip.goguava.ai. If the check fails, see our guide below on firewall configuration.

Create a SIP code

Every SIP integration requires a guavasip code, which you can create in the Guava dashboard. guavasip codes work just like registered phone numbers — agents can listen to them and peers can dial them.

Open the SIP page in the dashboard.
Click Create SIP Code.
Take note of both the SIP code and the termination URI.

# You will see a SIP code like this.
guavasip-xxx

# Your termination URI will look like this.
sip:guavasip-xxx@sip.goguava.ai

Attach your agent to the SIP code

Next, start an agent using agent.listen_sip("guavasip-xxx"). This is the SIP equivalent of agent.listen_phone(...) — Guava forwards every call addressed to that code to your agent.

main.py

import os

agent = guava.Agent(
    name="Nova",
    organization="Acme Corp",
    purpose="Handle inbound calls from the corporate PBX.",
)

# Register handlers — on_call_received, on_call_start, etc.

# Replace with your SIP code from the dashboard.
agent.listen_sip("guavasip-xxx")

To connect an agent to both a phone number and a SIP code simultaneously, see the documentation for guava.Runner.

Dial your agent

The last step is to dial your agent using the termination URI (e.g. sip:guavasip-xxx@sip.goguava.ai). If you’re having trouble connecting to your agent, please contact us at hi@goguava.ai.

Firewall configuration

To dial our SIP trunk from your network, you may need to whitelist us in your firewall.


FQDN	The FQDN for the Guava SIP trunk is `sip.goguava.ai`.
Trunk IP	The IP address for the Guava SIP trunk is `136.118.29.109`. This IP is used for both media and signaling.
TCP Ports	`5060`, `5061` (TLS)
UDP Ports	`5060`, `10000-65535` (Media)
ICMP	Whitelist ICMP to allow connectivity checks (e.g. `ping`).
Supported Codecs	`PCMU` (G.711 μ-law), `PCMA` (G.711 a-law)

Getting started

Agent SDK

CLI reference

WebRTC

SIP calling

Phone numbers

Deployments

Compliance

Release notes

Contact us for peer whitelisting

Check connectivity

Create a SIP code

Attach your agent to the SIP code

Dial your agent

Firewall configuration

​Contact us for peer whitelisting

​Check connectivity

​Create a SIP code

​Attach your agent to the SIP code

​Dial your agent

​Firewall configuration

Contact us for peer whitelisting

Check connectivity

Create a SIP code

Attach your agent to the SIP code

Dial your agent

Firewall configuration