warb 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f9ae7b1519b693fce17eb562569b49d110f18e57faf6fe1608880af08e40bcd
-  data.tar.gz: 931fb4cb412c47e0756eb05f21ff84b0126ef154ed9274ea83c3bd4f303f086b
+  metadata.gz: d0ceb84f9bce4434cb413bee092051e345693d5bfeaa4f4e529e7661eb659f50
+  data.tar.gz: 6ecc6f330c73559e1abd7d17cb817cb894e61fa5055cc1ec5cab9ebd35ff607e
 SHA512:
-  metadata.gz: 7aedabac7a6c7c74932b4ff243faf3ba06b7596c3c6c77114e65db6fd74e809833d2fb76d4e592eb738d156881d2efdf016c59236607f7ab300afc592e6ee501
-  data.tar.gz: d91b0667879f1e192d1cdc6e23048eba6326519df997546335b36df709cdddbbe8eb81605dfdd304b060e4a89da8792d0388cd62e13cf1a59773aecd3cd5c062
+  metadata.gz: e7be228f7823f7d9da7aa2820f4ad91f74acf13d31c8e662ab613c8748231e069527258fc7d66333007785541a419fcba26a4a2ae9aa54159b3b6891eb06d8cb
+  data.tar.gz: ba129a442d7afbb050591903c6b753ad4e0c62360c9c2955b640a039a79f5d8dc42a07210d1c279e651920fd49bdc00f3e0a0bd2458426f9c851015ace4b8111

data/docs/components/button.md

@@ -11,12 +11,13 @@ It represents a generic button, which can be set with the following attributes:
 | `sub_type`   | `String`  |   Yes    | A more specific classification for the button |
 
 ## Common Button Types
-| Button Type   | Template Instance Method     | Params                  |
-|---------------|------------------------------|-------------------------|
-| `quick_reply` | `add_quick_reply_button`     | `index`                 |
-| `voice_call`  | `add_voice_call_button`      | `index`                 |
-| `url`         | `add_dynamic_url_button`     | `index`, `text`         |
-| `copy_code`   | `add_copy_code_button`       | `index`, `coupon_code`  |
+| Button Type   | Template Instance Method     | Params                                   |
+|---------------|------------------------------|------------------------------------------|
+| `quick_reply` | `add_quick_reply_button`     | `index`                                  |
+| `voice_call`  | `add_voice_call_button`      | `index`                                  |
+| `url`         | `add_dynamic_url_button`     | `index`, `text`                          |
+| `copy_code`   | `add_copy_code_button`       | `index`, `coupon_code`                   |
+| `flow`        | `add_flow_button`            | `index`, `flow_token`, `flow_action_data`|
 
 Please, refer to our [templates messaging documentation](../messages/template.md) for more info. You can check the methods to insert a button in the "Adding Buttons" section.
 

data/docs/components/flow_button.md

@@ -0,0 +1,102 @@
+# FlowButton
+
+```Warb::Components::FlowButton``` is a component used in template messages for flow buttons.
+This button type allows you to link a template directly with a WhatsApp Flow experience.
+
+## Attributes
+| Attribute          | Type      | Required | Description                                                     |
+| ------------------ | --------- | -------- |-----------------------------------------------------------------|
+| `index`            | `Integer` | Yes      | An identifier or position for the button in the template.       |
+| `sub_type`         | `String`  | Yes      | Always `"flow"` for this button type.                           |
+| `flow_token`       | `String`  | No       | If not set, the API defaults to `"unused"`.                     |
+| `flow_action_data` | `Hash`    | No       | A key-value payload passed to the flow as pre-filled form data. |
+
+
+
+## Examples
+###### Basic Flow button with token
+```ruby
+flow_button = Warb::Components::FlowButton.new(
+  index: 0,
+  sub_type: "flow",
+  flow_token: "TOKEN_123"
+)
+
+flow_button.to_h
+=> {
+     type: "button",
+     sub_type: "flow",
+     index: 0,
+     parameters: [
+       {
+         type: "action",
+         action: {
+           flow_token: "TOKEN_123"
+         }
+       }
+     ]
+   }
+```
+
+##### Flow button with token and action data
+```ruby
+flow_button = Warb::Components::FlowButton.new(
+  index: 1,
+  sub_type: "flow",
+  flow_token: "TOKEN_ABC",
+  flow_action_data: { name: "John", cpf: "11122233344" }
+)
+
+flow_button.to_h
+=> {
+     type: "button",
+     sub_type: "flow",
+     index: 1,
+     parameters: [
+       {
+         type: "action",
+         action: {
+           flow_token: "TOKEN_ABC",
+           flow_action_data: { name: "John", cpf: "11122233344" }
+         }
+       }
+     ]
+   }
+```
+
+##### Flow button without optional fields
+```ruby
+flow_button = Warb::Components::FlowButton.new(index: 2, sub_type: "flow")
+flow_button.to_h
+=> {
+     type: "button",
+     sub_type: "flow",
+     index: 2,
+     parameters: [
+       {
+         type: "action",
+         action: {}
+       }
+     ]
+   }
+```
+### Usage in Templates
+
+Flow buttons are typically added to templates using the add_flow_button method:
+
+```ruby
+template = Warb::Resources::Template.new(name: "my_template", language: "en_US")
+
+# Add a flow button with token
+template.add_flow_button(index: 0, flow_token: "TOKEN_123")
+
+# Add a flow button with token and action data
+template.add_flow_button(index: 1, flow_token: "TOKEN_ABC", flow_action_data: { name: "Jane", dob: "1990-01-01" })
+
+# Or using a block for more complex configuration
+template.add_flow_button do |button|
+  button.index = 0
+  button.flow_token = "TOKEN_DYNAMIC"
+  button.flow_action_data = { email: "user@example.com" }
+end
+```

