update voice snippets

maxkahan · maxkahan · commit 835457bdf60d · 2025-03-17T16:16:01.000Z
diff --git a/.env.dist b/.env.dist
@@ -97,3 +97,8 @@ VOICE_CONFERENCE_NAME='VOICE_CONFERENCE_NAME'
 VOICE_RECORDING_URL='VOICE_RECORDING_URL'
 VOICE_ANSWER_URL='VOICE_ANSWER_URL'
 VOICE_CALL_ID='VOICE_CALL_ID'
+VOICE_STREAM_URL='VOICE_STREAM_URL'
+VOICE_DTMF_DIGITS='VOICE_DTMF_DIGITS'
+VOICE_TEXT='VOICE_TEXT'
+VOICE_LANGUAGE='VOICE_LANGUAGE'
+VOICE_NCCO_URL='VOICE_NCCO_URL'
diff --git a/voice/handle-user-input-with-asr.py b/voice/handle-user-input-with-asr.py
@@ -1,30 +1,18 @@
-import os
-from os.path import join, dirname
-from dotenv import load_dotenv
+from pprint import pprint
 from fastapi import FastAPI, Body, Request
 from vonage_voice import Input, NccoAction, Speech, Talk
 
-dotenv_path = join(dirname(__file__), '../.env')
-load_dotenv(dotenv_path)
-
-VONAGE_VIRTUAL_NUMBER = os.environ.get('VONAGE_VIRTUAL_NUMBER')
-RECIPIENT_NUMBER = os.environ.get('RECIPIENT_NUMBER')
-
 app = FastAPI()
 
 
 @app.get('/webhooks/answer')
 async def answer_call(request: Request):
     ncco: list[NccoAction] = [
-        Talk(text=f'Please tell me something.'),
+        Talk(text=f'Please say something'),
         Input(
             type=['speech'],
-            speech=Speech(
-                endOnSilence=1,
-                language='en-US',
-                uuid=[request.query_params.get('uuid')],
-            ),
-            eventUrl=[str(request.base_url) + '/webhooks/asr'],
+            speech=Speech(endOnSilence=1, language='en-US'),
+            eventUrl=[str(request.base_url) + 'webhooks/asr'],
         ),
     ]
 
@@ -34,9 +22,10 @@ async def answer_call(request: Request):
 @app.post('/webhooks/asr')
 async def answer_asr(data: dict = Body(...)):
     if data is not None and 'speech' in data:
