one_msg_sdk 2.0.1 → 2.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 562955c57e7fee4e623a742fe09a8022223b43fe4110ae601550252e5477105a
-  data.tar.gz: 29353a857e5dc45bb81bdbef1cfe71de23a1681fa754f4096cf5a13f84d8172a
+  metadata.gz: e621154c3abcc77ef2dfd84a8915f9a9c5ab67e080f73056f4385db4e49c989f
+  data.tar.gz: 3e4949525bfa942af6783b5bb8f6d8f18fc6a80c6b3a6fab3038eb9626b7fe1a
 SHA512:
-  metadata.gz: 2b0576b002411912429b7f16c29ab33f9874625970e0861b13f1f6206960ba8f0ea9aa986953241535bbeb69a8c656aea716b68c5635893d261fc3da8af98666
-  data.tar.gz: d4d4f1813b1216f9fde934c27a016b562e8c04a682e0314d2131780de3018f9963015e0360a38e23f66f9ade749a99ecc1f2467cfb34b6de3375bb793eaf989e
+  metadata.gz: b728f01c730fc0ca3e842c384873d0c544cd0c9f56e06846bdd84913de1322578205e715d07b3fc4f29d4918678d20c63c7e6f2fd5298f33e98e1d3c061792a1
+  data.tar.gz: 5079ccd96f698b2942473a1f2cd87f55dd49d9024c7940f9fe1abbc7d0029bdac8cf55fb90842e9f5adf0e17800d9a5f8448c29114ba39f7e3894cbcce5284f1

data/AGENTS.md

@@ -10,7 +10,7 @@ package: "one_msg_sdk"
 registry: https://rubygems.org/gems/one_msg_sdk
 repository: https://github.com/1msg/1msg-sdk/tree/main/ruby
 language: Ruby
-version: 2.0.1
+version: 2.0.2
 public_only: true
 never_mention: chat-api
 ```
@@ -75,7 +75,7 @@ operationId: getCallingSettings
 http: GET /callingSettings
 clientGroup: calling
 summary: Get calling settings
-description: WhatsApp Calling API settings (beta). Requires Meta Calling enablement on the WABA. Not production-complete — paths and webhook field names may change. Trial/subscription-limited channels are blocked.
+description: Return WhatsApp Calling API settings for this channel (beta). Proxies upstream `GET /calling/settings`. **Prerequisites** - Number must be eligible for Meta Calling (Cloud API; not COEX) - Trial / `subscriptionBlocked` channels receive **403** plain text - You need your own WebRTC or SIP stack; 1msg is a **signaling proxy** only and does **not** store call history or recordings See the **Calling** tag overview for inbound/outbound flows and webhooks.
 responses: 200, 401, 500
 ```
 
@@ -85,8 +85,8 @@ responses: 200, 401, 500
 operationId: initiateCall
 http: POST /initiateCall
 clientGroup: calling
