zavudev 0.18.0 → 0.20.0

data/lib/zavudev/models/senders/agent_update_params.rb

@@ -78,7 +78,18 @@ module Zavudev
                  Zavudev::Internal::Type::ArrayOf[String],
                  api_name: :triggerOnMessageTypes
 
-        # @!method initialize(sender_id:, api_key: nil, context_window_messages: nil, enabled: nil, include_contact_metadata: nil, max_tokens: nil, model: nil, name: nil, provider: nil, system_prompt: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil, request_options: {})
+        # @!attribute voice
+        #   Voice Agent configuration. Patch this object to enable voice, change the
+        #   greeting, or adjust call limits. Requires the Voice Agents feature to be enabled
+        #   for your team.
+        #
+        #   @return [Zavudev::Models::Senders::AgentUpdateParams::Voice, nil]
+        optional :voice, -> { Zavudev::Senders::AgentUpdateParams::Voice }
+
+        # @!method initialize(sender_id:, api_key: nil, context_window_messages: nil, enabled: nil, include_contact_metadata: nil, max_tokens: nil, model: nil, name: nil, provider: nil, system_prompt: nil, temperature: nil, trigger_on_channels: nil, trigger_on_message_types: nil, voice: nil, request_options: {})
+        #   Some parameter documentations has been truncated, see
+        #   {Zavudev::Models::Senders::AgentUpdateParams} for more details.
+        #
         #   @param sender_id [String]
         #
         #   @param api_key [String]
@@ -105,7 +116,183 @@ module Zavudev
         #
         #   @param trigger_on_message_types [Array<String>]
         #
+        #   @param voice [Zavudev::Models::Senders::AgentUpdateParams::Voice] Voice Agent configuration. Patch this object to enable voice, change the greetin
+        #
         #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
