late-sdk 0.0.885 → 0.0.886

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 75fb17790df9caf832bb06f2385eef8f24af0597d699ae4afb5322b164dd4e91
-  data.tar.gz: 111fc8a8697a57ad13787d86a2f51cb123ac8c7d12646e601af3310ff56b08a7
+  metadata.gz: d7378a09c5bdcdd3978b1bdd9e5f840ddcaeae7fc5b45b5141548f98caec6cb7
+  data.tar.gz: 6ff1740774c1638c0dbfb2debe93f0102635e1dda6d04de2e449163375445656
 SHA512:
-  metadata.gz: ce903f282af9659163e9741da49aa1833b624ad68c11a3220c51ce698b8a3f6f3565bba7c3e51fd7520b37314e457a9ab107fbc4d9d5c5c2873d22c1a9ea6567
-  data.tar.gz: 302b4f1b08f3a5b2ad3c2db4dd0043015e36eac2a3a1d7ec3a9a51d5b71d90a91fa32e191d8a75d0faadd0d96e9501c9c1eaaef8e8aec96a61407ddd5c09ea3b
+  metadata.gz: 468d185a712d5f151df32061507b09f12ddfc930879b0ecc3fae651deabb0bdd0c4fae889fa547abac10bacc63b83bd13b1d5679f36c9e3f1b9109f7839bc461
+  data.tar.gz: 28024e1c1486bce4c46de6c97b3473350e0b9a13692773579e365bf5b65c1a02932ecd17c01d765c8e0166dabf64f3af4d6c81194ba47669614e952e565824f1

data/README.md