-summary: Initiate WhatsApp call
-description: Outbound Calling API (beta). Requires Meta Calling enablement and product consent. Not production-complete — verify on stage before relying on this in production. Trial/subscription-limited channels are blocked.
+summary: Call action (connect / pre_accept / accept / reject / terminate)
+description: Perform a WhatsApp Calling action (beta). Proxies upstream `POST /calling/calls`. Despite the historical path name `/initiateCall`, this endpoint handles **all** call actions: | action | Use | Required | |--------|-----|----------| | `connect` | Outbound business → user | `to` + `session` (`sdp_type: offer`) | | `pre_accept` | Inbound (optional, reduces audio clipping) | `call_id` + `session` (`sdp_type: answer`) | | `accept` | Inbound answer | `call_id` + `session` (`sdp_type: answer`) | | `reject` | Decline inbound | `call_id` | | `terminate` | Hang up | `call_id` | **SDP / media (critical)** - `accept` / `pre_accept` require a **WebRTC-generated SDP answer**. - Do **not** send Meta's offer SDP back as the answer. - Postman (or curl) alone **cannot** establish real media — you need a WebRTC or SIP stack. 1msg only proxies signaling. Answer within ~**30–60 seconds** of an inbound `connect` webhook or Meta terminates as unanswered. Common Meta errors include Calling not enabled (`138000`), no permission (`138006`), SDP validation failures. **Outbound** requires a prior Call Permission Request (CPR) acceptance. See the **Calling** tag overview for the full outbound flow and CPR limits. Trial / `subscriptionBlocked` → **403** plain text. Upstream failures often return HTTP 200 with `{ "response": { "error": "..." } }`.
 responses: 200, 401, 500
 ```
 
@@ -97,7 +97,7 @@ operationId: updateCallingSettings
 http: POST /callingSettings
 clientGroup: calling
 summary: Update calling settings
-description: Update WhatsApp Calling API settings (beta). Requires Meta Calling enablement. Trial/subscription-limited channels are blocked.
+description: Enable, disable, or update WhatsApp Calling settings (beta). Proxies upstream `POST /calling/settings`. Body is forwarded as-is (1msg does not validate fields). **Common fields under `calling`** - `status` (`ENABLED` | `DISABLED`) — required to turn calling on/off - `call_icon_visibility` (`DEFAULT` | `DISABLE_ALL`) — optional - `callback_permission_status` (`ENABLED` | `DISABLED`) — optional; when enabled, inbound user calls grant callback permission - `call_hours` — optional hours / timezone object - `sip` — optional SIP trunk; when SIP is ENABLED, Graph call actions and calling webhooks are not used - `srtp_key_exchange_protocol` (`DTLS` | `SDES`) — SDES only with SIP - `video.status` — optional Meta may accept only one feature group per request — prefer focused updates (e.g. enable status first, then SIP). Trial / `subscriptionBlocked` → **403** plain text.
 responses: 200, 401, 500
 ```
 
@@ -693,7 +693,7 @@ operationId: setWebhook
 http: POST /webhook
 clientGroup: webhooks
 summary: Set webhook URL
-description: Configure the client webhook URL for inbound events.
+description: Configure the client webhook URL for inbound events. WhatsApp **Calling** events (`field=calls`) are forwarded as passthrough payloads with `type: "calls"` and `instanceId` (connect / status / terminate). Call permission replies arrive on the normal messages path (`call_permission_reply`). Details: **Calling** tag.
 responses: 200, 401, 500
 ```
 

data/README.md

@@ -1,6 +1,6 @@
-# 1msg Ruby SDK
+# 1MSG Ruby SDK
 
-Official Ruby SDK for the **1msg WhatsApp Business API**.
+Official Ruby SDK for the **1MSG WhatsApp Business API**.
 
 This document is generated from the public OpenAPI contract. It covers install,
 auth, quick start, and every public operation available in the client.
@@ -21,7 +21,7 @@ auth, quick start, and every public operation available in the client.
 ## Install
 
 ```bash
-gem install one_msg_sdk -v 2.0.1
+gem install one_msg_sdk -v 2.0.2
 ```
 
 ## Requirements
@@ -100,7 +100,7 @@ API groups: calling, catalog, channel, flows, groups, messaging, profile, templa
 
 Get calling settings
 
-WhatsApp Calling API settings (beta). Requires Meta Calling enablement on the WABA. Not production-complete — paths and webhook field names may change. Trial/subscription-limited channels are blocked.
+Return WhatsApp Calling API settings for this channel (beta). Proxies upstream `GET /calling/settings`. **Prerequisites** - Number must be eligible for Meta Calling (Cloud API; not COEX) - Trial / `subscriptionBlocked` channels receive **403** plain text - You need your own WebRTC or SIP stack; 1msg is a **signaling proxy** only and does **not** store call history or recordings See the **Calling** tag overview for inbound/outbound flows and webhooks.
 
 ```yaml
 http: GET /callingSettings
@@ -111,9 +111,9 @@ responses: 200, 401, 500
 
 #### `initiateCall`
 
-Initiate WhatsApp call
+Call action (connect / pre_accept / accept / reject / terminate)
 