data/docs/messages/flow.md

@@ -1,12 +1,248 @@
 # Flow
 
-Flow is a special type of message. We can summarize it simply as a form.
+Flow is a special type of interactive WhatsApp message that provides a "form-like" experience.
+With ```Warb.flow``` you can send static (navigate) or dynamic (data exchange) flows, both in draft and published modes.
 
-At this point of writing, this gem only supports sending existing flows, and it can only send flows which are in draft.
+Prerequisites (Meta)
+Business Account + Developer Account
+Verified Business to send flows in production WhatsApp (unverified accounts can only test in Meta’s Flow editor)
+For dynamic flows: endpoint + encryption configured in Meta (to handle user responses)
 
-To send flows, you can do as following:
+### Quick Examples
+
+##### Send a static draft flow:
+```ruby
+Warb.flow.dispatch(recipient_number, flow_id: "0000000000000000", mode: "draft", screen: "INITIAL", body: "Open flow")
+```
+
+##### Send a dynamic draft flow:
+```ruby
+Warb.flow.dispatch(recipient_number,
+  flow_id:     "0000000000000000",
+  mode:        "draft",
+  flow_action: "data_exchange",
+  body:        "Open flow"
+)
+```
+
+##### Send a dynamic published flow with custom header, body, and footer:
+```ruby
+Warb.flow.dispatch(recipient_number) do |flow|
+  flow.flow_id     = "0000000000000000"
+  flow.flow_action = "data_exchange"
+  flow.mode        = "published"
+  flow.body        = "Hello! Please follow the instructions."
+  flow.footer      = "Need help? Reply to this message."
+
+  flow.header = {
+    type: "document",
+    document: {
+      link:     "https://example.com/contract.pdf",
+      filename: "contract.pdf"
+    }
+  }
+
+  flow.flow_cta = "Sign"
+end
+```
+
+### Dispatching Flow Messages
 ```ruby
-Warb.flow.dispatch(recipient_number, flow_id: "flow_id", screen: "screen")
+Warb.flow.dispatch(recipient_number, **params, &block)
 ```
+##### Parameters
+| Attribute     | Type     | Required                           | Description                                                 |
+| ------------- | -------- | ---------------------------------- | ----------------------------------------------------------- |
+| `flow_id`     | `String` | Yes                                | The ID of the Flow created in Meta.                         |
+| `body`        | `String` | Yes                                | Body text shown in the Flow message.                        |
+| `flow_action` | `String` | No                                 | `"navigate"` (default) or `"data_exchange"`.                |
+| `mode`        | `String` | Yes if `flow mode == 'draft'`      | `"published"` (default) or `"draft"`.                       |
+| `screen`      | `String` | Yes if `flow_action == "navigate"` | Initial screen to navigate to.                              |
+| `flow_cta`    | `String` | No                                 | Label for the button that opens the Flow.                   |
+| `flow_token`  | `String` | No                                 | Token for dynamic flows (encryption/validation).            |
+| `data`        | `Hash`   | No                                 | Prefill data for navigate flows.                            |
+| `header`      | `Hash`   | No                                 | Optional header (see below).                                |
+| `footer`      | `String` | No                                 | Optional footer text.                                       |
+
+### Supported Headers
+
+You must provide exactly one of the following header types:
 
