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.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.18.tar.gz (28.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.18-py3-none-any.whl (34.1 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for connexity-0.0.8.18.tar.gz
Algorithm Hash digest
SHA256 dd3740c0b865935beabf177aab58adcf9b02b74217b3083324f0798a86b1ee58
MD5 cf139580715fe3461c05d49de019d25a
BLAKE2b-256 c2c62cabbe7f4eca81ce4eccf17472fa9b246ddb5e4e1d28c6830c6dbdd50694

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for connexity-0.0.8.18-py3-none-any.whl
Algorithm Hash digest
SHA256 609ab6504903bea5ee0877e5574f6dd52b280a200faa76a8ef8d249bed43bdf8
MD5 a9913035294b1532deec5fb33e4f918c
BLAKE2b-256 7b191ff0f87a536e8575a35b9fb59a794e4b2d627b781ddaaba4d10745aa644f

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