+
+        class Voice < Zavudev::Internal::Type::BaseModel
+          # @!attribute enabled
+          #   Whether the agent handles voice calls. When false, the sender's number is not
+          #   answered by the voice agent and outbound calls are rejected.
+          #
+          #   @return [Boolean]
+          required :enabled, Zavudev::Internal::Type::Boolean
+
+          # @!attribute greeting
+          #   Opening line the agent speaks when the call connects. If omitted, the agent
+          #   waits for the caller to speak first.
+          #
+          #   @return [String, nil]
+          optional :greeting, String
+
+          # @!attribute greetings
+          #   Greeting per language, keyed by language code. Used when the caller's language
+          #   differs from the one `greeting` is written in.
+          #
+          #   @return [Hash{Symbol=>String}, nil]
+          optional :greetings, Zavudev::Internal::Type::HashOf[String]
+
+          # @!attribute interruptible
+          #   Whether the caller can interrupt the agent while it is speaking (barge-in). When
+          #   true, the agent stops talking as soon as the caller starts.
+          #
+          #   @return [Boolean, nil]
+          optional :interruptible, Zavudev::Internal::Type::Boolean
+
+          # @!attribute language
+          #   BCP-47 language code used for both speech recognition and speech synthesis (e.g.
+          #   `en`, `es`, `pt-BR`). Auto-detected from the recipient when omitted.
+          #
+          #   @return [String, nil]
+          optional :language, String
+
+          # @!attribute max_call_duration_minutes
+          #   Hard limit on call length in minutes. The call ends automatically when reached.
+          #
+          #   @return [Integer, nil]
+          optional :max_call_duration_minutes, Integer, api_name: :maxCallDurationMinutes
+
+          # @!attribute max_idle_seconds
+          #   How long the agent waits during silence before ending the call.
+          #
+          #   @return [Integer, nil]
+          optional :max_idle_seconds, Integer, api_name: :maxIdleSeconds
+
+          # @!attribute model
+          #   Model that runs the conversation, co-located in the voice network for lowest
+          #   latency. Independent of the model used for text messaging. Derived from the
+          #   agent's text model when omitted.
+          #
+          #   @return [String, nil]
+          optional :model, String
+
+          # @!attribute record_calls
+          #   Whether the call audio is recorded.
+          #
+          #   @return [Boolean, nil]
+          optional :record_calls, Zavudev::Internal::Type::Boolean, api_name: :recordCalls
+
+          # @!attribute stt_model
+          #   Speech-recognition model. Uses the default when omitted.
+          #
+          #   @return [String, nil]
+          optional :stt_model, String, api_name: :sttModel
+
+          # @!attribute stt_provider
+          #   Speech-recognition provider. Uses the default when omitted.
+          #
+          #   @return [String, nil]
+          optional :stt_provider, String, api_name: :sttProvider
+
+          # @!attribute transfer_phone_number
+          #   E.164 phone number the agent can transfer the call to. When set, the agent is
+          #   given a transfer tool it can use to hand the call to a human.
+          #
+          #   @return [String, nil]
+          optional :transfer_phone_number, String, api_name: :transferPhoneNumber
+
+          # @!attribute tts_provider
+          #   Speech-synthesis provider. Uses the default when omitted.
+          #
+          #   @return [String, nil]
+          optional :tts_provider, String, api_name: :ttsProvider
+
+          # @!attribute tts_voice_id
+          #   Identifier of the synthesized voice that speaks. Choose from the voices
+          #   available in the dashboard. Uses a neutral default when omitted.
+          #
+          #   @return [String, nil]
+          optional :tts_voice_id, String, api_name: :ttsVoiceId
+
+          # @!attribute voicemail_action
+          #   What the agent does when an answering machine or voicemail is detected on an
+          #   outbound call.
+          #
+          #   @return [Symbol, Zavudev::Models::Senders::AgentUpdateParams::Voice::VoicemailAction, nil]
+          optional :voicemail_action,
+                   enum: -> { Zavudev::Senders::AgentUpdateParams::Voice::VoicemailAction },
+                   api_name: :voicemailAction
+
+          # @!attribute voicemail_message
+          #   Message spoken when `voicemailAction` is `leave_message`. Falls back to
+          #   `greeting` when omitted.
+          #
+          #   @return [String, nil]
+          optional :voicemail_message, String, api_name: :voicemailMessage
+
+          # @!attribute voice_speed
+          #   Speech rate. 1.0 is natural. Only honoured by voices that support rate control;
+          #   ignored by the others.
+          #
+          #   @return [Float, nil]
+          optional :voice_speed, Float, api_name: :voiceSpeed
+
+          # @!method initialize(enabled:, greeting: nil, greetings: nil, interruptible: nil, language: nil, max_call_duration_minutes: nil, max_idle_seconds: nil, model: nil, record_calls: nil, stt_model: nil, stt_provider: nil, transfer_phone_number: nil, tts_provider: nil, tts_voice_id: nil, voicemail_action: nil, voicemail_message: nil, voice_speed: nil)
+          #   Some parameter documentations has been truncated, see
+          #   {Zavudev::Models::Senders::AgentUpdateParams::Voice} for more details.
+          #
+          #   Voice Agent configuration. Patch this object to enable voice, change the
+          #   greeting, or adjust call limits. Requires the Voice Agents feature to be enabled
+          #   for your team.
+          #
+          #   @param enabled [Boolean] Whether the agent handles voice calls. When false, the sender's number is not an
+          #
+          #   @param greeting [String] Opening line the agent speaks when the call connects. If omitted, the agent wait
+          #
+          #   @param greetings [Hash{Symbol=>String}] Greeting per language, keyed by language code. Used when the caller's language d
+          #
+          #   @param interruptible [Boolean] Whether the caller can interrupt the agent while it is speaking (barge-in). When
+          #
+          #   @param language [String] BCP-47 language code used for both speech recognition and speech synthesis (e.g.
+          #
+          #   @param max_call_duration_minutes [Integer] Hard limit on call length in minutes. The call ends automatically when reached.
+          #
+          #   @param max_idle_seconds [Integer] How long the agent waits during silence before ending the call.
+          #
+          #   @param model [String] Model that runs the conversation, co-located in the voice network for lowest lat
+          #
+          #   @param record_calls [Boolean] Whether the call audio is recorded.
+          #
+          #   @param stt_model [String] Speech-recognition model. Uses the default when omitted.
+          #
+          #   @param stt_provider [String] Speech-recognition provider. Uses the default when omitted.
+          #
+          #   @param transfer_phone_number [String] E.164 phone number the agent can transfer the call to. When set, the agent is gi
+          #
+          #   @param tts_provider [String] Speech-synthesis provider. Uses the default when omitted.
+          #
+          #   @param tts_voice_id [String] Identifier of the synthesized voice that speaks. Choose from the voices availabl
+          #
+          #   @param voicemail_action [Symbol, Zavudev::Models::Senders::AgentUpdateParams::Voice::VoicemailAction] What the agent does when an answering machine or voicemail is detected on an out
+          #
+          #   @param voicemail_message [String] Message spoken when `voicemailAction` is `leave_message`. Falls back to `greetin
+          #
+          #   @param voice_speed [Float] Speech rate. 1.0 is natural. Only honoured by voices that support rate control;
+
+          # What the agent does when an answering machine or voicemail is detected on an
+          # outbound call.
+          #
+          # @see Zavudev::Models::Senders::AgentUpdateParams::Voice#voicemail_action
+          module VoicemailAction
+            extend Zavudev::Internal::Type::Enum
+
+            HANGUP = :hangup
+            LEAVE_MESSAGE = :leave_message
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+        end
       end
     end
   end