-Outbound Calling API (beta). Requires Meta Calling enablement and product consent. Not production-complete — verify on stage before relying on this in production. Trial/subscription-limited channels are blocked.
+Perform a WhatsApp Calling action (beta). Proxies upstream `POST /calling/calls`. Despite the historical path name `/initiateCall`, this endpoint handles **all** call actions: | action | Use | Required | |--------|-----|----------| | `connect` | Outbound business → user | `to` + `session` (`sdp_type: offer`) | | `pre_accept` | Inbound (optional, reduces audio clipping) | `call_id` + `session` (`sdp_type: answer`) | | `accept` | Inbound answer | `call_id` + `session` (`sdp_type: answer`) | | `reject` | Decline inbound | `call_id` | | `terminate` | Hang up | `call_id` | **SDP / media (critical)** - `accept` / `pre_accept` require a **WebRTC-generated SDP answer**. - Do **not** send Meta's offer SDP back as the answer. - Postman (or curl) alone **cannot** establish real media — you need a WebRTC or SIP stack. 1msg only proxies signaling. Answer within ~**30–60 seconds** of an inbound `connect` webhook or Meta terminates as unanswered. Common Meta errors include Calling not enabled (`138000`), no permission (`138006`), SDP validation failures. **Outbound** requires a prior Call Permission Request (CPR) acceptance. See the **Calling** tag overview for the full outbound flow and CPR limits. Trial / `subscriptionBlocked` → **403** plain text. Upstream failures often return HTTP 200 with `{ "response": { "error": "..." } }`.
 
 ```yaml
 http: POST /initiateCall
@@ -126,7 +126,7 @@ responses: 200, 401, 500
 
 Update calling settings
 
-Update WhatsApp Calling API settings (beta). Requires Meta Calling enablement. Trial/subscription-limited channels are blocked.
+Enable, disable, or update WhatsApp Calling settings (beta). Proxies upstream `POST /calling/settings`. Body is forwarded as-is (1msg does not validate fields). **Common fields under `calling`** - `status` (`ENABLED` | `DISABLED`) — required to turn calling on/off - `call_icon_visibility` (`DEFAULT` | `DISABLE_ALL`) — optional - `callback_permission_status` (`ENABLED` | `DISABLED`) — optional; when enabled, inbound user calls grant callback permission - `call_hours` — optional hours / timezone object - `sip` — optional SIP trunk; when SIP is ENABLED, Graph call actions and calling webhooks are not used - `srtp_key_exchange_protocol` (`DTLS` | `SDES`) — SDES only with SIP - `video.status` — optional Meta may accept only one feature group per request — prefer focused updates (e.g. enable status first, then SIP). Trial / `subscriptionBlocked` → **403** plain text.
 
 ```yaml
 http: POST /callingSettings
@@ -823,7 +823,7 @@ responses: 200, 401, 500
 
 Set webhook URL
 
-Configure the client webhook URL for inbound events.
+Configure the client webhook URL for inbound events. WhatsApp **Calling** events (`field=calls`) are forwarded as passthrough payloads with `type: "calls"` and `instanceId` (connect / status / terminate). Call permission replies arrive on the normal messages path (`call_permission_reply`). Details: **Calling** tag.
 
 ```yaml
 http: POST /webhook

data/docs/CallingApi.md

@@ -5,17 +5,17 @@ All URIs are relative to *https://api.1msg.io*
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
 | [**get_calling_settings**](CallingApi.md#get_calling_settings) | **GET** /callingSettings | Get calling settings |
-| [**initiate_call**](CallingApi.md#initiate_call) | **POST** /initiateCall | Initiate WhatsApp call |
+| [**initiate_call**](CallingApi.md#initiate_call) | **POST** /initiateCall | Call action (connect / pre_accept / accept / reject / terminate) |
 | [**update_calling_settings**](CallingApi.md#update_calling_settings) | **POST** /callingSettings | Update calling settings |
 
 
 ## get_calling_settings
 
-> Hash<String, Object> get_calling_settings(token)
+> <CallingSettings> get_calling_settings(token)
 
 Get calling settings
 
-WhatsApp Calling API settings (beta). Requires Meta Calling enablement on the WABA. Not production-complete — paths and webhook field names may change. Trial/subscription-limited channels are blocked. 
+Return WhatsApp Calling API settings for this channel (beta).  Proxies upstream `GET /calling/settings`.  **Prerequisites** - Number must be eligible for Meta Calling (Cloud API; not COEX) - Trial / `subscriptionBlocked` channels receive **403** plain text - You need your own WebRTC or SIP stack; 1msg is a **signaling proxy** only   and does **not** store call history or recordings  See the **Calling** tag overview for inbound/outbound flows and webhooks. 
 
 ### Examples
 
@@ -46,7 +46,7 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Hash&lt;String, Object&gt;, Integer, Hash)> get_calling_settings_with_http_info(token)
+> <Array(<CallingSettings>, Integer, Hash)> get_calling_settings_with_http_info(token)
 
 ```ruby
 begin