-`flow_id` must be the ID of the flow and `screen` must be the ID of the first screen of the flow.
+##### Text
+```ruby
+{ type: "text", text: "Flow title" }
+```
+
+##### Image
+```ruby
+{ type: "image", image: { id: "MEDIA_ID" } }
+# or
+{ type: "image", image: { link: "https://example.com/img.jpg" } }
+```
+
+##### Video
+```ruby
+{ type: "video", video: { id: "MEDIA_ID" } }
+# or
+{ type: "video", video: { link: "https://example.com/video.mp4" } }
+```
+
+##### Document
+```ruby
+{ type: "document", document: { id: "MEDIA_ID" } }
+# or
+{ type: "document", document: { link: "https://example.com/file.pdf", filename: "file.pdf" } }
+```
+
+##### Note:
+
+id must be obtained from a media upload (Warb.image/video/document.upload).
+
+link must be a public URL. For documents, filename is required to determine preview capabilities.
+
+### Modes and Actions
+##### mode
+
+"published" (default): Published flow. Allows customizing header, body, footer, and flow_cta.
+
+"draft": Draft flow. Usable via Meta Flow editor and sometimes on WhatsApp, but some elements (like body text and CTA) may be restricted.
+
+##### flow_action
+
+"navigate" (default) → static flow
+Requires screen, can include initial data:
+```ruby
+Warb.flow.dispatch(recipient_number,
+  flow_id: "0000000000000000",
+  screen:  "INITIAL",
+  body:    "Continue",
+  data:    { prefill: { name: "Alice", email: "alice@example.com" } }
+)
+```
+
+"data_exchange" → dynamic flow
+No flow_action_payload (omitted automatically):
+```ruby
+Warb.flow.dispatch(recipient_number,
+  flow_id:     "0000000000000000",
+  flow_action: "data_exchange",
+  body:        "Fill the form",
+)
+```
+
+### Block Building
+
+You can also build flows using a block:
+```ruby
+Warb.flow.dispatch(recipient_number) do |flow|
+  flow.flow_id     = "0000000000000000"
+  flow.flow_action = "data_exchange"
+  flow.mode        = "published"
+  flow.body        = "We need some information"
+
+  flow.header = { type: "text", text: "Registration" }
+  flow.footer = "Thanks!"
+
+  flow.flow_cta   = "Open"
+end
+```
+
+### Validations
+
+Before sending, the gem enforces:
+
+flow_id is required → raises ArgumentError: flow_id is required
+
+body is required → raises ArgumentError: body is required for flow message
+
+If flow_action == "navigate" then screen is required →
+raises ArgumentError: screen is required for flow_action=navigate
+
+The Meta API may return additional errors (invalid parameters, missing fields, etc.), which are raised as Warb::BadRequest, Warb::RequestError, etc.
+
+Example Scenarios
+1) Static / Draft
+```ruby
+Warb.flow.dispatch(recipient_number,
+  flow_id: "0000000000000000",
+  screen:  "INITIAL",
+  mode:    "draft",
+  body:    "Open flow"
+)
+```
+
+2) Dynamic / Draft
+```ruby
+Warb.flow.dispatch(recipient_number,
+  flow_id:     "0000000000000000",
+  flow_action: "data_exchange",
+  mode:        "draft",
+  body:        "Fill the form"
+)
+```
+
+3) Dynamic / Published with Document Header
+```ruby
+Warb.flow.dispatch(recipient_number) do |flow|
+  flow.flow_id     = "0000000000000000"
+  flow.flow_action = "data_exchange"
+  flow.mode        = "published"
+  flow.body        = "Please review and sign the document."
+  flow.footer      = "Reply if you need assistance."
+  flow.flow_cta    = "Sign"
+
+  flow.header = {
+    type: "document",
+    document: {
+      link:     "https://www.thecampusqdl.com/uploads/files/pdf_sample_2.pdf",
+      filename: "pdf_sample_2.pdf"
+    }
+  }
+end
+```
+
+4) Static / Published with Image Header (id) and Prefill Data
+```ruby
+image_id = Warb.image.upload(file_path: "banner.jpg", file_type: "image/jpeg")
+
+Warb.flow.dispatch(recipient_number) do |flow|
+  flow.flow_id = "0000000000000000"
+  flow.mode    = "published"
+  flow.body    = "Open and check your data"
+
+  flow.header = { type: "image", image: { id: image_id } }
+
+  flow.screen = "INITIAL"
+  flow.data   = { prefill: { name: "John", email: "john@example.com" } }
+end
+```
+
+### Generated Payload (Reference)
+
+Example payload produced by the gem:
+```ruby
+{
+  "type": "interactive",
+  "interactive": {
+    "type": "flow",
+    "header": { ... },
+    "body": { "text": "..." },
+    "footer": { "text": "..." },
+    "action": {
+      "name": "flow",
+      "parameters": {
+        "flow_message_version": "3",
+        "flow_id": "....",
+        "flow_action": "navigate" | "data_exchange",
+        "mode": "published" | "draft",
+        "flow_cta": "Open",
+        "flow_token": "TOKEN",
+        "flow_action_payload": {
+          "screen": "INITIAL",
+          "data": { "prefill": { ... } }
+        }
+      }
+    }
+  }
+}
+```