data/lib/zavudev/models/template.rb

@@ -249,6 +249,7 @@ module Zavudev
           URL = :url
           PHONE = :phone
           OTP = :otp
+          REQUEST_CONTACT_INFO = :request_contact_info
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/zavudev/models/template_create_params.rb

@@ -122,12 +122,10 @@ module Zavudev
       #   @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}]
 
       class Button < Zavudev::Internal::Type::BaseModel
-        # @!attribute text
-        #
-        #   @return [String]
-        required :text, String
-
         # @!attribute type
+        #   `request_contact_info` renders a fixed **Share Contact Info** button that asks
+        #   the recipient to share their phone number — useful when a contact adopted a
+        #   WhatsApp username and you only know their BSUID. It takes no other fields.
         #
         #   @return [Symbol, Zavudev::Models::TemplateCreateParams::Button::Type]
         required :type, enum: -> { Zavudev::TemplateCreateParams::Button::Type }
@@ -164,6 +162,13 @@ module Zavudev
         #   @return [String, nil]
         optional :signature_hash, String, api_name: :signatureHash
 
+        # @!attribute text
+        #   Button label. Required for every type except `request_contact_info`, whose label
+        #   is fixed by WhatsApp.
+        #
+        #   @return [String, nil]
+        optional :text, String
+
         # @!attribute url
         #   Button destination. Use `{{1}}` exactly once for a dynamic URL (e.g.
         #   `https://example.com/orders/{{1}}`); WhatsApp only accepts the strict `{{1}}`
@@ -172,13 +177,11 @@ module Zavudev
         #   @return [String, nil]
         optional :url, String
 
-        # @!method initialize(text:, type:, example: nil, otp_type: nil, package_name: nil, phone_number: nil, signature_hash: nil, url: nil)
+        # @!method initialize(type:, example: nil, otp_type: nil, package_name: nil, phone_number: nil, signature_hash: nil, text: nil, url: nil)
         #   Some parameter documentations has been truncated, see
         #   {Zavudev::Models::TemplateCreateParams::Button} for more details.
         #
-        #   @param text [String]
-        #
-        #   @param type [Symbol, Zavudev::Models::TemplateCreateParams::Button::Type]
+        #   @param type [Symbol, Zavudev::Models::TemplateCreateParams::Button::Type] `request_contact_info` renders a fixed **Share Contact Info** button that asks t
         #
         #   @param example [String] Sample value Meta uses to review templates with a dynamic URL button. Substitute
         #
@@ -190,8 +193,14 @@ module Zavudev
         #
         #   @param signature_hash [String] Android app signature hash. Required for ONE_TAP buttons.
         #