@@ -54,7 +54,7 @@ begin
   data, status_code, headers = api_instance.get_calling_settings_with_http_info(token)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Hash&lt;String, Object&gt;
+  p data # => <CallingSettings>
 rescue OneMsgSdk::ApiError => e
   puts "Error when calling CallingApi->get_calling_settings_with_http_info: #{e}"
 end
@@ -68,7 +68,7 @@ end
 
 ### Return type
 
-**Hash&lt;String, Object&gt;**
+[**CallingSettings**](CallingSettings.md)
 
 ### Authorization
 
@@ -82,11 +82,11 @@ end
 
 ## initiate_call
 
-> Hash&lt;String, Object&gt; initiate_call(token, opts)
+> <InitiateCallResponse> initiate_call(token, initiate_call_request)
 
-Initiate WhatsApp call
+Call action (connect / pre_accept / accept / reject / terminate)
 
-Outbound Calling API (beta). Requires Meta Calling enablement and product consent. Not production-complete — verify on stage before relying on this in production. Trial/subscription-limited channels are blocked. 
+Perform a WhatsApp Calling action (beta).  Proxies upstream `POST /calling/calls`. Despite the historical path name `/initiateCall`, this endpoint handles **all** call actions:  | action | Use | Required | |--------|-----|----------| | `connect` | Outbound business → user | `to` + `session` (`sdp_type: offer`) | | `pre_accept` | Inbound (optional, reduces audio clipping) | `call_id` + `session` (`sdp_type: answer`) | | `accept` | Inbound answer | `call_id` + `session` (`sdp_type: answer`) | | `reject` | Decline inbound | `call_id` | | `terminate` | Hang up | `call_id` |  **SDP / media (critical)** - `accept` / `pre_accept` require a **WebRTC-generated SDP answer**. - Do **not** send Meta's offer SDP back as the answer. - Postman (or curl) alone **cannot** establish real media — you need a   WebRTC or SIP stack. 1msg only proxies signaling.  Answer within ~**30–60 seconds** of an inbound `connect` webhook or Meta terminates as unanswered. Common Meta errors include Calling not enabled (`138000`), no permission (`138006`), SDP validation failures.  **Outbound** requires a prior Call Permission Request (CPR) acceptance. See the **Calling** tag overview for the full outbound flow and CPR limits.  Trial / `subscriptionBlocked` → **403** plain text. Upstream failures often return HTTP 200 with `{ \"response\": { \"error\": \"...\" } }`. 
 
 ### Examples
 
@@ -103,13 +103,11 @@ end
 
 api_instance = OneMsgSdk::CallingApi.new
 token = 'token_example' # String | JWT token or API key for authorization
-opts = {
-  request_body: { key: 3.56} # Hash<String, Object> | 
-}
+initiate_call_request = OneMsgSdk::InitiateCallRequest.new({messaging_product: 'whatsapp', action: 'connect'}) # InitiateCallRequest | 
 
 begin
-  # Initiate WhatsApp call
-  result = api_instance.initiate_call(token, opts)
+  # Call action (connect / pre_accept / accept / reject / terminate)
+  result = api_instance.initiate_call(token, initiate_call_request)
   p result
 rescue OneMsgSdk::ApiError => e
   puts "Error when calling CallingApi->initiate_call: #{e}"
