Client - Guava Documentation

guava.Client complements guava.Agent by providing functions for managing account-level resources. It also provides any functions that don’t fit onto guava.Agent.

Python
TypeScript

run.py

import guava, os

client = guava.Client(
    api_key=os.environ["GUAVA_API_KEY"],   # or omit — reads env automatically
)

run.ts

import * as guava from "@guava-ai/guava-sdk";

const client = new guava.Client({
  apiKey: process.env.GUAVA_API_KEY,  // or omit — reads env automatically
});

API

Python
TypeScript

Parameter	Type	Default	Description
`api_key`	`str \| None`	env `GUAVA_API_KEY`	Your Guava API key.
`base_url`	`str \| None`	production	Override the API endpoint (for testing).

Parameter	Type	Default	Description
`apiKey`	`string`	env `GUAVA_API_KEY`	Your Guava API key.
`baseUrl`	`string`	production	Override the API endpoint (for testing).

Methods

Python
TypeScript

Method	Description
`create_sip_agent()`	Generate a SIP code linked to your account for inbound SIP call handling.
`create_webrtc_agent(ttl)`	Generate a WebRTC code for browser-based voice interaction, with optional TTL.
`send_sms()`	Send an SMS message. See SMS Messaging.
`next_sms()`	Wait for and return the next inbound SMS reply. See SMS Messaging.

Method	Description
`createSipAgent()`	Generate a SIP code linked to your account for inbound SIP call handling.
`createWebrtcAgent(ttlSec)`	Generate a WebRTC code for browser-based voice interaction, with optional TTL.
`sendSms()`	Send an SMS message. See SMS Messaging.
`nextSms()`	Wait for and return the next inbound SMS reply. See SMS Messaging.