data/docs/messages/template.md

@@ -271,6 +271,7 @@ If your template supports buttons, you can add them using the following methods:
 | `url`              | `add_auth_code_button`        | `index`, `text`                           |
 | `copy_code`        | `add_copy_code_button`        | `index`, `coupon_code`                    |
 | `voice_call`       | `add_voice_call_button`       | `index`                                   |
+| `flow`             | `add_flow_button`             | `index`, `flow_token`, `flow_action_data` |
 | `doesn't apply`    | `add_button`                  | `instance`, `&block`                      |
 
 You can either use the keyword parameters or set the attributes using a block:
@@ -300,6 +301,12 @@ Warb.template.dispatch(recipient_number) do |template|
 
   # Add a voice call button
   template.add_voice_call_button
+
+  # Add a flow button
+  template.add_flow_button do |button|
+    button.flow_token = 'FLOWTOKEN'
+    button.flow_action_data = { name: 'John' }
+  end
 end
 ```
 
@@ -325,3 +332,42 @@ indices match the button positions defined in your template. The `index` is auto
 don't do it manually, but it is done based on the number of buttons added with the methods above,
 so if your template has a button that doesn't need configuration like the static url button you'll
 have provide the position of the other buttons.
+
+
+#### Creating Templates
+
+To create a template, you need to provide the template name, language, category and the body (components).
+
+```ruby
+Warb.template.create(
+  name: "my_template_001",
+  language: Warb::Language::ENGLISH_US,
+  category: Warb::Category::MARKETING,
+  body: Warb::Resources::Text.new(
+    text: "Hello {{1}}, welcome to our service!",
+    examples: ["John"]
+  )
+)
+```
+
+**Required Parameters:**
+| Parameter  | Type     | Description                                  |
+|------------|----------|----------------------------------------------|
+| `name`     | `String` | Unique template name (snake_case)            |
+| `language` | `String` | The language to use for the template         |
+| `category` | `String` | Template category (MARKETING, UTILITY, etc.) |
+
+**Template Categories:**
+- `Warb::Category::MARKETING` - Promotional content
+- `Warb::Category::UTILITY` - Transactional messages
+- `Warb::Category::AUTHENTICATION` - Security codes
+
+**Note**: Currently, the creation only supports body text, more resource types are coming soon.
+
+#### Deleting Templates
+
+To delete a template, you need to provide the template name.
+
+```ruby
+Warb.template.delete("my_template_001")
+```

data/docs/resources/{index.md → README.md}

@@ -1,6 +1,6 @@
 # Resources
 
-Most of the resources can be sent as message. Check the [messages](../messages/index.md) for detailed info.
+Most of the resources can be sent as message. Check the [messages](../messages/README.md) for detailed info.
 
 But there are some resources which act more like a component, not being used alone by themself.
 
@@ -11,4 +11,4 @@ Such resources, and where they are used, are listed bellow:
 |-----------------------------|------------------------------|--------------------------------------------------------------------------------------|
 | `Warb::Resources::Currency` | [Currency](./currency.md)    | [Template Messaging](../messages/template.md)                                        |
 | `Warb::Resources::DateTime` | [Date Time](./date_time.md)  | [Template Messaging](../messages/template.md)                                        |
-| `Warb::Resources::Text`     | [Text](./text.md)            | [Text Messaging](../messages/text.md), [Template Messaging](../messages/template.md) |
+| `Warb::Resources::Text`     | [Text](./text.md)            | [Text Messaging](../messages/text.md), [Template Messaging](../messages/template.md) |

data/docs/setup.md

@@ -43,4 +43,48 @@ Warb.setup do |config|
 end
 ```
 