+        #   @param text [String] Button label. Required for every type except `request_contact_info`, whose label
+        #
         #   @param url [String] Button destination. Use `{{1}}` exactly once for a dynamic URL (e.g. `https://ex
 
+        # `request_contact_info` renders a fixed **Share Contact Info** button that asks
+        # the recipient to share their phone number — useful when a contact adopted a
+        # WhatsApp username and you only know their BSUID. It takes no other fields.
+        #
         # @see Zavudev::Models::TemplateCreateParams::Button#type
         module Type
           extend Zavudev::Internal::Type::Enum
@@ -200,6 +209,7 @@ module Zavudev
           URL = :url
           PHONE = :phone
           OTP = :otp
+          REQUEST_CONTACT_INFO = :request_contact_info
 
           # @!method self.values
           #   @return [Array<Symbol>]

data/lib/zavudev/models/webhook_event.rb

@@ -17,22 +17,21 @@ module Zavudev
     #
     # **Inbound events:**
     #
-    # - `message.inbound`: New message received from a contact. Reactions are
-    #   delivered as `message.inbound` with `messageType='reaction'`. When the contact
-    #   replied to (quoted) an earlier message, `data.content` carries the reply
-    #   context: `replyToMessageId`, `replyToProviderMessageId`, `replyToFrom`,
-    #   `replyToText`, and `replyToMessageType`. `data.providerTimestamp` is the
-    #   provider's original receive time in Unix milliseconds (the moment the channel
-    #   received the message from the contact — WhatsApp, Telegram, Instagram,
-    #   Messenger; `null` for SMS and email). Compare it against the top-level
-    #   `timestamp` (when Zavu dispatched the webhook) to detect and ignore delayed
-    #   deliveries.
-    # - `message.status`: A contact posted a WhatsApp status/story (currently WhatsApp
-    #   Alternative only). It is NOT a conversation message and never enters the inbox
-    #   — it is delivered only if you subscribe to `message.status`. `data` carries
-    #   `from` (the author in E.164), `messageType` (`text`, `image`, `video`,
-    #   `audio`), `text` (caption/text when present), `mimetype` (for media stories),
-    #   and `providerTimestamp`. Media bytes are not included.
+    # - `message.inbound`: New message received from a contact. `data.conversationId`
+    #   is the inbox thread id (deep-link with
+    #   `https://dashboard.zavu.dev/{locale}/inbox?conv={conversationId}`); it is
+    #   `null` while the conversation row is still being created (the first message of
+    #   a brand-new thread, or several near-simultaneous first messages), where
+    #   `conversation.new` carries the id instead — `GET /v1/messages/{messageId}`
+    #   always has it. Reactions are delivered as `message.inbound` with
+    #   `messageType='reaction'`. When the contact replied to (quoted) an earlier
+    #   message, `data.content` carries the reply context: `replyToMessageId`,
+    #   `replyToProviderMessageId`, `replyToFrom`, `replyToText`, and
+    #   `replyToMessageType`. `data.providerTimestamp` is the provider's original
+    #   receive time in Unix milliseconds (the moment the channel received the message
+    #   from the contact — WhatsApp, Telegram, Instagram, Messenger; `null` for SMS
+    #   and email). Compare it against the top-level `timestamp` (when Zavu dispatched
+    #   the webhook) to detect and ignore delayed deliveries.
     # - `message.unsupported`: Received a message type that is not supported
     #
     # **Broadcast events:**
@@ -42,13 +41,42 @@ module Zavudev
     #
     # **Other events:**
     #
-    # - `conversation.new`: New conversation started with a contact
+    # - `conversation.new`: New conversation started with a contact. `data` carries
+    #   `conversationId` (the inbox thread id — deep-link with
+    #   `https://dashboard.zavu.dev/{locale}/inbox?conv={conversationId}`), the
+    #   `phoneNumber` or `email` key, `channel`, `firstMessageId`, `firstMessageText`,
+    #   and `profileName`.
     # - `template.status_changed`: WhatsApp template approval status changed
     #
     # **Partner events:**
     #
     # - `invitation.status_changed`: A partner invitation status changed (pending,
