ړi U d Z ddlZddlmZ ddlmZ ddlmZmZm Z m
Z
m Z m Z G d d Z
daee
ed < d
e
fd Zd ed
efdZy)zI
Twilio Client Module
Provides Twilio API wrapper and TwiML generation.
N)Optional)Client )TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKEN
WEBSOCKET_URLSTREAM_REDIRECT_URLvalidate_twilio_credentialslog_callc e Zd ZdZddeefdedededefdZede fd Z
dd
edefd Z d edefd
Z defdZ
defdZded efdZdefdZy) TwilioHelperzc
Helper class for Twilio operations.
Provides TwiML generation and call manipulation.
N account_sid
auth_token
websocket_urlstream_redirect_urlc j |xs t | _ |xs t | _ || _ || _ d| _ y)aK
Initialize Twilio helper.
Args:
account_sid: Twilio account SID (uses env var if not provided)
auth_token: Twilio auth token (uses env var if not provided)
websocket_url: URL for media stream WebSocket
stream_redirect_url: URL for stream redirect after TTS
N)r r r r r r _client)selfr r r r s ;/home/sas/my/fyp/ringai/ringai/twilio_integration/client.py__init__zTwilioHelper.__init__ s6 '<*<$9(9 *#6 )- returnc | j H| j r | j s t d t | j | j | _ | j S )z)Get Twilio client, initializing if neededzfTwilio credentials not set. Please set TWILIO_ACCOUNT_SID and TWILIO_AUTH_TOKEN environment variables.)r r r RuntimeErrorr r s r clientzTwilioHelper.client3 sS << ##4??"? "$"2"2DOODDL||r custom_greetingc 4 |xs d}d| d| j dS )z
Build TwiML for incoming call greeting.
Args:
custom_greeting: Optional custom greeting text
Returns:
TwiML XML string
zHello.
This is Ring A I.
Please speak clearly after the tone.z4
z
r )r r greetings r build_greeting_twimlz!TwilioHelper.build_greeting_twiml? sA #
N *
$$% & r textc ( d| d| j dS )z
Build TwiML for AI response.
Args:
text: Text to speak
Returns:
TwiML XML string
zG
z7
z
)r )r r# s r build_say_twimlz TwilioHelper.build_say_twimlY s, V 334 5 r c " d| j dS )zk
Build TwiML for resuming stream after TTS.
Returns:
TwiML XML string
zO
r s r build_hangup_twimlz TwilioHelper.build_hangup_twimlx s r call_idc K t j d|| | j | } t j | j
j
| j | d{ y7 # t $ rJ}dt | v sdt | j v rt j d| n Y d}~yd}~ww xY ww)z~
Send TTS to active call.
Args:
call_id: Twilio call SID
text: Text to speak
zcall=%s TTS -> %r)twimlN21220znot in-progressz&call=%s already ended, cannot send TTS) r infor% asyncio to_threadr callsupdate Exceptionstrlower)r r+ r# r- es r sayzTwilioHelper.say s
)7D9$$T*
## !!'*11
#a& $5Q $G
FP Q sA )C=A1 )A/*A1 .C/A1 1 C:A B?:C?CCc T | j j | j S )zGet call resource by SID)r r2 fetch)r r+ s r get_callzTwilioHelper.get_call s {{ )//11r )N)__name__
__module__ __qualname____doc__r r r5 r propertyr r r" r% r' r* r8 r; r) r r r
r
s *#6 .. . .
! ., C 3 4C C " C
C
C 02 2r r
_twilio_helperr c . t
t a t S )z!Get global Twilio helper instance)rA r
r) r r get_twilio_clientrC s % r r+ r# c X K t }|j | | d{ y7 w)z\
Convenience function to send TTS to call.
Uses global Twilio helper instance.
N)rC r8 )r+ r# helpers r trigger_sayrF s$
F
**Wd
###s *(*)r? r0 typingr twilio.restr configr r r r r
r r
rA __annotations__rC r5 rF r) r r rK s\ H2 H2X *. & -< $s $# $r