-Also, note that calling `Warb.setup` multiple times **WILL NOT** override the previous configuration, so you can use it to change the global configuration at any time.
+Also, note that calling `Warb.setup` multiple times **WILL NOT** override the previous configuration, so you can use it to change the global configuration at any time.
+
+## Phone numbers (quality monitoring)
+
+You can fetch all phone numbers attached to your WhatsApp Business Account (WABA) and their quality/operational signals.
+
+Requirements: make sure you have configured a business_id in your global setup (this method uses the business context, not the sender/phone context).
+```ruby
+Warb.setup do |config|
+  config.access_token = "ACCESS_TOKEN"
+  config.business_id  = "BUSINESS_ID"      # <-- required here
+  config.sender_id    = "SENDER_ID"    # still used for message dispatch
+end
+```
+
+#### Global usage
+```ruby
+phones = Warb.list_phone_numbers
+```
+
+#### Sample response (unwrapped data array):
+```ruby
+=> [
+  {
+    "verified_name"            => "Test",
+    "code_verification_status" => "NOT_VERIFIED",
+    "display_phone_number"     => "00000000000",
+    "quality_rating"           => "GREEN",
+    "platform_type"            => "CLOUD_API",
+    "throughput"               => { "level" => "STANDARD" },
+    "webhook_configuration"    => { "application" => "https://example.com/" },
+    "id"                       => "(phone_number_id)"
+  }
+]
+```
+
+#### Notes
+
+This method returns the data array directly. If you need paging cursors, call the raw client:
+```ruby
+raw = Warb.client.get("phone_numbers", {}, endpoint_prefix: :business_id)
+raw.body # => { "data" => [...], "paging" => { "cursors" => {...} } }
+```
+
+Non-2xx responses raise Warb::RequestError (or subclasses), so you can rescue them in your app.

data/examples/webhook.rb

@@ -1,17 +1,49 @@
 # frozen_string_literal: true
 
+require_relative '../lib/warb'
 require 'sinatra/base'
 require 'faraday'
+require 'openssl'
 
 class Webhook < Sinatra::Base
+
+  Warb.setup do |config|
+    config.access_token = token
+    config.business_id = business
+    config.sender_id = sender
+  end
+
   configure do
     set :bind, '0.0.0.0'
     set :port, 3000
     set :host_authorization, { permitted_hosts: [] }
   end
 
+  helpers do
+    def verify_signature!(raw_body)
+      header = request.env['HTTP_X_HUB_SIGNATURE_256']
+
+      halt 400, 'Missing X-Hub-Signature-256' if APP_SECRET && (!header || header.empty?)
+
+      received = header.sub('sha256=', '')
+      expected = OpenSSL::HMAC.hexdigest('SHA256', APP_SECRET, raw_body)
+
+      unless Rack::Utils.secure_compare(received, expected)
+        puts "⚠️  Invalid webhook signature."
+        halt 403, 'Invalid signature'
+      end
+
+      true
+    end
+  end
+
   post '/webhook' do
-    request_body = JSON.parse(request.body.read)
+    request.body.rewind
+    raw_body = request.body.read
+
+    verify_signature!(raw_body)
+
+    request_body = JSON.parse(raw_body)
 
     puts "\n🪝 Incoming webhook message: #{request_body}"
 

data/lib/warb/category.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Warb
+  module Category
+    MARKETING = 'MARKETING'
+    UTILITY = 'UTILITY'
+  end
+end

data/lib/warb/components/flow_button.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Warb
+  module Components
+    class FlowButton < Button
+      BUTTON_TYPE = 'flow'
+
+      attr_accessor :flow_token, :flow_action_data
+
+      def to_h
+        button_payload = super
+
+        token = flow_token || @params[:flow_token]
+        data  = flow_action_data || @params[:flow_action_data]
+
+        action = {}
+        action[:flow_token] = token if token
+        action[:flow_action_data] = data if data
+
+        button_payload[:parameters] = [{ type: 'action', action: action }]
+
+        button_payload
+      end
+
+      private
+
+      def button_type
+        BUTTON_TYPE
+      end
+    end
+  end
+end