-    #   in_progress, completed, cancelled)
+    #   in_progress, completed, cancelled, failed). `data` carries `invitationId`,
+    #   `clientName`, `clientEmail`, `connectionType` (`whatsapp_waba` or
+    #   `messenger`), `previousStatus`, and `currentStatus`. On `completed` it also
+    #   carries `senderId` and `connectedAccount` (`channel`, `id`, `name`) — the
+    #   WhatsApp number or Facebook Page that was linked. On `failed` it carries
+    #   `failureReason`; the invitation link stays usable, so a client can retry it.
+    #
+    # **Voice Agent events:** For every voice event, `data` carries `callId`,
+    # `direction`, `from`, `to`, `status`, `durationSeconds`, `endReason`, and
+    # `transcriptAvailable`. The terminal events (`call.completed`, `call.failed`)
+    # additionally carry `cost` — what the call was billed, in USD, combining
+    # telephony and the managed voice pipeline — and `currency`. They are dispatched
+    # after the call is charged, so `cost` is populated rather than zero; telephony
+    # can still be settling on an outbound call, in which case
+    # `GET /v1/calls/{callId}` holds the reconciled figure.
+    #
+    # - `call.initiated`: An outbound call was created and is dialing, or an inbound
+    #   call was received. `data.status` = `ringing`
+    # - `call.answered`: The call was answered and the voice agent is connected.
+    #   `data.status` = `in_progress`
+    # - `call.completed`: The call ended after a conversation. `data.status` =
+    #   `completed`; `durationSeconds` and `endReason` describe how it ended, and
+    #   `transcriptAvailable` indicates whether a transcript can be fetched.
+    # - `call.failed`: The call could not be completed (busy, no answer, canceled, or
+    #   an error). `data.status` is the terminal status and `endReason` explains the
+    #   cause.
     #
     # **Custom domain events:**
     #
@@ -63,14 +91,18 @@ module Zavudev
       MESSAGE_SENT = :"message.sent"
       MESSAGE_DELIVERED = :"message.delivered"
       MESSAGE_READ = :"message.read"
+      MESSAGE_STATUS = :"message.status"
       MESSAGE_FAILED = :"message.failed"
       MESSAGE_INBOUND = :"message.inbound"
-      MESSAGE_STATUS = :"message.status"
       MESSAGE_UNSUPPORTED = :"message.unsupported"
       BROADCAST_STATUS_CHANGED = :"broadcast.status_changed"
       CONVERSATION_NEW = :"conversation.new"
       TEMPLATE_STATUS_CHANGED = :"template.status_changed"
       INVITATION_STATUS_CHANGED = :"invitation.status_changed"
+      CALL_INITIATED = :"call.initiated"
+      CALL_ANSWERED = :"call.answered"
+      CALL_COMPLETED = :"call.completed"
+      CALL_FAILED = :"call.failed"
       DOMAIN_VERIFIED = :"domain.verified"
       DOMAIN_FAILED = :"domain.failed"
 

data/lib/zavudev/resources/broadcasts.rb

@@ -253,10 +253,26 @@ module Zavudev
         )
       end
 
-      # Start sending the broadcast immediately or schedule for later. Broadcasts go
-      # through automated AI content review before sending. If the review passes, the
-      # broadcast proceeds. If rejected, use PATCH to edit content, then call POST
-      # /retry-review. Reserves the estimated cost from your balance.
+      # Start sending the broadcast immediately or schedule for later.
+      #
+      # **Verification is required to send, and there are two of them.** The team must
+      # have completed both identity verification (KYC) and business verification (KYB);
+      # passing one is not enough. Drafts can be created, edited and kept without
+      # either. Every send path — dashboard, API and CLI alike — enforces both,
+      # returning `403` with code `kyc_required` or `kyb_required` for whichever is
+      # outstanding.
+      #
+      # **Review depends on the channel, and cannot be bypassed.** A draft is submitted
+      # to automated content review here; it does not go straight out. A WhatsApp
+      # broadcast built on a Meta-approved template skips review (Meta already vetted
+      # the content) and begins sending. An email broadcast sends as soon as the
+      # automated review passes. Every other channel moves to `pending_admin_review` and
+      # waits for a person. If the review rejects it, use PATCH to edit the content then
+      # call POST /retry-review.
+      #
+      # Calling this on a broadcast that is already `approved` or `scheduled` sends or
+      # reschedules it directly, since it has already been reviewed. Reserves the
+      # estimated cost from your balance.
       #
       # @overload send_(broadcast_id, scheduled_at: nil, request_options: {})
       #