@@ -679,6 +679,7 @@ Class | Method | HTTP request | Description
 *Zernio::WhatsAppApi* | [**register_whats_app_number**](docs/WhatsAppApi.md#register_whats_app_number) | **POST** /v1/accounts/{accountId}/whatsapp/register | Register a connected WhatsApp number on the Cloud API
 *Zernio::WhatsAppApi* | [**reject_whats_app_group_join_requests**](docs/WhatsAppApi.md#reject_whats_app_group_join_requests) | **DELETE** /v1/whatsapp/wa-groups/{groupId}/join-requests | Reject join requests
 *Zernio::WhatsAppApi* | [**remove_whats_app_group_participants**](docs/WhatsAppApi.md#remove_whats_app_group_participants) | **DELETE** /v1/whatsapp/wa-groups/{groupId}/participants | Remove participants
+*Zernio::WhatsAppApi* | [**request_whats_app_verification_code**](docs/WhatsAppApi.md#request_whats_app_verification_code) | **POST** /v1/accounts/{accountId}/whatsapp/request-code | Request a Meta re-verification code for a BYO WhatsApp number
 *Zernio::WhatsAppApi* | [**send_whats_app_conversion**](docs/WhatsAppApi.md#send_whats_app_conversion) | **POST** /v1/whatsapp/conversions | Send WhatsApp conversion event
 *Zernio::WhatsAppApi* | [**set_whatsapp_business_username**](docs/WhatsAppApi.md#set_whatsapp_business_username) | **POST** /v1/whatsapp/business-profile/username | Set business username
 *Zernio::WhatsAppApi* | [**unblock_whats_app_users**](docs/WhatsAppApi.md#unblock_whats_app_users) | **DELETE** /v1/whatsapp/block-users | Unblock users
@@ -688,6 +689,7 @@ Class | Method | HTTP request | Description
 *Zernio::WhatsAppApi* | [**update_whats_app_template**](docs/WhatsAppApi.md#update_whats_app_template) | **PATCH** /v1/whatsapp/templates/{templateName} | Update template
 *Zernio::WhatsAppApi* | [**update_whats_app_template_by_id**](docs/WhatsAppApi.md#update_whats_app_template_by_id) | **PATCH** /v1/whatsapp/templates/id/{templateId} | Update template by id
 *Zernio::WhatsAppApi* | [**upload_whats_app_profile_photo**](docs/WhatsAppApi.md#upload_whats_app_profile_photo) | **POST** /v1/whatsapp/business-profile/photo | Upload profile picture
+*Zernio::WhatsAppApi* | [**verify_whats_app_number**](docs/WhatsAppApi.md#verify_whats_app_number) | **POST** /v1/accounts/{accountId}/whatsapp/verify-code | Verify the Meta re-verification code for a BYO WhatsApp number
 *Zernio::WhatsAppCallingApi* | [**disable_whats_app_calling**](docs/WhatsAppCallingApi.md#disable_whats_app_calling) | **DELETE** /v1/phone-numbers/{id}/whatsapp/calling | Disable calling on a number
 *Zernio::WhatsAppCallingApi* | [**disable_whats_app_calling_legacy**](docs/WhatsAppCallingApi.md#disable_whats_app_calling_legacy) | **DELETE** /v1/whatsapp/phone-numbers/{id}/calling | Disable calling on a number
 *Zernio::WhatsAppCallingApi* | [**enable_whats_app_calling**](docs/WhatsAppCallingApi.md#enable_whats_app_calling) | **POST** /v1/phone-numbers/{id}/whatsapp/calling | Enable calling on a number
@@ -2047,6 +2049,8 @@ Class | Method | HTTP request | Description
  - [Zernio::ReplyToPhoneNumberReviewerRequestAttachmentsInner](docs/ReplyToPhoneNumberReviewerRequestAttachmentsInner.md)
  - [Zernio::RequestSmsSenderIdLimitIncrease200Response](docs/RequestSmsSenderIdLimitIncrease200Response.md)
  - [Zernio::RequestSmsSenderIdLimitIncreaseRequest](docs/RequestSmsSenderIdLimitIncreaseRequest.md)
+ - [Zernio::RequestWhatsAppVerificationCode200Response](docs/RequestWhatsAppVerificationCode200Response.md)
+ - [Zernio::RequestWhatsAppVerificationCodeRequest](docs/RequestWhatsAppVerificationCodeRequest.md)
  - [Zernio::ResendSmsRegistrationOtp200Response](docs/ResendSmsRegistrationOtp200Response.md)
  - [Zernio::ReserveRfPrediction201Response](docs/ReserveRfPrediction201Response.md)
  - [Zernio::ReserveRfPredictionRequest](docs/ReserveRfPredictionRequest.md)
@@ -2525,6 +2529,8 @@ Class | Method | HTTP request | Description
  - [Zernio::VerifySmsRegistrationOtp200Response](docs/VerifySmsRegistrationOtp200Response.md)
  - [Zernio::VerifySmsRegistrationOtpRequest](docs/VerifySmsRegistrationOtpRequest.md)
  - [Zernio::VerifyWhatsAppCallerIdRequest](docs/VerifyWhatsAppCallerIdRequest.md)
+ - [Zernio::VerifyWhatsAppNumber200Response](docs/VerifyWhatsAppNumber200Response.md)
+ - [Zernio::VerifyWhatsAppNumberRequest](docs/VerifyWhatsAppNumberRequest.md)
  - [Zernio::VoteRedditThingRequest](docs/VoteRedditThingRequest.md)
  - [Zernio::Webhook](docs/Webhook.md)
  - [Zernio::WebhookLog](docs/WebhookLog.md)

data/docs/CreateCommentAutomationRequest.md

@@ -8,7 +8,7 @@
 | **account_id** | **String** | Instagram or Facebook account ID |  |
 | **trigger** | **String** | What fires the automation. 'comment' (keyword comment on a post) or 'story_reply' (keyword reply to an Instagram story). For 'story_reply', platformPostId is the story media id (omit for any story). | [optional][default to 'comment'] |
 | **platform_post_id** | **String** | Platform media/post ID (or story media id when trigger=story_reply). Omit for an account-wide (any-post / any-story) automation. | [optional] |
-| **post_id** | **String** | Zernio post ID. Required only when also targeting a specific post via platformPostId. | [optional] |
+| **post_id** | **String** | Zernio post ID. Optional and never required. Use it INSTEAD of platformPostId to bind a per-post automation to a not-yet-published Zernio post: the automation stays pending and arms itself when that post publishes. For a post already live on the platform, pass platformPostId alone and omit this. | [optional] |
 | **post_title** | **String** | Post content snippet for display | [optional] |
 | **name** | **String** | Automation label |  |
 | **keywords** | **Array<String>** | Trigger keywords (empty = any comment triggers) | [optional] |

data/docs/RegisterWhatsAppNumberRequest.md

@@ -4,7 +4,7 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **pin** | **String** | The 6-digit two-step verification PIN set on the number. Omit it only if the number has no PIN of its own. | [optional] |
+| **pin** | **String** | The 6-digit two-step verification PIN set on the number. Omitting it applies Zernio's managed default registration PIN, the same one every Embedded Signup connect sets automatically. | [optional] |
 
 ## Example
 

data/docs/RequestWhatsAppVerificationCode200Response.md

@@ -0,0 +1,26 @@
+# Zernio::RequestWhatsAppVerificationCode200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **requested** | **Boolean** |  | [optional] |
+| **already_active** | **Boolean** |  | [optional] |
+| **method** | **String** |  | [optional] |
+| **account_id** | **String** |  | [optional] |
+| **phone_number_id** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::RequestWhatsAppVerificationCode200Response.new(
+  requested: null,
+  already_active: null,
+  method: null,
+  account_id: null,
+  phone_number_id: null
+)
+```
+

data/docs/RequestWhatsAppVerificationCodeRequest.md

@@ -0,0 +1,20 @@
+# Zernio::RequestWhatsAppVerificationCodeRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **method** | **String** |  | [optional][default to 'SMS'] |
+| **language** | **String** | Meta locale code for the verification message, e.g. en_US. | [optional][default to 'en_US'] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::RequestWhatsAppVerificationCodeRequest.new(
+  method: null,
+  language: null
+)
+```
+

data/docs/VerifyWhatsAppNumber200Response.md

@@ -0,0 +1,22 @@
+# Zernio::VerifyWhatsAppNumber200Response
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **verified** | **Boolean** |  | [optional] |
+| **account_id** | **String** |  | [optional] |
+| **phone_number_id** | **String** |  | [optional] |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::VerifyWhatsAppNumber200Response.new(
+  verified: null,
+  account_id: null,
+  phone_number_id: null
+)
+```
+

data/docs/VerifyWhatsAppNumberRequest.md

@@ -0,0 +1,18 @@
+# Zernio::VerifyWhatsAppNumberRequest
+
+## Properties
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **code** | **String** | The 6-digit code Meta sent to the phone. Non-digit separators (e.g. \"749-456\") are stripped automatically. |  |
+
+## Example
+
+```ruby
+require 'zernio-sdk'
+
+instance = Zernio::VerifyWhatsAppNumberRequest.new(
+  code: null
+)
+```
+

data/docs/WhatsAppApi.md

@@ -34,6 +34,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**register_whats_app_number**](WhatsAppApi.md#register_whats_app_number) | **POST** /v1/accounts/{accountId}/whatsapp/register | Register a connected WhatsApp number on the Cloud API |
 | [**reject_whats_app_group_join_requests**](WhatsAppApi.md#reject_whats_app_group_join_requests) | **DELETE** /v1/whatsapp/wa-groups/{groupId}/join-requests | Reject join requests |
 | [**remove_whats_app_group_participants**](WhatsAppApi.md#remove_whats_app_group_participants) | **DELETE** /v1/whatsapp/wa-groups/{groupId}/participants | Remove participants |
+| [**request_whats_app_verification_code**](WhatsAppApi.md#request_whats_app_verification_code) | **POST** /v1/accounts/{accountId}/whatsapp/request-code | Request a Meta re-verification code for a BYO WhatsApp number |
 | [**send_whats_app_conversion**](WhatsAppApi.md#send_whats_app_conversion) | **POST** /v1/whatsapp/conversions | Send WhatsApp conversion event |
 | [**set_whatsapp_business_username**](WhatsAppApi.md#set_whatsapp_business_username) | **POST** /v1/whatsapp/business-profile/username | Set business username |
 | [**unblock_whats_app_users**](WhatsAppApi.md#unblock_whats_app_users) | **DELETE** /v1/whatsapp/block-users | Unblock users |
@@ -43,6 +44,7 @@ All URIs are relative to *https://zernio.com/api*
 | [**update_whats_app_template**](WhatsAppApi.md#update_whats_app_template) | **PATCH** /v1/whatsapp/templates/{templateName} | Update template |
 | [**update_whats_app_template_by_id**](WhatsAppApi.md#update_whats_app_template_by_id) | **PATCH** /v1/whatsapp/templates/id/{templateId} | Update template by id |
 | [**upload_whats_app_profile_photo**](WhatsAppApi.md#upload_whats_app_profile_photo) | **POST** /v1/whatsapp/business-profile/photo | Upload profile picture |
+| [**verify_whats_app_number**](WhatsAppApi.md#verify_whats_app_number) | **POST** /v1/accounts/{accountId}/whatsapp/verify-code | Verify the Meta re-verification code for a BYO WhatsApp number |
 
 
 ## add_whats_app_group_participants
@@ -2191,6 +2193,79 @@ end
 - **Accept**: application/json
 
 
+## request_whats_app_verification_code
+
+> <RequestWhatsAppVerificationCode200Response> request_whats_app_verification_code(account_id, opts)
+
+Request a Meta re-verification code for a BYO WhatsApp number
+
+For a bring-your-own WhatsApp number (its own WABA, migrated off another BSP) that Meta demoted to re-verification, this requests a new OTP from Meta. The code lands on the customer's own handset, so verifying it is necessarily self-service; call POST /v1/accounts/{accountId}/whatsapp/verify-code with the code once it arrives. Rate-limited to one request per 10 minutes per account, and Meta enforces its own cooldown on top of that. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'zernio-sdk'
+# setup authorization
+Zernio.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Zernio::WhatsAppApi.new
+account_id = 'account_id_example' # String | The WhatsApp account ID
+opts = {
+  request_whats_app_verification_code_request: Zernio::RequestWhatsAppVerificationCodeRequest.new # RequestWhatsAppVerificationCodeRequest | 
+}
+
+begin
+  # Request a Meta re-verification code for a BYO WhatsApp number
+  result = api_instance.request_whats_app_verification_code(account_id, opts)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling WhatsAppApi->request_whats_app_verification_code: #{e}"
+end
+```
+
+#### Using the request_whats_app_verification_code_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<RequestWhatsAppVerificationCode200Response>, Integer, Hash)> request_whats_app_verification_code_with_http_info(account_id, opts)
+
+```ruby
+begin
+  # Request a Meta re-verification code for a BYO WhatsApp number
+  data, status_code, headers = api_instance.request_whats_app_verification_code_with_http_info(account_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <RequestWhatsAppVerificationCode200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling WhatsAppApi->request_whats_app_verification_code_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | The WhatsApp account ID |  |
+| **request_whats_app_verification_code_request** | [**RequestWhatsAppVerificationCodeRequest**](RequestWhatsAppVerificationCodeRequest.md) |  | [optional] |
+
+### Return type
+
+[**RequestWhatsAppVerificationCode200Response**](RequestWhatsAppVerificationCode200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
 ## send_whats_app_conversion
 
 > <SendWhatsAppConversion200Response> send_whats_app_conversion(send_whats_app_conversion_request)
@@ -2821,3 +2896,74 @@ end
 - **Content-Type**: multipart/form-data, application/json
 - **Accept**: application/json
 
+
+## verify_whats_app_number
+
+> <VerifyWhatsAppNumber200Response> verify_whats_app_number(account_id, verify_whats_app_number_request)
+
+Verify the Meta re-verification code for a BYO WhatsApp number
+
+Submits the OTP Meta sent in response to POST /v1/accounts/{accountId}/whatsapp/request-code. This only verifies the number with Meta; it does not register it on the Cloud API. Call POST /v1/accounts/{accountId}/whatsapp/register afterward to complete activation. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'zernio-sdk'
+# setup authorization
+Zernio.configure do |config|
+  # Configure Bearer authorization (JWT): bearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Zernio::WhatsAppApi.new
+account_id = 'account_id_example' # String | The WhatsApp account ID
+verify_whats_app_number_request = Zernio::VerifyWhatsAppNumberRequest.new({code: 'code_example'}) # VerifyWhatsAppNumberRequest | 
+
+begin
+  # Verify the Meta re-verification code for a BYO WhatsApp number
+  result = api_instance.verify_whats_app_number(account_id, verify_whats_app_number_request)
+  p result
+rescue Zernio::ApiError => e
+  puts "Error when calling WhatsAppApi->verify_whats_app_number: #{e}"
+end
+```
+
+#### Using the verify_whats_app_number_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<VerifyWhatsAppNumber200Response>, Integer, Hash)> verify_whats_app_number_with_http_info(account_id, verify_whats_app_number_request)
+
+```ruby
+begin
+  # Verify the Meta re-verification code for a BYO WhatsApp number
+  data, status_code, headers = api_instance.verify_whats_app_number_with_http_info(account_id, verify_whats_app_number_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <VerifyWhatsAppNumber200Response>
+rescue Zernio::ApiError => e
+  puts "Error when calling WhatsAppApi->verify_whats_app_number_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **account_id** | **String** | The WhatsApp account ID |  |
+| **verify_whats_app_number_request** | [**VerifyWhatsAppNumberRequest**](VerifyWhatsAppNumberRequest.md) |  |  |
+
+### Return type
+
+[**VerifyWhatsAppNumber200Response**](VerifyWhatsAppNumber200Response.md)
+
+### Authorization
+
+[bearerAuth](../README.md#bearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+

data/lib/zernio-sdk/api/whats_app_api.rb

@@ -2159,6 +2159,76 @@ module Zernio
       return data, status_code, headers
     end
 
+    # Request a Meta re-verification code for a BYO WhatsApp number
+    # For a bring-your-own WhatsApp number (its own WABA, migrated off another BSP) that Meta demoted to re-verification, this requests a new OTP from Meta. The code lands on the customer's own handset, so verifying it is necessarily self-service; call POST /v1/accounts/{accountId}/whatsapp/verify-code with the code once it arrives. Rate-limited to one request per 10 minutes per account, and Meta enforces its own cooldown on top of that. 
+    # @param account_id [String] The WhatsApp account ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [RequestWhatsAppVerificationCodeRequest] :request_whats_app_verification_code_request 
+    # @return [RequestWhatsAppVerificationCode200Response]
+    def request_whats_app_verification_code(account_id, opts = {})
+      data, _status_code, _headers = request_whats_app_verification_code_with_http_info(account_id, opts)
+      data
+    end
+
+    # Request a Meta re-verification code for a BYO WhatsApp number
+    # For a bring-your-own WhatsApp number (its own WABA, migrated off another BSP) that Meta demoted to re-verification, this requests a new OTP from Meta. The code lands on the customer's own handset, so verifying it is necessarily self-service; call POST /v1/accounts/{accountId}/whatsapp/verify-code with the code once it arrives. Rate-limited to one request per 10 minutes per account, and Meta enforces its own cooldown on top of that. 
+    # @param account_id [String] The WhatsApp account ID
+    # @param [Hash] opts the optional parameters
+    # @option opts [RequestWhatsAppVerificationCodeRequest] :request_whats_app_verification_code_request 
+    # @return [Array<(RequestWhatsAppVerificationCode200Response, Integer, Hash)>] RequestWhatsAppVerificationCode200Response data, response status code and response headers
+    def request_whats_app_verification_code_with_http_info(account_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WhatsAppApi.request_whats_app_verification_code ...'
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling WhatsAppApi.request_whats_app_verification_code"
+      end
+      # resource path
+      local_var_path = '/v1/accounts/{accountId}/whatsapp/request-code'.sub('{' + 'accountId' + '}', CGI.escape(account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'request_whats_app_verification_code_request'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'RequestWhatsAppVerificationCode200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WhatsAppApi.request_whats_app_verification_code",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WhatsAppApi#request_whats_app_verification_code\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Send WhatsApp conversion event
     # Forward a WhatsApp Business Messaging conversion event (`LeadSubmitted`, `Purchase`, `AddToCart`, `InitiateCheckout`, `ViewContent`) to Meta's Conversions API with `action_source = business_messaging` and `messaging_channel = whatsapp`. The endpoint looks up the originating CTWA click ID (`ctwa_clid`) captured on the first inbound message of the conversation and replays it on every event so Meta can attribute the conversion back to the Click-to-WhatsApp ad that drove the chat.  Configuration prerequisite on the WhatsApp account metadata:   - `metaCapiDatasetId`: the Meta dataset ID linked to the WABA.     Provision one with `POST /v1/whatsapp/dataset`.  The WABA ID (already set automatically at connect time) is forwarded as `user_data.whatsapp_business_account_id`, which is the per-channel attribution identifier Meta requires for WhatsApp events. No Facebook Page ID is needed (that field is the Messenger-branch identifier).  Identify the conversation by either `conversationId` (preferred) or `phoneE164` (digits only, no `+`). At least one is required. If the conversation has no captured `ctwa_clid`, the request returns 422 because there is nothing to attribute.  Token and dataset coupling: the WhatsApp account's accessToken must have access to the configured `metaCapiDatasetId`. By default a WABA's system-user token is scoped to the WABA's own Business Manager and cannot post to a pixel owned by a different Business; Meta returns code 100 in that case. Either share the dataset with the WhatsApp app's Business in BM, or use a dataset already in the same Business as the WABA. 
     # @param send_whats_app_conversion_request [SendWhatsAppConversionRequest] 
@@ -2803,5 +2873,79 @@ module Zernio
       end
       return data, status_code, headers
     end
+
+    # Verify the Meta re-verification code for a BYO WhatsApp number
+    # Submits the OTP Meta sent in response to POST /v1/accounts/{accountId}/whatsapp/request-code. This only verifies the number with Meta; it does not register it on the Cloud API. Call POST /v1/accounts/{accountId}/whatsapp/register afterward to complete activation. 
+    # @param account_id [String] The WhatsApp account ID
+    # @param verify_whats_app_number_request [VerifyWhatsAppNumberRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [VerifyWhatsAppNumber200Response]
+    def verify_whats_app_number(account_id, verify_whats_app_number_request, opts = {})
+      data, _status_code, _headers = verify_whats_app_number_with_http_info(account_id, verify_whats_app_number_request, opts)
+      data
+    end
+
+    # Verify the Meta re-verification code for a BYO WhatsApp number
+    # Submits the OTP Meta sent in response to POST /v1/accounts/{accountId}/whatsapp/request-code. This only verifies the number with Meta; it does not register it on the Cloud API. Call POST /v1/accounts/{accountId}/whatsapp/register afterward to complete activation. 
+    # @param account_id [String] The WhatsApp account ID
+    # @param verify_whats_app_number_request [VerifyWhatsAppNumberRequest] 
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(VerifyWhatsAppNumber200Response, Integer, Hash)>] VerifyWhatsAppNumber200Response data, response status code and response headers
+    def verify_whats_app_number_with_http_info(account_id, verify_whats_app_number_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: WhatsAppApi.verify_whats_app_number ...'
+      end
+      # verify the required parameter 'account_id' is set
+      if @api_client.config.client_side_validation && account_id.nil?
+        fail ArgumentError, "Missing the required parameter 'account_id' when calling WhatsAppApi.verify_whats_app_number"
+      end
+      # verify the required parameter 'verify_whats_app_number_request' is set
+      if @api_client.config.client_side_validation && verify_whats_app_number_request.nil?
+        fail ArgumentError, "Missing the required parameter 'verify_whats_app_number_request' when calling WhatsAppApi.verify_whats_app_number"
+      end
+      # resource path
+      local_var_path = '/v1/accounts/{accountId}/whatsapp/verify-code'.sub('{' + 'accountId' + '}', CGI.escape(account_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(verify_whats_app_number_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'VerifyWhatsAppNumber200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"WhatsAppApi.verify_whats_app_number",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: WhatsAppApi#verify_whats_app_number\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
   end
 end

data/lib/zernio-sdk/models/create_comment_automation_request.rb

@@ -26,7 +26,7 @@ module Zernio
     # Platform media/post ID (or story media id when trigger=story_reply). Omit for an account-wide (any-post / any-story) automation.
     attr_accessor :platform_post_id
 
-    # Zernio post ID. Required only when also targeting a specific post via platformPostId.
+    # Zernio post ID. Optional and never required. Use it INSTEAD of platformPostId to bind a per-post automation to a not-yet-published Zernio post: the automation stays pending and arms itself when that post publishes. For a post already live on the platform, pass platformPostId alone and omit this.
     attr_accessor :post_id
 
     # Post content snippet for display

data/lib/zernio-sdk/models/register_whats_app_number_request.rb

@@ -15,7 +15,7 @@ require 'time'
 
 module Zernio
   class RegisterWhatsAppNumberRequest < ApiModelBase
-    # The 6-digit two-step verification PIN set on the number. Omit it only if the number has no PIN of its own.
+    # The 6-digit two-step verification PIN set on the number. Omitting it applies Zernio's managed default registration PIN, the same one every Embedded Signup connect sets automatically.
     attr_accessor :pin
 
     # Attribute mapping from ruby-style variable name to JSON key.