add accept/reject/refer SIP calls to v1 client

Author: janligudzinski

src/v1/api.rs

@@ -7,6 +7,7 @@ use crate::v1::audio::{
     AudioTranslationRequest, AudioTranslationResponse,
 };
 use crate::v1::batch::{BatchResponse, CreateBatchRequest, ListBatchResponse};
+use crate::v1::calls::{AcceptCallRequest, ReferCallRequest};
 use crate::v1::chat_completion::{ChatCompletionRequest, ChatCompletionResponse};
 use crate::v1::common;
 use crate::v1::completion::{CompletionRequest, CompletionResponse};
@@ -796,6 +797,32 @@ impl OpenAIClient {
         self.delete(&format!("models/{model_id}")).await
     }
 
+    pub async fn accept_call(
+        &mut self,
+        call_id: &str,
+        accept: AcceptCallRequest,
+    ) -> Result<(), APIError> {
+        self.post::<()>(&format!("realtime/calls/{call_id}/accept"), &accept)
+            .await?;
+        Ok(())
+    }
+
+    pub async fn reject_call(&mut self, call_id: &str) -> Result<(), APIError> {
+        self.post::<()>(&format!("realtime/calls/{call_id}/reject"), &())
+            .await?;
+        Ok(())
+    }
+
+    pub async fn refer_call(
+        &mut self,
+        call_id: &str,
+        refer: ReferCallRequest,
+    ) -> Result<(), APIError> {
+        self.post::<()>(&format!("realtime/calls/{call_id}/refer"), &refer)
+            .await?;
+        Ok(())
+    }
+
     fn build_url_with_preserved_query(&self, path: &str) -> Result<String, url::ParseError> {
         let (base, query_opt) = match self.api_endpoint.split_once('?') {
             Some((b, q)) => (b.trim_end_matches('/'), Some(q)),

src/v1/calls.rs

@@ -0,0 +1,19 @@
+use serde::{Deserialize, Serialize};
+
+/// Used to start a realtime session based on an incoming call.
+/// Note that this is poorly documented by OpenAI with the only example data given in https://platform.openai.com/docs/guides/realtime-sip#handle-the-webhook and these may not be all the possible fields.
+#[derive(Debug, Serialize, Deserialize, Clone)]
+pub struct AcceptCallRequest {
+    /// This is *always* `realtime`.
+    #[serde(rename = "type")]
+    pub session_type: String,
+    pub instructions: String,
+    pub model: String,
+}
+
+/// Used to redirect a call to another number. Per https://platform.openai.com/docs/guides/realtime-sip#handle-the-webhook the Tel-URI scheme may be used.
+#[derive(Debug, Serialize, Deserialize, Clone)]
+pub struct ReferCallRequest {
+    /// The URI to redirect the call to, for example `tel:+14152909007`
+    pub target_uri: String,
+}

src/v1/mod.rs

@@ -4,6 +4,7 @@ pub mod types;
 
 pub mod audio;
 pub mod batch;
+pub mod calls;
 pub mod chat_completion;
 pub mod completion;
 pub mod edit;