data/lib/zavudev/resources/functions.rb

@@ -6,6 +6,9 @@ module Zavudev
       # @return [Zavudev::Resources::Functions::Secrets]
       attr_reader :secrets
 
+      # Some parameter documentations has been truncated, see
+      # {Zavudev::Models::FunctionCreateParams} for more details.
+      #
       # Create a new Zavu Function. The function starts in `draft` status. A dedicated
       # API key is auto-provisioned and injected as the `ZAVU_API_KEY` secret so the
       # function can call back into the Zavu API without manual setup.
@@ -13,7 +16,7 @@ module Zavudev
       # Provide `sourceCode` to seed the draft. Call
       # `POST /v1/functions/{functionId}/deploy` afterwards to publish.
       #
-      # @overload create(name:, slug:, dependencies: nil, description: nil, http_enabled: nil, memory_mb: nil, runtime: nil, source_code: nil, timeout_sec: nil, request_options: {})
+      # @overload create(name:, slug:, dependencies: nil, description: nil, entrypoint: nil, files: nil, http_enabled: nil, memory_mb: nil, runtime: nil, source_code: nil, timeout_sec: nil, request_options: {})
       #
       # @param name [String]
       #
@@ -23,15 +26,19 @@ module Zavudev
       #
       # @param description [String]
       #
+      # @param entrypoint [String] Which file in `files` is the entry point. Defaults to `index.ts`.
+      #
+      # @param files [Hash{Symbol=>String}] The project's source files, keyed by path relative to the project root (e.g. `in
+      #
       # @param http_enabled [Boolean] Whether to expose a public HTTPS URL for this function.
       #
       # @param memory_mb [Integer, Zavudev::Models::FunctionCreateParams::MemoryMB]
       #
       # @param runtime [Symbol, Zavudev::Models::FunctionCreateParams::Runtime] Runtime the function is deployed on.
       #
-      # @param source_code [String] TypeScript source code for the function entry point (max ~900KB).
+      # @param source_code [String] Shortcut for a single-file function: exactly equivalent to sending `files` with
       #
-      # @param timeout_sec [Integer]
+      # @param timeout_sec [Integer] Per-invocation timeout in seconds. Event and cron invocations are asynchronous,
       #
       # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -69,17 +76,28 @@ module Zavudev
         )
       end
 
-      # Update the draft source code and/or dependency map without triggering a build.
-      # Visible in the dashboard immediately, but the live (deployed) function does not
-      # change until `POST /v1/functions/{functionId}/deploy` runs.
+      # Some parameter documentations has been truncated, see
+      # {Zavudev::Models::FunctionUpdateParams} for more details.
       #
-      # @overload update(function_id, dependencies: nil, source_code: nil, request_options: {})
+      # Update an existing function. `sourceCode` / `dependencies` edit the draft
+      # without triggering a build — they go live on the next
+      # `POST /v1/functions/{functionId}/deploy`. `httpEnabled` is applied to the
+      # deployed function immediately, so turning the public endpoint on or off does not
+      # require a redeploy.
+      #
+      # @overload update(function_id, dependencies: nil, entrypoint: nil, files: nil, http_enabled: nil, source_code: nil, request_options: {})
       #
       # @param function_id [String] Zavu Function ID.
       #
       # @param dependencies [Hash{Symbol=>String}] New dependency map (replaces existing dependencies).
       #