data/lib/warb/resources/flow.rb

@@ -3,34 +3,94 @@
 module Warb
   module Resources
     class Flow < Resource
-      attr_accessor :flow_id, :screen
+      include Helpers::Header
+
+      attr_accessor :flow_id, :screen, :flow_action, :mode,
+                    :flow_cta, :flow_token, :body, :header, :footer, :data,
+                    :draft, :data_exchange
 
-      # rubocop:disable Metrics/MethodLength
       def build_payload
+        validate!
+
         {
           type: 'interactive',
-          interactive: {
-            type: 'flow',
-            body: {
-              text: 'Not shown in draft mode'
-            },
-            action: {
-              name: 'flow',
-              parameters: {
-                flow_message_version: '3',
-                flow_action: 'navigate',
-                flow_id: flow_id || @params[:flow_id],
-                flow_cta: 'Not shown in draft mode',
-                mode: 'draft',
-                flow_action_payload: {
-                  screen: screen || @params[:screen]
-                }
-              }
-            }
+          interactive: build_interactive
+        }
+      end
+
+      private
+
+      def build_interactive
+        interactive = {
+          type: 'flow',
+          action: {
+            name: 'flow',
+            parameters: build_action_parameters
           }
         }
+
+        header = resolve(:header)
+        if header.is_a?(Hash)
+          interactive[:header] = header
+        elsif header.respond_to?(:build_header)
+          interactive[:header] = header.build_header
+        end
+
+        resolve(:body)
+          .then { |body| interactive[:body] = { text: body } }
+
+        resolve(:footer)
+          .then { |footer| interactive[:footer] = { text: footer } unless blank?(footer) }
+
+        interactive
+      end
+
+      def build_action_parameters
+        params = {
+          flow_message_version: '3',
+          flow_id: resolve(:flow_id),
+          flow_action: final_action,
+          mode: final_mode
+        }
+
+        resolve(:flow_cta)
+          .then { |label| params[:flow_cta] = label unless blank?(label) }
+
+        resolve(:flow_token)
+          .then { |token| params[:flow_token] = token unless blank?(token) }
+
+        if final_action == 'navigate'
+          payload = { screen: resolve(:screen) }
+          initial = resolve(:data)
+          payload[:data] = initial unless blank?(initial)
+          params[:flow_action_payload] = payload
+        end
+
+        params
+      end
+
+      def final_action
+        explicit = raw_value(:flow_action)
+        return explicit.to_s unless blank?(explicit)
+
+        resolve(:data_exchange) ? 'data_exchange' : 'navigate'
+      end
+
+      def final_mode
+        explicit = raw_value(:mode)
+        return explicit.to_s unless blank?(explicit)
+
+        resolve(:draft) ? 'draft' : 'published'
+      end
+
+      def validate!
+        validates :flow_id, required: true
+        validates :body,    required: true
+
+        validates :screen,
+                  required: -> { final_action == 'navigate' },
+                  message: 'screen is required for flow_action=navigate'
       end
-      # rubocop:enable Metrics/MethodLength
     end
   end
 end

data/lib/warb/resources/helpers/header.rb

@@ -0,0 +1,35 @@
+module Warb
+  module Resources
+    module Helpers
+      module Header
+        def add_text_header(content: nil, message: nil, text: nil, parameter_name: nil, &block)
+          add_header(Warb::Resources::Text.new(content:, message:, text:, parameter_name:), &block)
+        end
+
+        def add_image_header(media_id: nil, link: nil, &block)
+          add_header(Warb::Resources::Image.new(media_id:, link:), &block)
+        end
+
+        def add_document_header(media_id: nil, link: nil, filename: nil, &block)
+          add_header(Warb::Resources::Document.new(media_id:, link:, filename:), &block)
+        end
+
+        def add_video_header(media_id: nil, link: nil, &block)
+          add_header(Warb::Resources::Video.new(media_id:, link:), &block)
+        end
+
+        def add_location_header(latitude: nil, longitude: nil, address: nil, name: nil, &block)
+          add_header(Warb::Resources::Location.new(latitude:, longitude:, address:, name:), &block)
+        end
+
+        private
+
+        def add_header(instance, &)
+          @header = instance
+
+          block_given? ? @header.tap(&) : @header
+        end
+      end
+    end
+  end
+end

data/lib/warb/resources/resource.rb

@@ -3,6 +3,8 @@
 module Warb
   module Resources
     class Resource
+      include Validation
+
       def initialize(**params)
         @params = params
       end

data/lib/warb/resources/template.rb

@@ -3,7 +3,9 @@
 module Warb
   module Resources
     class Template < Resource
-      attr_accessor :name, :language, :resources, :header, :buttons
+      include Helpers::Header
+
+      attr_accessor :name, :language, :resources, :header, :category, :body, :buttons
 
       def initialize(**params)
         super
@@ -11,6 +13,8 @@ module Warb
         @name = params[:name]
         @language = params[:language]
         @resources = params[:resources]
+        @category = params[:category]
+        @body = params[:body]
         @buttons = []
       end
 
@@ -33,6 +37,17 @@ module Warb
       end
       # rubocop:enable Metrics/MethodLength
 
+      def creation_payload
+        {
+          name: name,
+          language: language,
+          category: category,
+          components: [
+            body&.build_template_example_parameter
+          ].compact
+        }
+      end
+
       def add_currency_parameter(parameter_name = nil, **params, &)
         add_parameter(parameter_name, Currency.new(**params), &)
       end
@@ -45,26 +60,6 @@ module Warb
         add_parameter(parameter_name, Text.new(**params), &)
       end
 
-      def add_text_header(content: nil, message: nil, text: nil, parameter_name: nil, &block)
-        add_header(Text.new(content:, message:, text:, parameter_name:), &block)
-      end
-
-      def add_image_header(media_id: nil, link: nil, &block)
-        add_header(Image.new(media_id:, link:), &block)
-      end
-
-      def add_document_header(media_id: nil, link: nil, filename: nil, &block)
-        add_header(Document.new(media_id:, link:, filename:), &block)
-      end
-
-      def add_video_header(media_id: nil, link: nil, &block)
-        add_header(Video.new(media_id:, link:), &block)
-      end
-
-      def add_location_header(latitude: nil, longitude: nil, address: nil, name: nil, &block)
-        add_header(Location.new(latitude:, longitude:, address:, name:), &block)
-      end
-
       def add_quick_reply_button(index: position, &block)
         add_button(Warb::Components::QuickReplyButton.new(index:), &block)
       end
@@ -83,6 +78,13 @@ module Warb
         add_button(Warb::Components::VoiceCallButton.new(index:), &block)
       end
 
+      def add_flow_button(index: position, flow_token: nil, flow_action_data: nil, &block)
+        add_button(
+          Warb::Components::FlowButton.new(index: index, flow_token: flow_token,
+                                           flow_action_data: flow_action_data), &block
+        )
+      end
+
       def add_button(instance, &)
         return @buttons << instance.to_h unless block_given?
 
@@ -91,12 +93,6 @@ module Warb
 
       private
 
-      def add_header(instance, &)
-        @header = instance
-
-        block_given? ? @header.tap(&) : @header
-      end
-
       def component_header
         return unless header.is_a? Resource
 

data/lib/warb/resources/text.rb

@@ -3,7 +3,7 @@
 module Warb
   module Resources
     class Text < Resource
-      attr_accessor :content, :text, :message, :preview_url, :parameter_name
+      attr_accessor :content, :text, :message, :preview_url, :parameter_name, :examples
 
       def build_header
         { type: 'text', text: message_per_priority }.tap do |header|
@@ -37,6 +37,16 @@ module Warb
         }
       end
 