@@ -120,15 +118,15 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Hash&lt;String, Object&gt;, Integer, Hash)> initiate_call_with_http_info(token, opts)
+> <Array(<InitiateCallResponse>, Integer, Hash)> initiate_call_with_http_info(token, initiate_call_request)
 
 ```ruby
 begin
-  # Initiate WhatsApp call
-  data, status_code, headers = api_instance.initiate_call_with_http_info(token, opts)
+  # Call action (connect / pre_accept / accept / reject / terminate)
+  data, status_code, headers = api_instance.initiate_call_with_http_info(token, initiate_call_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Hash&lt;String, Object&gt;
+  p data # => <InitiateCallResponse>
 rescue OneMsgSdk::ApiError => e
   puts "Error when calling CallingApi->initiate_call_with_http_info: #{e}"
 end
@@ -139,11 +137,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **token** | **String** | JWT token or API key for authorization |  |
-| **request_body** | [**Hash&lt;String, Object&gt;**](Object.md) |  | [optional] |
+| **initiate_call_request** | [**InitiateCallRequest**](InitiateCallRequest.md) |  |  |
 
 ### Return type
 
-**Hash&lt;String, Object&gt;**
+[**InitiateCallResponse**](InitiateCallResponse.md)
 
 ### Authorization
 
@@ -157,11 +155,11 @@ end
 
 ## update_calling_settings
 
-> Hash&lt;String, Object&gt; update_calling_settings(token, opts)
+> <UpdateCallingSettings200Response> update_calling_settings(token, calling_settings)
 
 Update calling settings
 
-Update WhatsApp Calling API settings (beta). Requires Meta Calling enablement. Trial/subscription-limited channels are blocked. 
+Enable, disable, or update WhatsApp Calling settings (beta).  Proxies upstream `POST /calling/settings`. Body is forwarded as-is (1msg does not validate fields).  **Common fields under `calling`** - `status` (`ENABLED` | `DISABLED`) — required to turn calling on/off - `call_icon_visibility` (`DEFAULT` | `DISABLE_ALL`) — optional - `callback_permission_status` (`ENABLED` | `DISABLED`) — optional;   when enabled, inbound user calls grant callback permission - `call_hours` — optional hours / timezone object - `sip` — optional SIP trunk; when SIP is ENABLED, Graph call actions and   calling webhooks are not used - `srtp_key_exchange_protocol` (`DTLS` | `SDES`) — SDES only with SIP - `video.status` — optional  Meta may accept only one feature group per request — prefer focused updates (e.g. enable status first, then SIP).  Trial / `subscriptionBlocked` → **403** plain text. 
 
 ### Examples
 
@@ -178,13 +176,11 @@ end
 
 api_instance = OneMsgSdk::CallingApi.new
 token = 'token_example' # String | JWT token or API key for authorization
-opts = {
-  request_body: { key: 3.56} # Hash<String, Object> | 
-}
+calling_settings = OneMsgSdk::CallingSettings.new # CallingSettings | 
 
 begin
   # Update calling settings
-  result = api_instance.update_calling_settings(token, opts)
+  result = api_instance.update_calling_settings(token, calling_settings)
   p result
 rescue OneMsgSdk::ApiError => e
   puts "Error when calling CallingApi->update_calling_settings: #{e}"
@@ -195,15 +191,15 @@ end
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(Hash&lt;String, Object&gt;, Integer, Hash)> update_calling_settings_with_http_info(token, opts)
+> <Array(<UpdateCallingSettings200Response>, Integer, Hash)> update_calling_settings_with_http_info(token, calling_settings)
 
 ```ruby
 begin
   # Update calling settings
-  data, status_code, headers = api_instance.update_calling_settings_with_http_info(token, opts)
+  data, status_code, headers = api_instance.update_calling_settings_with_http_info(token, calling_settings)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => Hash&lt;String, Object&gt;
+  p data # => <UpdateCallingSettings200Response>
 rescue OneMsgSdk::ApiError => e
   puts "Error when calling CallingApi->update_calling_settings_with_http_info: #{e}"
 end
@@ -214,11 +210,11 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **token** | **String** | JWT token or API key for authorization |  |
-| **request_body** | [**Hash&lt;String, Object&gt;**](Object.md) |  | [optional] |
+| **calling_settings** | [**CallingSettings**](CallingSettings.md) |  |  |
 
 ### Return type
 
-**Hash&lt;String, Object&gt;**
+[**UpdateCallingSettings200Response**](UpdateCallingSettings200Response.md)
 
 ### Authorization
 

data/docs/CallingSettings.md