-      # @param source_code [String] New source code to publish (replaces the draft).
+      # @param entrypoint [String] Which file in `files` is the entry point. Defaults to `index.ts`.
+      #
+      # @param files [Hash{Symbol=>String}] The project's source files, keyed by path relative to the project root (e.g. `in
+      #
+      # @param http_enabled [Boolean] Expose the function on its public HTTPS URL, or take it down. Applies to the alr
+      #
+      # @param source_code [String] Shortcut for a single-file function: exactly equivalent to sending `files` with
       #
       # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
       #
@@ -119,18 +137,25 @@ module Zavudev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Zavudev::Models::FunctionDeployParams} for more details.
+      #
       # Publish the function. If `sourceCode` or `dependencies` are provided in the
       # body, they replace the current draft before deployment. Returns immediately with
       # a deployment ID — poll `GET /v1/functions/deployments/{deploymentId}` until
       # status is `active` or `failed`.
       #
-      # @overload deploy(function_id, dependencies: nil, source_code: nil, request_options: {})
+      # @overload deploy(function_id, dependencies: nil, entrypoint: nil, files: nil, source_code: nil, request_options: {})
       #
       # @param function_id [String] Zavu Function ID.
       #
       # @param dependencies [Hash{Symbol=>String}] New dependency map (replaces existing dependencies).
       #
-      # @param source_code [String] New source code to publish (replaces the draft).
+      # @param entrypoint [String] Which file in `files` is the entry point. Defaults to `index.ts`.
+      #
+      # @param files [Hash{Symbol=>String}] The project's source files, keyed by path relative to the project root (e.g. `in
+      #
+      # @param source_code [String] Shortcut for a single-file function: exactly equivalent to sending `files` with
       #
       # @param request_options [Zavudev::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/zavudev/resources/invitations.rb

@@ -6,22 +6,25 @@ module Zavudev
       # Some parameter documentations has been truncated, see
       # {Zavudev::Models::InvitationCreateParams} for more details.
       #
-      # Create a partner invitation link for a client to connect WhatsApp. The client
-      # opens the returned `url` and connects. Set `connectionType` to choose how they
-      # connect:
+      # Create a partner invitation link for a client to connect a Meta channel. The
+      # client opens the returned `url` and authorizes with Meta; the resulting sender
+      # is created in your project when they finish, and the invitation transitions to
+      # `completed`.
       #
-      # - `whatsapp_waba` (default): the client completes Meta's embedded signup,
-      #   linking an official WhatsApp Business Account.
-      # - `whatsapp_alt`: the client links their number by scanning a QR code. Requires
-      #   the WhatsApp Alternative feature to be enabled for your team (otherwise
-      #   returns 400).
+      # `connectionType` picks the channel:
       #
-      # Either way, the resulting sender is created in your project when the client
-      # completes the flow, and the invitation transitions to `completed`.
+      # - `whatsapp_waba` (default): Meta's embedded signup links an official WhatsApp
+      #   Business Account.
+      # - `messenger`: the client picks a Facebook Page they administer; its Messenger
+      #   inbox (including Marketplace chats) is routed to Zavu.
+      #
+      # One invitation connects one channel — create one per channel to onboard a client
+      # on several. `phoneNumberId` and `allowedPhoneCountries` apply to `whatsapp_waba`
+      # only.
       #
       # @overload create(allowed_phone_countries: nil, client_email: nil, client_name: nil, client_phone: nil, connection_type: nil, expires_in_days: nil, phone_number_id: nil, request_options: {})
       #
-      # @param allowed_phone_countries [Array<String>] ISO country codes for allowed phone numbers.
+      # @param allowed_phone_countries [Array<String>] ISO country codes for allowed phone numbers. Only valid when `connectionType` is
       #
       # @param client_email [String] Email of the client being invited.
       #
@@ -29,7 +32,7 @@ module Zavudev
       #
       # @param client_phone [String] Phone number of the client in E.164 format.
       #
-      # @param connection_type [Symbol, Zavudev::Models::InvitationCreateParams::ConnectionType] How the client connects WhatsApp. `whatsapp_waba` (default) runs Meta's embedded
+      # @param connection_type [Symbol, Zavudev::Models::InvitationCreateParams::ConnectionType] Which Meta channel the client connects, and how.
       #
       # @param expires_in_days [Integer] Number of days until the invitation expires.
       #