+      def build_template_example_parameter
+        { type: 'body', text: message_per_priority }.tap do |param|
+          examples ||= @params[:examples]
+
+          next unless examples.is_a?(Array)
+
+          param[:example] = { body_text: [examples] }
+        end
+      end
+
       private
 
       def message_per_priority

data/lib/warb/resources/validation.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Warb
+  module Resources
+    module Validation
+      def blank?(val)
+        val.respond_to?(:empty?) ? val.empty? : !val
+      end
+
+      def raw_value(field)
+        respond_to?(field) ? public_send(field) : nil
+      end
+
+      def resolve(field, default = nil)
+        val = raw_value(field)
+        val = @params[field] if blank?(val) && defined?(@params) && @params&.key?(field)
+        val = default if blank?(val) && !default.nil?
+        val
+      end
+
+      def validates(field, required: false, message: nil)
+        needed = required.respond_to?(:call) ? required.call : required
+        return unless needed
+        return unless blank?(resolve(field))
+
+        raise ArgumentError, (message || "#{field} is required")
+      end
+    end
+  end
+end

data/lib/warb/template_dispatcher.rb

@@ -2,6 +2,15 @@
 
 module Warb
   class TemplateDispatcher < Dispatcher
+    def create(**args)
+      template = Resources::Template.new(**args)
+      @client.post('message_templates', template.creation_payload, endpoint_prefix: :business_id)
+    end
+
+    def delete(template_name)
+      @client.delete('message_templates', { name: template_name }, endpoint_prefix: :business_id).body
+    end
+
     def list(**args)
       filter = args.slice(:limit, :fields, :after, :before)
       filter[:fields] = filter[:fields].join(',') if filter[:fields].is_a?(Array)