+        pprint(data)
         speech = data['speech']['results'][0]['text']
         return [
-            Talk(text=f'Hello ,you said {speech}').model_dump(
+            Talk(text=f'Hello, you said {speech}').model_dump(
                 by_alias=True, exclude_none=True
             )
         ]
diff --git a/voice/handle-user-input.py b/voice/handle-user-input.py
@@ -1,26 +1,18 @@
-import os
-from os.path import join, dirname
-from dotenv import load_dotenv
+from pprint import pprint
 from fastapi import FastAPI, Body, Request
-from vonage_voice import Input, NccoAction, Talk
-
-dotenv_path = join(dirname(__file__), '../.env')
-load_dotenv(dotenv_path)
-
-VONAGE_VIRTUAL_NUMBER = os.environ.get('VONAGE_VIRTUAL_NUMBER')
-RECIPIENT_NUMBER = os.environ.get('RECIPIENT_NUMBER')
+from vonage_voice import Dtmf, Input, NccoAction, Talk
 
 app = FastAPI()
 
 
 @app.get('/webhooks/answer')
 async def answer_call(request: Request):
     ncco: list[NccoAction] = [
-        Talk(text=f'Please enter a digit.'),
+        Talk(text=f'Hello, please press any key to continue.'),
         Input(
             type=['dtmf'],
-            maxDigits=1,
-            eventUrl=[str(request.base_url) + '/webhooks/dtmf'],
+            dtmf=Dtmf(timeOut=5, maxDigits=1),
+            eventUrl=[str(request.base_url) + 'webhooks/dtmf'],
         ),
     ]
 
@@ -29,8 +21,9 @@ async def answer_call(request: Request):
 
 @app.post('/webhooks/dtmf')
 async def answer_dtmf(data: dict = Body(...)):
+    pprint(data)
     return [
-        Talk(text=f'Hello, you pressed {data['dtmf']}').model_dump(
+        Talk(text=f'Hello, you pressed {data['dtmf']['digits']}').model_dump(
             by_alias=True, exclude_none=True
         )
     ]
diff --git a/voice/make-an-outbound-call.py b/voice/make-an-outbound-call.py
@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 import os
 from os.path import join, dirname
 from pprint import pprint
@@ -9,8 +8,9 @@
 
 VONAGE_APPLICATION_ID = os.environ.get("VONAGE_APPLICATION_ID")
 VONAGE_PRIVATE_KEY = os.environ.get("VONAGE_PRIVATE_KEY")
-FROM_NUMBER = os.environ.get("FROM_NUMBER")
 VOICE_TO_NUMBER = os.environ.get("VOICE_TO_NUMBER")
+VONAGE_VIRTUAL_NUMBER = os.environ.get("VONAGE_VIRTUAL_NUMBER")
+VOICE_ANSWER_URL = os.environ.get("VOICE_ANSWER_URL")
 
 from vonage import Auth, Vonage
 from vonage_voice import CreateCallRequest, Phone, ToPhone
@@ -24,11 +24,9 @@
 
 response = client.voice.create_call(
     CreateCallRequest(
-        answer_url=[
-            'https://raw.githubusercontent.com/nexmo-community/ncco-examples/gh-pages/text-to-speech.json'
-        ],
+        answer_url=[VOICE_ANSWER_URL],
         to=[ToPhone(number=VOICE_TO_NUMBER)],
-        from_=Phone(number=FROM_NUMBER),
+        from_=Phone(number=VONAGE_VIRTUAL_NUMBER),
     )
 )
 
diff --git a/voice/make-outbound-call-ncco.py b/voice/make-outbound-call-ncco.py
@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
 from pprint import pprint
 import os
 from os.path import join, dirname
@@ -25,7 +24,7 @@
 
 response = client.voice.create_call(
     CreateCallRequest(
-        ncco=[Talk(text='Hello world, this is a test call.', loop=10)],
+        ncco=[Talk(text='This is a text to speech call from Vonage.')],
         to=[ToPhone(number=VOICE_TO_NUMBER)],
         from_=Phone(number=VONAGE_VIRTUAL_NUMBER),
     )
diff --git a/voice/mute-a-call.py b/voice/mute-a-call.py
@@ -8,7 +8,6 @@
 
 VONAGE_APPLICATION_ID = os.environ.get('VONAGE_APPLICATION_ID')
 VONAGE_PRIVATE_KEY = os.environ.get('VONAGE_PRIVATE_KEY')
-
 VOICE_CALL_ID = os.environ.get('VOICE_CALL_ID')
 
 from vonage import Auth, Vonage
diff --git a/voice/play-audio-stream-into-call.py b/voice/play-audio-stream-into-call.py
@@ -8,8 +8,8 @@
 
 VONAGE_APPLICATION_ID = os.environ.get('VONAGE_APPLICATION_ID')
 VONAGE_PRIVATE_KEY = os.environ.get('VONAGE_PRIVATE_KEY')
-
 VOICE_CALL_ID = os.environ.get('VOICE_CALL_ID')
+VOICE_STREAM_URL = os.environ.get('VOICE_STREAM_URL')
 
 from vonage import Auth, Vonage
 from vonage_voice import AudioStreamOptions, CallMessage
@@ -24,9 +24,7 @@
 
 response: CallMessage = client.voice.play_audio_into_call(
     VOICE_CALL_ID,
-    audio_stream_options=AudioStreamOptions(
-        stream_url=['https://example.com/ringtone.mp3']
-    ),
+    audio_stream_options=AudioStreamOptions(stream_url=[VOICE_STREAM_URL]),
 )
 
 pprint(response)
diff --git a/voice/play-dtmf-into-call.py b/voice/play-dtmf-into-call.py
@@ -8,8 +8,8 @@
 
 VONAGE_APPLICATION_ID = os.environ.get('VONAGE_APPLICATION_ID')
 VONAGE_PRIVATE_KEY = os.environ.get('VONAGE_PRIVATE_KEY')
-
 VOICE_CALL_ID = os.environ.get('VOICE_CALL_ID')
+VOICE_DTMF_DIGITS = os.environ.get('VOICE_DTMF_DIGITS')
 
 from vonage import Auth, Vonage
 from vonage_voice import CallMessage
@@ -23,7 +23,7 @@
 )
 
 response: CallMessage = client.voice.play_dtmf_into_call(
-    uuid=VOICE_CALL_ID, dtmf='1234p*#'
+    uuid=VOICE_CALL_ID, dtmf=VOICE_DTMF_DIGITS
 )
 
 pprint(response)
diff --git a/voice/play-tts-into-call.py b/voice/play-tts-into-call.py
@@ -8,9 +8,9 @@
 
 VONAGE_APPLICATION_ID = os.environ.get('VONAGE_APPLICATION_ID')
 VONAGE_PRIVATE_KEY = os.environ.get('VONAGE_PRIVATE_KEY')
-
 VOICE_CALL_ID = os.environ.get('VOICE_CALL_ID')
-LANGUAGE = os.environ.get('LANGUAGE')
+VOICE_TEXT = os.environ.get('VOICE_TEXT')
+VOICE_LANGUAGE = os.environ.get('VOICE_LANGUAGE')
 
 from vonage import Auth, Vonage
 from vonage_voice import CallMessage, TtsStreamOptions
@@ -25,7 +25,7 @@
 
 response: CallMessage = client.voice.play_tts_into_call(
     uuid=VOICE_CALL_ID,
-    tts_options=TtsStreamOptions(text='Hello from Vonage.', language=LANGUAGE),
+    tts_options=TtsStreamOptions(text=VOICE_TEXT, language=VOICE_LANGUAGE),
 )
 
 pprint(response)
diff --git a/voice/receive-an-inbound-call.py b/voice/receive-an-inbound-call.py
@@ -4,8 +4,9 @@
 app = FastAPI()
 
 
-@app.get('/answer')
+@app.get('/webhooks/answer')
 async def answer_call(from_: str = Query(..., alias='from')):
+    from_ = '-'.join(from_)
     return [
         Talk(text=f'Thank you for calling from {from_}').model_dump(
             by_alias=True, exclude_none=True
diff --git a/voice/record-a-call-with-split-audio.py b/voice/record-a-call-with-split-audio.py
@@ -3,32 +3,27 @@
 from dotenv import load_dotenv
 from fastapi import FastAPI, Body
 from pprint import pprint
-from vonage_voice import Connect, NccoAction, PhoneEndpoint, Record, Talk
+from vonage_voice import Connect, NccoAction, PhoneEndpoint, Record
 
 dotenv_path = join(dirname(__file__), '../.env')
 load_dotenv(dotenv_path)
 
 VONAGE_VIRTUAL_NUMBER = os.environ.get('VONAGE_VIRTUAL_NUMBER')
-RECIPIENT_NUMBER = os.environ.get('RECIPIENT_NUMBER')
+VOICE_TO_NUMBER = os.environ.get('VOICE_TO_NUMBER')
 
 app = FastAPI()
 
 
 @app.get('/webhooks/answer')
 async def inbound_call():
     ncco: list[NccoAction] = [
-        Talk(
-            text=f'Hi, we will shortly forward your call. This call is recorded for quality assurance purposes.'
-        ),
         Record(
             split='conversation',
             channels=2,
             eventUrl=['https://demo.ngrok.io/webhooks/recordings'],
         ),
         Connect(
-            endpoint=[PhoneEndpoint(number=RECIPIENT_NUMBER)],
-            from_=VONAGE_VIRTUAL_NUMBER,
-            eventUrl=['https://demo.ngrok.io/webhooks/event'],
+            from_=VONAGE_VIRTUAL_NUMBER, endpoint=[PhoneEndpoint(number=VOICE_TO_NUMBER)]
         ),
     ]
 
diff --git a/voice/record-a-call.py b/voice/record-a-call.py
@@ -3,28 +3,23 @@
 from dotenv import load_dotenv
 from fastapi import FastAPI, Body
 from pprint import pprint
-from vonage_voice import Connect, NccoAction, PhoneEndpoint, Record, Talk
+from vonage_voice import Connect, NccoAction, PhoneEndpoint, Record
 
 dotenv_path = join(dirname(__file__), '../.env')
 load_dotenv(dotenv_path)
 
 VONAGE_VIRTUAL_NUMBER = os.environ.get('VONAGE_VIRTUAL_NUMBER')
-RECIPIENT_NUMBER = os.environ.get('RECIPIENT_NUMBER')
+VOICE_TO_NUMBER = os.environ.get('VOICE_TO_NUMBER')
 
 app = FastAPI()
 
 
 @app.get('/webhooks/answer')
 async def inbound_call():
     ncco: list[NccoAction] = [
-        Talk(
-            text=f'Hi, we will shortly forward your call. This call is recorded for quality assurance purposes.'
-        ),
         Record(eventUrl=['https://demo.ngrok.io/webhooks/recordings']),
         Connect(
-            endpoint=[PhoneEndpoint(number=RECIPIENT_NUMBER)],
-            from_=VONAGE_VIRTUAL_NUMBER,
-            eventUrl=['https://demo.ngrok.io/webhooks/event'],
+            from_=VONAGE_VIRTUAL_NUMBER, endpoint=[PhoneEndpoint(number=VOICE_TO_NUMBER)]
         ),
     ]
 
diff --git a/voice/record-a-conversation.py b/voice/record-a-conversation.py
@@ -1,19 +1,27 @@
+import os
+from os.path import join, dirname
+from dotenv import load_dotenv
 from fastapi import FastAPI, Body
 from pprint import pprint
+from vonage_voice import Conversation
+
+dotenv_path = join(dirname(__file__), '../.env')
+load_dotenv(dotenv_path)
+
+VOICE_CONFERENCE_NAME = os.environ.get('VOICE_CONFERENCE_NAME')
 
 app = FastAPI()
 
 
 @app.get('/webhooks/answer')
 async def answer_call():
     ncco = [
-        {
-            "action": "conversation",
-            "name": "CONF_NAME",
-            "record": "true",
-            "eventMethod": "POST",
-            "eventUrl": ["https://demo.ngrok.io/webhooks/recordings"],
-        }
+        Conversation(
+            name=VOICE_CONFERENCE_NAME,
+            record=True,
+            eventMethod='POST',
+            eventUrl=['https://demo.ngrok.io/webhooks/recordings'],
+        )
     ]
 
     return ncco
diff --git a/voice/record-a-message.py b/voice/record-a-message.py
@@ -9,13 +9,16 @@
 async def answer_call(request: Request):
     print(request.base_url)
     ncco: list[NccoAction] = [
-        Talk(text='Please leave a message after the tone, then press the hash key.'),
+        Talk(
+            text='Please leave a message after the tone, then press #. We will get back to you as soon as we can.'
+        ),
         Record(
+            endOnSilence=3,
             endOnKey='#',
             beepStart=True,
-            eventUrl=[str(request.base_url) + '/webhooks/recordings'],
+            eventUrl=[str(request.base_url) + 'webhooks/recordings'],
         ),
-        Talk(text='Thank you for your message.'),
+        Talk(text='Thank you for your message. Goodbye.'),
     ]
 
     return [action.model_dump(by_alias=True, exclude_none=True) for action in ncco]
diff --git a/voice/retrieve-info-for-a-call.py b/voice/retrieve-info-for-a-call.py
@@ -8,7 +8,6 @@
 
 VONAGE_APPLICATION_ID = os.environ.get('VONAGE_APPLICATION_ID')
 VONAGE_PRIVATE_KEY = os.environ.get('VONAGE_PRIVATE_KEY')
-
 VOICE_CALL_ID = os.environ.get('VOICE_CALL_ID')
 
 from vonage import Auth, Vonage
diff --git a/voice/retrieve-info-for-all-calls.py b/voice/retrieve-info-for-all-calls.py
@@ -20,13 +20,13 @@
     )
 )
 
-
-NOW = datetime.now(timezone.utc)
-DATE_END = NOW.replace(microsecond=0).isoformat()
-DATE_START = (NOW - timedelta(hours=24, minutes=00)).replace(microsecond=0).isoformat()
+now = datetime.now(timezone.utc)
+date_end = now.strftime('%Y-%m-%dT%H:%M:%SZ')
+start = now - timedelta(hours=24)
+date_start = start.strftime('%Y-%m-%dT%H:%M:%SZ')
 
 calls, _ = client.voice.list_calls(
-    ListCallsFilter(date_start=DATE_START, date_end=DATE_END)
+    ListCallsFilter(date_start=date_start, date_end=date_end)
 )
 
 for call in calls:
diff --git a/voice/track-ncco.py b/voice/track-ncco.py
@@ -1,15 +1,6 @@
-import os
-from os.path import join, dirname
-from dotenv import load_dotenv
-from fastapi import FastAPI, Body, Request
+from fastapi import FastAPI, Request
 from vonage_voice import NccoAction, Notify, Talk
 
-dotenv_path = join(dirname(__file__), '../.env')
-load_dotenv(dotenv_path)
-
-VONAGE_VIRTUAL_NUMBER = os.environ.get('VONAGE_VIRTUAL_NUMBER')
-RECIPIENT_NUMBER = os.environ.get('RECIPIENT_NUMBER')
-
 app = FastAPI()
 
 
@@ -19,7 +10,7 @@ async def inbound_call(request: Request):
         Talk(text=f'Thanks for calling the notification line.'),
         Notify(
             payload={"foo": "bar"},
-            eventUrl=[str(request.base_url) + '/webhooks/notification'],
+            eventUrl=[str(request.base_url) + 'webhooks/notification'],
         ),
         Talk(text=f'You will never hear me as the notification URL will return an NCCO.'),
     ]
diff --git a/voice/transfer-a-call.py b/voice/transfer-a-call.py
diff --git a/voice/transfer-call-inline-ncco.py b/voice/transfer-call-inline-ncco.py

Original file line number	Diff line number	Diff line change
`@@ -8,8 +8,8 @@`
`8`	`8`
`9`	`9`	`VONAGE_APPLICATION_ID = os.environ.get('VONAGE_APPLICATION_ID')`
`10`	`10`	`VONAGE_PRIVATE_KEY = os.environ.get('VONAGE_PRIVATE_KEY')`
`11`		`-`
`12`	`11`	`VOICE_CALL_ID = os.environ.get('VOICE_CALL_ID')`
	`12`	`+VOICE_DTMF_DIGITS = os.environ.get('VOICE_DTMF_DIGITS')`
`13`	`13`
`14`	`14`	`from vonage import Auth, Vonage`
`15`	`15`	`from vonage_voice import CallMessage`
`@@ -23,7 +23,7 @@`
`23`	`23`	`)`
`24`	`24`
`25`	`25`	`response: CallMessage = client.voice.play_dtmf_into_call(`
`26`		`- uuid=VOICE_CALL_ID, dtmf='1234p*#'`
	`26`	`+ uuid=VOICE_CALL_ID, dtmf=VOICE_DTMF_DIGITS`
`27`	`27`	`)`
`28`	`28`
`29`	`29`	`pprint(response)`