@@ -70,6 +73,9 @@ module Zavudev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {Zavudev::Models::InvitationListParams} for more details.
+      #
       # List partner invitations for this project.
       #
       # @overload list(cursor: nil, limit: nil, status: nil, request_options: {})

data/lib/zavudev/resources/messages.rb

@@ -102,10 +102,30 @@ module Zavudev
       # - Window opens when the user messages you first
       # - Use template messages to initiate conversations outside the window
       #
-      # **Daily limits:**
-      #
-      # - Unverified accounts: 200 messages per channel per day
-      # - Complete KYC verification to increase limits to 10,000/day
+      # **Plan allowances and email billing:**
+      #
+      # - WhatsApp, Telegram, Instagram and Messenger share an allowance of 2,000
+      #   messages per month on Free. Over it, sends return 429 with code
+      #   `a2p_limit_exceeded` and upgrade details; the counter resets on the 1st of
+      #   each month. Paid plans have no message caps
+      # - Email is billed from your prepaid balance in 1,000-message blocks: $0.40 per
+      #   1,000 transactional emails, $0.80 per 1,000 marketing (broadcast) emails. A
+      #   block is charged when your monthly count crosses each 1,000 boundary, and at
+      #   zero balance email sends return 402 with code `insufficient_balance`. Free
+      #   teams start with $2 of credit and additionally cap at 3,000 emails/month and
+      #   100/day. Teams on earlier plans keep their original email quotas instead
+      # - SMS and voice are billed per message from your balance on every plan
+      #
+      # **Email recipient pre-flight:** Email messages are validated automatically
+      # before dispatch. Sends that would be a guaranteed hard bounce are failed instead
+      # of sent, protecting your bounce rate: the message transitions to `failed`
+      # (visible via `GET /v1/messages/{messageId}` and the `message.failed` webhook)
+      # with `errorCode` set to `EMAIL_INVALID_RECIPIENT` (malformed address),
+      # `EMAIL_DOMAIN_NOT_FOUND` (recipient domain has no MX or A records), or
+      # `EMAIL_RECIPIENT_SUPPRESSED` (address is on your suppression list after a
+      # previous bounce or complaint). Advisory signals (role addresses, disposable
+      # domains) do not block sends — check them beforehand with
+      # `POST /v1/introspect/email`.
       #
       # @overload send_(to:, attachments: nil, channel: nil, content: nil, fallback_enabled: nil, html_body: nil, idempotency_key: nil, message_type: nil, metadata: nil, reply_to: nil, subject: nil, text: nil, voice_language: nil, zavu_sender: nil, request_options: {})
       #

data/lib/zavudev/resources/number_10dlc/brands.rb

@@ -198,7 +198,11 @@ module Zavudev
         end
 
         # Submit a draft brand to The Campaign Registry (TCR) for vetting. The brand must
-        # be in draft status. A $35 registration fee is charged from your balance.
+        # be in draft status. TCR's one-time $4 brand registration fee is charged from
+        # your balance at submission (passed through at cost) and refunded if the carrier
+        # rejects the registration. A team that already paid this fee through the
+        # compliance flow is not charged again. Campaign registration is billed separately
+        # when a campaign is submitted.
         #
         # @overload submit(brand_id, request_options: {})
         #

data/lib/zavudev/resources/number_10dlc/campaigns.rb

@@ -171,7 +171,12 @@ module Zavudev
         end
 
         # Submit a draft campaign for carrier review. The campaign must be in draft status
-        # and its brand must be verified.
+        # and its brand must be verified. TCR's one-time registration fee is charged from
+        # your balance at submission ($15 for standard use cases, $2 for LOW_VOLUME),
+        # passed through at cost and refunded if the carrier rejects it. Once approved,
+        # the campaign's monthly TCR fee ($10 standard, $2 LOW_VOLUME) is charged from
+        # your balance while the campaign is active — see registrationCostCents and
+        # monthlyFeeCents on the campaign object.
         #
         # @overload submit(campaign_id, request_options: {})
         #