data/lib/warb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Warb
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end

data/lib/warb.rb

@@ -2,14 +2,22 @@
 
 require 'faraday'
 require 'faraday/multipart'
+
 require_relative 'warb/version'
 require_relative 'warb/language'
+require_relative 'warb/category'
 require_relative 'warb/configuration'
 require_relative 'warb/dispatcher_concern'
 require_relative 'warb/client'
+
+# Error/response stack
 require_relative 'warb/errors'
 require_relative 'warb/response_error_handler'
 require_relative 'warb/response'
+
+# Resources
+require_relative 'warb/resources/validation'
+require_relative 'warb/resources/helpers/header'
 require_relative 'warb/resources/resource'
 require_relative 'warb/resources/text'
 require_relative 'warb/resources/image'
@@ -28,13 +36,18 @@ require_relative 'warb/resources/template'
 require_relative 'warb/resources/currency'
 require_relative 'warb/resources/date_time'
 require_relative 'warb/resources/flow'
+
+# Dispatchers
 require_relative 'warb/dispatcher'
 require_relative 'warb/media_dispatcher'
 require_relative 'warb/template_dispatcher'
 require_relative 'warb/indicator_dispatcher'
+
+# Utils and components
 require_relative 'warb/utils'
 require_relative 'warb/components/component'
 require_relative 'warb/components/button'
+require_relative 'warb/components/flow_button'
 require_relative 'warb/components/quick_reply_button'
 require_relative 'warb/components/url_button'
 require_relative 'warb/components/copy_code_button'
@@ -73,5 +86,9 @@ module Warb
 
       client
     end
+
+    def list_phone_numbers
+      client.get('phone_numbers', endpoint_prefix: :business_id).body['data']
+    end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: warb
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Rebase
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-08-22 00:00:00.000000000 Z
+date: 2025-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -57,6 +57,7 @@ files:
 - docs/components/copy_code_button.md
 - docs/components/cta_action.md
 - docs/components/email.md
+- docs/components/flow_button.md
 - docs/components/list_action.md
 - docs/components/name.md
 - docs/components/org.md
@@ -85,9 +86,9 @@ files:
 - docs/messages/template.md
 - docs/messages/text.md
 - docs/messages/video.md
+- docs/resources/README.md
 - docs/resources/currency.md
 - docs/resources/date_time.md
-- docs/resources/index.md
 - docs/resources/text.md
 - docs/setup.md
 - docs/webhook.md
@@ -104,6 +105,7 @@ files:
 - examples/video.rb
 - examples/webhook.rb
 - lib/warb.rb
+- lib/warb/category.rb
 - lib/warb/client.rb
 - lib/warb/components/action.rb
 - lib/warb/components/address.rb
@@ -111,6 +113,7 @@ files:
 - lib/warb/components/component.rb
 - lib/warb/components/copy_code_button.rb
 - lib/warb/components/email.rb
+- lib/warb/components/flow_button.rb
 - lib/warb/components/name.rb
 - lib/warb/components/org.rb
 - lib/warb/components/phone.rb
@@ -132,6 +135,7 @@ files:
 - lib/warb/resources/date_time.rb
 - lib/warb/resources/document.rb
 - lib/warb/resources/flow.rb
+- lib/warb/resources/helpers/header.rb
 - lib/warb/resources/image.rb
 - lib/warb/resources/interactive_call_to_action_url.rb
 - lib/warb/resources/interactive_list.rb
@@ -143,6 +147,7 @@ files:
 - lib/warb/resources/sticker.rb
 - lib/warb/resources/template.rb
 - lib/warb/resources/text.rb
+- lib/warb/resources/validation.rb
 - lib/warb/resources/video.rb
 - lib/warb/response.rb
 - lib/warb/response_error_handler.rb