@@ -0,0 +1,18 @@
+# OneMsgSdk::CallingSettings
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **calling** | [**CallingSettingsCalling**](CallingSettingsCalling.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::CallingSettings.new(
+  calling: null
+)
+```
+

data/docs/CallingSettingsCalling.md

@@ -0,0 +1,38 @@
+# OneMsgSdk::CallingSettingsCalling
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** | Enable or disable Calling API on this number | [optional] |
+| **call_icon_visibility** | **String** | Controls call icon visibility in the WhatsApp client | [optional] |
+| **callback_permission_status** | **String** | When ENABLED, a user who calls your business automatically grants call permission for business-initiated callbacks (subject to Meta rules).  | [optional] |
+| **srtp_key_exchange_protocol** | **String** | SRTP key exchange. DTLS is default/recommended. SDES is only valid when SIP signaling is enabled.  | [optional] |
+| **call_hours** | [**CallingSettingsCallingCallHours**](CallingSettingsCallingCallHours.md) |  | [optional] |
+| **sip** | [**CallingSettingsCallingSip**](CallingSettingsCallingSip.md) |  | [optional] |
+| **video** | [**CallingSettingsCallingVideo**](CallingSettingsCallingVideo.md) |  | [optional] |
+| **audio** | [**CallingSettingsCallingAudio**](CallingSettingsCallingAudio.md) |  | [optional] |
+| **restrictions** | **Hash<String, Object>** | Calling restrictions (response-only) | [optional] |
+| **ip_addresses** | **Hash<String, Object>** | Meta media IP ranges (response-only) | [optional] |
+| **call_icons** | **Hash<String, Object>** | Call icon country restrictions (response-only) | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::CallingSettingsCalling.new(
+  status: ENABLED,
+  call_icon_visibility: DEFAULT,
+  callback_permission_status: ENABLED,
+  srtp_key_exchange_protocol: DTLS,
+  call_hours: null,
+  sip: null,
+  video: null,
+  audio: null,
+  restrictions: null,
+  ip_addresses: null,
+  call_icons: null
+)
+```
+

data/docs/CallingSettingsCallingAudio.md

@@ -0,0 +1,18 @@
+# OneMsgSdk::CallingSettingsCallingAudio
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::CallingSettingsCallingAudio.new(
+  status: null
+)
+```
+

data/docs/CallingSettingsCallingCallHours.md

@@ -0,0 +1,22 @@
+# OneMsgSdk::CallingSettingsCallingCallHours
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** |  | [optional] |
+| **timezone** | **String** |  | [optional] |
+| **day_of_week_start** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::CallingSettingsCallingCallHours.new(
+  status: ENABLED,
+  timezone: America/Los_Angeles,
+  day_of_week_start: MONDAY
+)
+```
+

data/docs/CallingSettingsCallingSip.md

@@ -0,0 +1,20 @@
+# OneMsgSdk::CallingSettingsCallingSip
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** |  | [optional] |
+| **servers** | [**Array<CallingSettingsCallingSipServersInner>**](CallingSettingsCallingSipServersInner.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::CallingSettingsCallingSip.new(
+  status: DISABLED,
+  servers: null
+)
+```
+

data/docs/CallingSettingsCallingSipServersInner.md

@@ -0,0 +1,28 @@
+# OneMsgSdk::CallingSettingsCallingSipServersInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **hostname** | **String** |  | [optional] |
+| **port** | **Integer** |  | [optional] |
+| **request_uri_user_params** | **Hash<String, String>** |  | [optional] |
+| **sip_user_password** | **String** | Present on GET when SIP credentials are returned by Meta | [optional] |
+| **password** | **String** | Alternate password field name from some Meta responses | [optional] |
+| **app_id** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::CallingSettingsCallingSipServersInner.new(
+  hostname: sip.example.com,
+  port: 5061,
+  request_uri_user_params: null,
+  sip_user_password: null,
+  password: null,
+  app_id: null
+)
+```
+

data/docs/CallingSettingsCallingVideo.md

@@ -0,0 +1,18 @@
+# OneMsgSdk::CallingSettingsCallingVideo
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **status** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::CallingSettingsCallingVideo.new(
+  status: null
+)
+```
+

data/docs/InitiateCallRequest.md

@@ -0,0 +1,28 @@
+# OneMsgSdk::InitiateCallRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **messaging_product** | **String** | Must be `whatsapp` |  |
+| **action** | **String** | Call control action |  |
+| **call_id** | **String** | WhatsApp call id from the inbound/outbound calls webhook (`calls[].id`). Required for `pre_accept`, `accept`, `reject`, `terminate`.  | [optional] |
+| **to** | **String** | Recipient WhatsApp user phone (digits, country code, no +). Required for outbound `connect`.  | [optional] |
+| **biz_opaque_callback_data** | **String** | Optional opaque string echoed on later call webhooks for correlation | [optional] |
+| **session** | [**InitiateCallRequestSession**](InitiateCallRequestSession.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::InitiateCallRequest.new(
+  messaging_product: whatsapp,
+  action: connect,
+  call_id: wacid.ABGGFjFVU2AfAgo6V-Hc5eCgK5Gh,
+  to: 12185552828,
+  biz_opaque_callback_data: order-123-callback,
+  session: null
+)
+```
+

data/docs/InitiateCallRequestSession.md

@@ -0,0 +1,20 @@
+# OneMsgSdk::InitiateCallRequestSession
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **sdp_type** | **String** | offer for outbound connect; answer for pre_accept/accept |  |
+| **sdp** | **String** | Full SDP (RFC 8866). Replace placeholders with SDP from your WebRTC stack. Must negotiate ICE, DTLS-SRTP, and OPUS for WhatsApp media.  |  |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::InitiateCallRequestSession.new(
+  sdp_type: offer,
+  sdp: [REPLACE_WITH_WEBRTC_SDP]
+)
+```
+

data/docs/InitiateCallResponse.md

@@ -0,0 +1,26 @@
+# OneMsgSdk::InitiateCallResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **messaging_product** | **String** |  | [optional] |
+| **success** | **Boolean** |  | [optional] |
+| **calls** | [**Array<InitiateCallResponseCallsInner>**](InitiateCallResponseCallsInner.md) | Present on outbound `connect` — contains the new call id | [optional] |
+| **result** | **String** | Legacy success marker when upstream returns an empty body | [optional] |
+| **response** | [**InitiateCallResponseResponse**](InitiateCallResponseResponse.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::InitiateCallResponse.new(
+  messaging_product: whatsapp,
+  success: true,
+  calls: null,
+  result: success,
+  response: null
+)
+```
+

data/docs/InitiateCallResponseCallsInner.md

@@ -0,0 +1,18 @@
+# OneMsgSdk::InitiateCallResponseCallsInner
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **id** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::InitiateCallResponseCallsInner.new(
+  id: wacid.HBgLMTIxODU1NTI4MjgVAgARGCAyODRQIAFRoA
+)
+```
+

data/docs/InitiateCallResponseResponse.md

@@ -0,0 +1,18 @@
+# OneMsgSdk::InitiateCallResponseResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **error** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::InitiateCallResponseResponse.new(
+  error: null
+)
+```
+

data/docs/UpdateCallingSettings200Response.md

@@ -0,0 +1,22 @@
+# OneMsgSdk::UpdateCallingSettings200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **success** | **Boolean** |  | [optional] |
+| **result** | **String** |  | [optional] |
+| **response** | [**UpdateCallingSettings200ResponseResponse**](UpdateCallingSettings200ResponseResponse.md) |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::UpdateCallingSettings200Response.new(
+  success: true,
+  result: success,
+  response: null
+)
+```
+

data/docs/UpdateCallingSettings200ResponseResponse.md

@@ -0,0 +1,18 @@
+# OneMsgSdk::UpdateCallingSettings200ResponseResponse
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **error** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'one_msg_sdk'
+
+instance = OneMsgSdk::UpdateCallingSettings200ResponseResponse.new(
+  error: null
+)
+```
+

data/docs/WebhooksApi.md

@@ -85,7 +85,7 @@ end
 
 Set webhook URL
 
-Configure the client webhook URL for inbound events.
+Configure the client webhook URL for inbound events.  WhatsApp **Calling** events (`field=calls`) are forwarded as passthrough payloads with `type: \"calls\"` and `instanceId` (connect / status / terminate). Call permission replies arrive on the normal messages path (`call_permission_reply`). Details: **Calling** tag. 
 
 ### Examples