Skip to main content

A Python client for Connexity API.

Project description

Usage

from pipecat.audio.vad.vad_analyzer import VADParams
from connexity.metrics.pipecat_twilio import ConnexityTwilioObserver
from twilio.rest import Client

# build your VADParams once
vad_params = VADParams(
    confidence=0.5,
    min_volume=0.6,
    start_secs=0.2,
    stop_secs=0.8,
)

# assume you’ve already created/started your TwilioClient somewhere:
#    twilio_client = Client(account_sid, auth_token)
#    twilio_client.calls(call_sid).recordings.create()
# and you want to inject that manager into the observer

observer = ConnexityTwilioObserver()
await observer.initialize(
    agent_id="YOUR_AGENT_ID",
    api_key="YOUR_CONNEXITY_API_KEY",
    sid=call_sid,
    phone_call_provider="twilio",    # OPTIONAL FIELD
    user_phone_number=from_number,   # OPTIONAL FIELD
    agent_phone_number=to_number,    # OPTIONAL FIELD

    # <<< now using DI of client instead of creds >>>
    twilio_client=twilio_client.client,  # OPTIONAL FIELD
    daily_api_key="DAILY_API_KEY",       # OPTIONAL FIELD

    call_type="inbound",
    vad_params=vad_params,
    env="development",          # or "production"
    vad_analyzer="silero",      # your chosen VAD engine name
)

pipeline.register_observer(observer)

CHANGELOG

v0.0.8.19 — 2025-11-27

New Features

  • Latency Peaks improved
  • Tool Call Incidents improved

v0.0.8.18 — 2025-11-09

New Features

  • Interruption loop Incident added
  • Added System Prompts pulling to create prompt based incidents

v0.0.8.17 — 2025-11-07

New Features

  • Pipecat Tool Calls Incident added

v0.0.8.16 — 2025-11-06

  • Hotfix

v0.0.8.15 — 2025-11-06

New Features

  • Observability improvements
    Refactored way how Pipecat errors are handled

  • Interruption Incident added

v0.0.8.13 — 2025-10-24

New Features

  • snapshot_error_frame.py
    add wrapper to capture error frames in Pipecat

CHANGELOG

v0.0.8.12 — 2025-09-04

CRITICAL FIX

  • get_daily_recording_url
    fixed issue with types

CHANGELOG

v0.0.8.11 — 2025-09-02

New Features

  • ConnexityDailyObserver support
    Added support for ConnexityDailyObserver, including retrieving Daily recording and call duration.
    Note: You must pass daily_api_key to enable this feature.

Breaking Changes

  • Observer logic refactor

    • Introduced pipecat_interface with standardized initialize(...) and on_push_frame(...) methods for all current and future observer classes.

    • Created ConnexityDailyObserver and ConnexityTwilioObserver. These should now be used instead of previous observer implementations.

    • STT and TTS Model Parameters: Added support for configurable STT and TTS models and voices

    • stt_model: Specify the speech-to-text model to use (dynamic values from providers)

    • tts_model: Specify the text-to-speech model to use (dynamic values from providers)

    • tts_voice: Specify the voice ID for text-to-speech (dynamic values from providers)

  • ConnexityTwilioObserver Updates: Updated to handle new STT/TTS parameters in initialization

v0.0.8.9 — 2025-06-24

Minor Fixes

  • Get recording from region specific twilio account

v0.0.8.8 — 2025-06-24

Breaking Changes

  • Twilio DI instead of credentials

Removed twilio_account_sid and twilio_auth_token parameters from initialize(...).

Now you must pass a twilio_client: TwilioClient instance via the twilio_client argument. Action required: construct and start your own TwilioClient, then inject it into the observer.

v0.0.8.7 — 2025-06-20

Breaking Changes

  • Removed built-in Twilio call recording
    Recording is no longer performed by this package.
    Action required: start your Twilio recording on the app side as soon as the WebSocket connection is established.

v0.0.8.6 — 2025-06-13

New Features

VAD compensation

  • Configurable via VADParams
  • Pass vad_params into initialize(...)
  • Environment & analyzer tags
  • Added env and vad_analyzer metadata fields to register_call

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

connexity-0.0.8.20.tar.gz (34.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

connexity-0.0.8.20-py3-none-any.whl (40.6 kB view details)

Uploaded Python 3

File details

Details for the file connexity-0.0.8.20.tar.gz.

File metadata

  • Download URL: connexity-0.0.8.20.tar.gz
  • Upload date:
  • Size: 34.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for connexity-0.0.8.20.tar.gz
Algorithm Hash digest
SHA256 9f0864251256d0288a85c29e2470690547b25ee95621d73b46179924ca364bc9
MD5 142510a4547318d6376a6efece80736b
BLAKE2b-256 ef392121a32faf6600b6af77d3726e8115aa3f7f606582750aefd98087bbed0b

See more details on using hashes here.

File details

Details for the file connexity-0.0.8.20-py3-none-any.whl.

File metadata

  • Download URL: connexity-0.0.8.20-py3-none-any.whl
  • Upload date:
  • Size: 40.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for connexity-0.0.8.20-py3-none-any.whl
Algorithm Hash digest
SHA256 cc62c996a8271883352df54a4889ffae44d3cf37fd5bfc5423a71b867784932f
MD5 c3be3beeded34b1987a1566cf14afc9d
BLAKE2b-256 2c1e70af73570e00498da83283e34326018ab9ade9c1957104846c8baac5f66f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page