구조적 변경: 음성 메시지 단건 전송 예제 추가

- 음성 메시지 전송을 위한 새로운 예제 파일 `message_send_voice.rs` 추가: 환경 변수 설정 및 SOLAPI 클라이언트를 사용한 메시지 전송 로직 구현.
- 예제 실행 방법 및 환경 변수 설정에 대한 주석 추가: 사용자에게 필요한 정보를 명확히 제공하여 예제 사용을 용이하게 함.

Author: Palbahngmiyine

examples/message_send_voice.rs

@@ -0,0 +1,83 @@
+//! 음성 메시지 단건 전송 예제
+//!
+//! 실행 방법:
+//! ```bash
+//! cargo run --example message_send_voice
+//! ```
+//!
+//! 환경 변수 설정:
+//! ```bash
+//! export SOLAPI_API_KEY="your_api_key"
+//! export SOLAPI_API_SECRET="your_api_secret"
+//! export FROM_PHONE="01012345678"
+//! export TO_PHONE="01087654321"
+//! ```
+//! 음성 메시지와 관련된 설명은 https://developers.solapi.com/references/voice 를 참고 해 주세요!
+
+use solapi_rust::SolapiClient;
+
+fn main() {
+    // 환경 변수에서 API 키 및 전화번호 가져오기
+    let api_key =
+        std::env::var("SOLAPI_API_KEY").expect("환경 변수 SOLAPI_API_KEY가 설정되지 않았습니다");
+    let api_secret = std::env::var("SOLAPI_API_SECRET")
+        .expect("환경 변수 SOLAPI_API_SECRET가 설정되지 않았습니다");
+    let from_phone =
+        std::env::var("FROM_PHONE").expect("환경 변수 FROM_PHONE이 설정되지 않았습니다");
+    let to_phone = std::env::var("TO_PHONE").expect("환경 변수 TO_PHONE이 설정되지 않았습니다");
+
+    // SOLAPI 클라이언트 생성
+    let client = SolapiClient::new(api_key, api_secret);
+    let message_service = client.message_service();
+
+    // SMS 전송 요청 생성 (빌더 패턴 사용)
+    let message = solapi_rust::message::Message::new(&to_phone)
+        .from(&from_phone)
+        .text("안녕하세요! SOLAPI Rust SDK 테스트 메시지입니다.")
+        .message_type(solapi_rust::message::MessageType::Voice)
+        .voice_options(
+            solapi_rust::message::VoiceOption::new()
+                .voice_type(solapi_rust::message::VoiceType::Female), // 첫 안내 메시지 설정
+                                                                      // .header_message("안녕하세요")
+                                                                      // 마지막 안내 메시지 설정
+                                                                      // .tail_message("감사합니다")
+                                                                      // 응답 범위 설정 1~9까지 설정 가능, 값 설정시 해당 값을 설정한 범위까지 만큼 수신자가 키패드로 입력할 수 있습니다. 예) 5로 설정한 경우 1~5까지 수신자가 입력가능
+                                                                      // .reply_range(5)
+                                                                      // 상담원 번호 설정, reply_range와 counselor_number는 동시에 설정될 수 없습니다.
+                                                                      //.counselor_number("01012345678"),
+        );
+
+    let request = solapi_rust::message::SendRequest {
+        messages: vec![message],
+        allow_duplicates: None,
+        scheduled_date: None,
+        show_message_list: None,
+    };
+
+    // 메시지 전송
+    println!("메시지를 전송합니다...");
+    println!("발신번호: {}", from_phone);
+    println!("수신번호: {}", to_phone);
+
+    match message_service.send_blocking(request) {
+        Ok(response) => {
+            println!("\n✓ 메시지 전송 성공!");
+            println!("그룹 ID: {}", response.group_info.group_id);
+            println!("상태: {}", response.group_info.status);
+            println!("총 메시지 수: {}", response.group_info.count.total);
+            println!("성공: {}", response.group_info.count.registered_success);
+            println!("실패: {}", response.group_info.count.registered_failed);
+
+            if !response.failed_message_list.is_empty() {
+                println!("\n⚠ 실패한 메시지:");
+                for failed in response.failed_message_list {
+                    println!("  - {}: {}", failed.to, failed.status_message);
+                }
+            }
+        }
+        Err(e) => {
+            eprintln!("\n✗ 메시지 전송 실패!");
+            eprintln!("오류: {:?}", e);
+        }
+    }
+}